Udostępnienie mechanizmu do pobierania listy pracowników, działów i struktury organizacyjnej dla spółek połączonych z bazami Comarch ERP Optima

W wersji 2025.2.0 umożliwiono pobieranie listy pracowników, działów i struktury organizacyjnej dla spółek połączonych z bazami Comarch ERP Optima oraz Comarch BPM Standalone. W tym celu na zakładce [Struktura organizacyjna] w górnej części okna została dodana ikona [Importuj], analogiczna do ikony dotychczas dostępnej tylko dla współpracy z Comarch ERP XL.

 

Widok zakładki „Struktura organizacyjna” dla spółki współpracującej z Comarch ERP Optima przed importem danych – widoczny jest przycisk „Importuj”

 

Po kliknięciu w przycisk [Importuj] zostaje otwarte okno importu danych.

W ramach okna importu danych w zakładkach: „Pracownicy”, „Działy” i „Struktura organizacyjna” można za pomocą zapytania SQL pobrać odpowiednio: listę pracowników, listę działów oraz strukturę organizacyjną. Zapytanie SQL należy wprowadzić w oknie „Procedura SQL”, otwartym po kliknięciu w przycisk [SQL] w ramach danej zakładki.

Dla Comarch BPM Standalone okno „Procedura SQL” jest puste – operator może w nim wprowadzić ręcznie zapytanie SQL potrzebne do pobrania z bazy danych pracowników, działów lub struktury organizacyjnej, w zależności od wybranej zakładki.

Dla spółek współpracujących z Comarch ERP Optima w ramach okna „Procedura SQL” znajdują się następujące predefiniowane zapytania:

 

  • Dla zakładki „Pracownicy” (zgodnie z najnowszym zapisem)

 

SELECT

p.PRE_PREID as NatSystemId,

p.PRE_Imie1 + ' ' + p.PRE_Nazwisko as Name1,

'' as Name2,

'' as Name2,

0 as Archival,

p.PRE_Kod as Login,

'' as Mail,

'' as Login2,

0 as LoginMethod

FROM CDN.PracEtaty p

WHERE p.PRE_DataDo >= CAST(GETDATE() AS DATE) AND p.PRE_Filtr = 0 AND p.PRE_TypPracownika = 0

 

  • Dla zakładki „Działy”
SELECT

c.CNT_CntID as NatSystemId,

c.CNT_Nazwa as Name1,

0 as Archival

FROM CDN.Centra c

WHERE c.CNT_CntId <> 1

 

  • Dla zakładki „Struktura organizacyjna”
SELECT

c.CNT_CntID as NatSystemId,

CASE

WHEN C.CNT_ParentId IS NULL

THEN 0

ELSE

C.CNT_ParentId

END as NatSystemParentId,

1 as Type,

0 as Archival,

c.CNT_Nazwa as Name,

d.CNT_Nazwa as ParentName

FROM CDN.Centra c

LEFT JOIN CDN.Centra d ON d.CNT_CntId = c.CNT_ParentId

WHERE c.CNT_CntId <> 1




UNION




SELECT

p.PRE_PREID as NatSystemId,

p.PRE_CntId,

2 as Type,

0 as Archival,

p.PRE_Imie1 + ' ' + p.PRE_Nazwisko as Name,

r.CNT_Nazwa as ParentName

FROM CDN.PracEtaty p

LEFT JOIN CDN.Centra r ON r.CNT_CntId = p.PRE_CntId

WHERE p.PRE_DataDo >= CAST(GETDATE() AS DATE) AND p.PRE_Filtr = 0 AND p.PRE_TypPracownika = 0

 

W przypadku każdego z powyższych zapytań operator może dokonywać edycji.

 

Okno importu danych z bazy Comarch ERP Optima, zakładka „Pracownicy” – widok po kliknięciu w przycisk „Importuj”

 

Okno importu danych z bazy Comarch ERP Optima na zakładce „Pracownicy”– okno „Procedura SQL” z predefiniowanym zapytaniem SQL

 

Po ewentualnym zapisaniu zmian w oknie „Procedura SQL” na zakładce „Pracownicy” należy zaznaczyć checkboxy obok tych pracowników, którzy mają zostać zaimportowani do Comarch BPM, a następnie nacisnąć przycisk [Zapisz]. Wówczas wybrani pracownicy pojawią się w sekcji „Stan Aktualny” w oknie importu danych, a po zamknięciu okna widoczni będą na zakładce „Pracownicy” w ramach zakładki [Struktura organizacyjna].

Analogicznie należy postępować na zakładkach „Działy” i „Struktura organizacyjna” w ramach okna importu danych.

 

Okno importu danych z bazy Comarch ERP Optima na zakładce „Pracownicy”– zaznaczanie pracowników ze spółki Comarch ERP Optima do zaimportowania

 

Okno importu danych z bazy Comarch ERP Optima na zakładce „Pracownicy”– Widok listy pracowników zaimportowanych ze spółki Comarch ERP Optima na liście w sekcji „Stan Aktualny”

 

Widok zakładki „Pracownicy” na zakładce „Struktura organizacyjna” po zaimportowaniu pracowników

 

Okno importu danych z bazy Comarch ERP Optima na zakładce „Działy”– zaznaczanie działów ze spółki Comarch ERP Optima do zaimportowania

 

Okno importu danych z bazy Comarch ERP Optima na zakładce „Działy”– Widok listy działów zaimportowanych ze spółki Comarch ERP Optima na liście w sekcji „Stan Aktualny”

 

Widok zakładki „Działy” na zakładce „Struktura organizacyjna” po zaimportowaniu działów

 

Okno importu danych z bazy Comarch ERP Optima na zakładce „Struktura organizacyjnay”– zaznaczanie elementów struktury organizacyjnej ze spółki Comarch ERP Optima do zaimportowania

 

Okno importu danych z bazy Comarch ERP Optima na zakładce „Struktura organizacyjna”–widok struktury organizacyjnej zaimportowanej ze spółki Comarch ERP Optima na liście w sekcji „Stan Aktualny”

 

Widok drzewa struktury organizacyjnej na zakładce „Struktura organizacyjna” po zaimportowaniu struktury organizacyjnej




Udostępnienie mechanizmu do pobierania listy pracowników, działów i struktury organizacyjnej dla spółek połączonych z bazami Comarch BPM Standalone

W wersji 2025.2.0 umożliwiono pobieranie listy pracowników, działów i struktury organizacyjnej dla spółek połączonych z bazami Comarch ERP Optima oraz Comarch BPM Standalone. W tym celu na zakładce [Struktura organizacyjna] w górnej części okna została dodana ikona [Importuj], analogiczna do ikony dotychczas dostępnej tylko dla współpracy z Comarch ERP XL.

 

Widok zakładki „Struktura organizacyjna” dla spółki Comarch BPM Standalone przed importem danych – widoczny jest przycisk „Importuj”

Po kliknięciu w przycisk [Importuj] zostaje otwarte okno importu danych.

W ramach okna importu danych w zakładkach: „Pracownicy”, „Działy” i „Struktura organizacyjna” można za pomocą zapytania SQL pobrać odpowiednio: listę pracowników, listę działów oraz strukturę organizacyjną. Zapytanie SQL należy wprowadzić w oknie „Procedura SQL”, otwartym po kliknięciu w przycisk [SQL] w ramach danej zakładki.

Dla Comarch BPM Standalone okno „Procedura SQL” jest puste – operator może w nim wprowadzić ręcznie zapytanie SQL potrzebne do pobrania z bazy danych pracowników, działów lub struktury organizacyjnej, w zależności od wybranej zakładki.

 

Dla spółek Comarch BPM Standalone w ramach okna „Procedura SQL” można wprowadzić następujące przykładowe zapytania:

  • Dla zakładki „Pracownicy” (zgodnie z najnowszym zapisem)

 

select DCD_ID as NatSystemId,

DCD_Name1 as Name1,

'' as Name2,

'' as Name3,

0 as Archival,

DCD_Login as Login,

'' as Mail,

'' as Login2,

0 as LoginMethod

from Nazwa_bazy_BPM.do.DF_ConfOSDictionary

where dcd_type=2

Dla zakładki „Działy”

select DCD_ID as NatSystemId,

DCD_Name1 as Name1,

0 as Archival

from Nazwa_bazy_BPM.do.DF_ConfOSDictionary

where dcd_type = 1

 

  • Dla zakładki „Struktura organizacyjna”

 

SELECT  
    b.DCD_ID as NatSystemId, 
    d.DCD_ID as NatSystemParentId, 
    b.DCD_Type as Type, 
    0 as Archival, 
    b.DCD_Name1 as Name, 
    d.DCD_Name1 as ParentName 
FROM Nazwa_bazy_BPM.do.DF_ConfOSTree a 
JOIN Nazwa_bazy_BPM.do.DF_ConfOSDictionary b 
    ON a.DCO_DCDId = b.DCD_ID 
LEFT JOIN Nazwa_bazy_BPM.do.DF_ConfOSTree c 
    ON a.DCO_DCOId = c.DCO_ID 
LEFT JOIN Nazwa_bazy_BPM.do.DF_ConfOSDictionary d 
    ON c.DCO_DCDId = d.DCD_ID

 

W przypadku każdego z powyższych zapytań operator może dokonywać edycji.

Okno importu danych z bazy Comarch BPM Standalone, zakładka „Pracownicy” – widok po kliknięciu w przycisk „Importuj”

 

Okno importu danych z bazy Comarch BPM Standalone na zakładce „Pracownicy”– okno „Procedura SQL” z przykładowym zapytaniem SQL

 

Po ewentualnym zapisaniu zmian w oknie „Procedura SQL” na zakładce „Pracownicy” należy zaznaczyć checkboxy obok tych pracowników, którzy mają zostać zaimportowani do Comarch BPM, a następnie nacisnąć przycisk [Zapisz]. Wówczas wybrani pracownicy pojawią się w sekcji „Stan Aktualny” w oknie importu danych, a po zamknięciu okna widoczni będą na zakładce „Pracownicy” w ramach zakładki [Struktura organizacyjna].

Analogicznie należy postępować na zakładkach „Działy” i „Struktura organizacyjna” w ramach okna importu danych.

 

Okno importu danych z bazy Comarch BPM Standalone na zakładce „Pracownicy”– zaznaczanie pracowników ze spółki Comarch BPM Standalone do zaimportowania

 

Okno importu danych z bazy Comarch BPM Standalone na zakładce „Pracownicy”– Widok listy pracowników zaimportowanych ze spółki Comarch BPM Standalone na liście w sekcji „Stan Aktualny”

 

Widok zakładki „Pracownicy” na zakładce „Struktura organizacyjna” po zaimportowaniu pracowników

 

Okno importu danych z bazy Comarch BPM Standalone na zakładce „Działy”– zaznaczanie działów ze spółki Comarch BPM Standalone do zaimportowania

 

Okno importu danych z bazy Comarch BPM Standalone na zakładce „Działy”– Widok listy działów zaimportowanych ze spółki Comarch BPM Standalone na liście w sekcji „Stan Aktualny”

 

Widok zakładki „Działy” na zakładce „Struktura organizacyjna” po zaimportowaniu działów

 

Okno importu danych z bazy Comarch BPM Standalone na zakładce „Struktura organizacyjnay”– zaznaczanie elementów struktury organizacyjnej ze spółki Comarch BPM Standalone do zaimportowania

 

Okno importu danych z bazy Comarch BPM Standalone na zakładce „Struktura organizacyjna”–widok struktury organizacyjnej zaimportowanej ze spółki Comarch BPM Standalone na liście w sekcji „Stan Aktualny”

 

Widok drzewa struktury organizacyjnej na zakładce „Struktura organizacyjna” po zaimportowaniu struktury organizacyjnej




Udostępnienie funkcji RPA (automatycznego trybu pracy) na punktach ACD typu „Import dokumentów ze skrzynki e-Doręczenia” oraz „Import dokumentów zakupu z KSeF”

W wersji 2025.2.0 umożliwiono pełną automatyzację importowania oraz generowania dokumentów przez punkty ACD typu „Import dokumentów ze skrzynki e-Doręczenia” i „Import dokumentów zakupu z KSeF”.

Wprowadzono również możliwość ustawiania filtrów dla punktów ACD typu „Import dokumentów zakupu z KSeF” w konfiguracji automatycznego trybu pracy.

Aby umożliwić wykonywanie działań na wskazanych punktach ACd, wprowadzono nowe metody w obiekcie Globals w klasie ACD, która określa metody wykonywane jedynie w kontekście okna ACD – są to następujące metody:

  • ImportEDorMessages() – metoda do automatycznej obsługi pobierania nowych wiadomości z usługi e-Doręczenia – ta metoda:
    • Nie posiada parametrów wejściowych
    • Zwraca wyniki:
      • 0 – jeśli operacja wykonała się poprawnie
      • -1- jeśli wystąpił błąd
    • int ImportMessages()

return: 0 – ok, -1 – error

 

Widok okna „Konfiguracji automatycznego trybu” z przykładowym skryptem do automatycznego pobierania wiadomości z usługi E-Doręczenia i generowania dokumentów BPM (gdy punkt ACD współpracujący z usługą E-Doręczenia nosi nazwę „E-Doręczenia”) – przykład

 

  • ImportKSeFDocuments() – metoda do automatycznej obsługi pobierania nowych dokumentów z usługi KSeF – ta metoda:
    • Nie posiada parametrów wejściowych
    • Zwraca wyniki:
      • 0 – jeśli operacja wykonała się poprawnie
      • -1- jeśli wystąpił błąd
    • int ImportKSeFDocuments()

return: 0 – ok, -1 – error

 

Widok okna „Konfiguracji automatycznego trybu” z przykładowym skryptem do automatycznego pobierania dokumentów z KSeF i generowania dokumentów BPM (gdy punkt ACD współpracujący z KSeF nosi nazwę „Faktury KSeF”) – przykład

  • SetKSeFFilters(string, DateTime?,DateTime?, decimal?, decimal?, byte?, byte) – metoda służąca do ustawiania filtrów dla punktów ACD typu „Import dokumentów zakupu z KSeF” według określonych kryteriów. Uruchomienie metody powoduje przeładowanie listy dokumentów przy uwzględnieniu nowych wartości filtrów. Ta metoda:
    • Posiada parametry wejściowe – podanie wszystkich parametrów nie jest wymagane:
      • string – NIP firmy
      • DateTime? – Data przyjęcia dw KSeF- od
      • DateTime? – Data przyjęcia dw KSeF- do
      • decimal? – Wartość brutto – od
      • decimal? – Wartość brutto – do
      • byte? – Typ dokumentu
      • byte – Stan faktury
    • Zwraca wyniki:
      • 0 – jeśli operacja wykonała się poprawnie
      • -1- jeśli wystąpił błąd
    • int SetKSeFFilters(string, string?, string?, decimal?,decimal?, byte?, byte)

string: KSeF NIP

DateTime?: KSeF date from

DateTime?: KSeF date to

decimal?: KSeF gross amount from

decimal?: KSeF gross amount value to

byte?: 0 – VAT invoice, 1 – corrective invoice, 2 – advance invoice, 3 – settlement invoice, 4 – simplified                               invoice,  5 – correction of advance invoice, 6 – corrective settlement invoice

byte: 0 – unregistered, 1 – rejected, 2 – registered, 3 – all

return: 0 – ok, -1 – error

 

Widok okna „Konfiguracji automatycznego trybu” z przykładowym skryptem do automatycznego pobierania dokumentów z KSeF, filtrowania ich i generowania dokumentów BPM (gdy punkt ACD współpracujący z KSeF nosi nazwę „Faktury KSeF”) – przykład

 

  • ResetKSeFFilters() – metoda służąca do resetowania filtrów dla punktów ACD typu „Import dokumentów zakupu z KSeF”. Domyślne ustawienia to brak filtrów: NIP firmy, Data przyjęcia w KSeF – od, Data przyjęcia w KSeF – do, Wartość brutto – od, Wartość brutto – do Typ dokumentu. Filtr Stan faktury jest ustawiony na faktury niezarejestrowane w Comarch BPM. Ta metoda:
    • Nie posiada parametrów wejściowych
    • Zwraca wyniki:
      • 0 – jeśli operacja wykonała się poprawnie
      • -1- jeśli wystąpił błąd
    • int ResetKSeFFilters()

return: 0 – ok, -1 – error

 

Widok okna „Konfiguracji automatycznego trybu” z przykładowym skryptem do automatycznego pobierania dokumentów z KSeF, resetu filtrów i generowania dokumentów BPM (gdy punkt ACD współpracujący z KSeF nosi nazwę „Faktury KSeF”) – przykład

 

Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch BPM!

 




Praca z punktem ACD typu Import dokumentów ze skrzynki e-Doręczenia

Uwaga

W przypadku korzystania ze środowiska testowego dla usługi e-Doręczenia w pliku web.config w folderze z aplikacją serwerową należy zmodyfikować wartości kluczy, które dotyczą e-Doręczeń, jak na poniższej ilustracji:

 

Uwaga
W wersji 2025.2.0 umożliwiono pełną automatyzację importowania oraz generowania dokumentów przez punkty ACD typu „Import dokumentów ze skrzynki e-Doręczenia” i „Import dokumentów zakupu z KSeF” – zob. Udostępnienie funkcji RPA (automatycznego trybu pracy) na punktach ACD typu „Import dokumentów ze skrzynki e-Doręczenia” oraz „Import dokumentów zakupu z KSeF”

 

 

Aby rozpocząć pracę z punktem ACD typu „Import dokumentów ze skrzynki e-Doręczenia”, należy kliknąć w ikonę [Pobierz wiadomości]. Zostanie wówczas otwarte okno „Import wiadomości z usługi e-Doręczenia”, w którym należy nacisnąć przycisk [Importuj].

 

Okno „Import wiadomości z usługi e-Doręczenia” przed kliknięciem „Importuj”

 

Okno „Import wiadomości z usługi e-Doręczenia” po kliknięciu „Importuj”

 

Na liście wiadomości w ramach okna Import wiadomości z usługi e-Doręczenia dostępne są następujące kolumny:

  • Nadawca – w tej kolumnie wyświetlany jest nadawca wiadomości;
  • Temat – w ramach tej kolumny widoczny jest temat wiadomości;
  • Data doręczenia – w tej kolumnie wyświetlany jest dzień, w którym wiadomość została dostarczona.

 

W górnej części okna znajduje się parametr [Pokaż wiadomości zapisane w DMS] – jeśli ten parametr jest zaznaczony, wówczas wyświetlane są również wiadomości, które zostały już zarejestrowane w Comarch BPM (dawniej DMS) – takie dokumenty są wyszarzone na liście wiadomości widocznej w oknie.

Po załadowaniu się listy wiadomości należy zaznaczyć wybrane pozycje i kliknąć przycisk [Zapisz], aby okno Import wiadomości z usługi e-Doręczenia zostało zamknięte, a lista wiadomości została wyświetlona w Comarch BPM (dawniej DMS).

 

Okno „Import wiadomości z usługi e-Doręczenia” po zaznaczeniu dokumentu do zarejestrowania w Comarch BPM (dawniej DMS)

 

Jeżeli użytkownik wybierze przycisk [Anuluj], wówczas okno Import wiadomości z usługi e-Doręczenia zostanie zamknięte, a wiadomości nie zostaną zarejestrowane w Comarch BPM (dawniej DMS).

Uwaga
Jeśli użytkownik kliknie w przycisk [Importuj] i pobierze dokumenty z usługi e-Doręczenia do okna „Import wiadomości z usługi e-Doręczenia”, a następnie naciśnie przycisk [Anuluj], wówczas dokumenty nie zostaną wyświetlone w pracującym punkcie ACD, jednak usługa e-Doręczenia wygeneruje potwierdzenia doręczenia wiadomości do adresata.

 

Po kliknięciu w przycisk [Zapisz] w prawej części okna punktu ACD zostaje wyświetlona lista wiadomości, które zostały pobrane ze skrzynki e-Doręczenia. Lista składa się z trzech kolumn:

  • Nadawca
  • Temat
  • Data doręczenia

Obok wiadomości z załącznikami widoczna jest ikona .

Po kliknięciu prawym przyciskiem myszki na daną wiadomość zostaje wyświetlone menu kontekstowe z następującymi opcjami:

  • Usuń z listy – po wyborze tej opcji wiadomość zostaje usunięta z listy wiadomości

Uwaga
Jeśli użytkownik usunie wiadomość z listy za pomocą opcji „Usuń z listy”, wówczas dokument nie będzie już wyświetlany w pracującym punkcie ACD, jednak wiadomość zostaje oznaczona jako zapisana w BPM (dawniej DMS) i nie można jej pobrać ponownie.

  • Pobierz dowody techniczne – jeśli operator wybierze tę opcję, wówczas zostanie otwarte okno systemowe, w ramach którego należy wybrać lokalizację, w której zostaną zapisane dowody techniczne w formacie pliku zip. Dowód techniczny w  punkcie ACD Comarch BPM jest wystawiany dla otrzymania danej wiadomości z usługi e-Doręczenia .

 

Menu kontekstowe wiadomości zapisanej w ramach punktu ACD we współpracy z usługą e-Doręczenia

 

Wybór lokalizacji, w której zostaną zapisane dowody techniczne

 

Widok pliku z dowodami technicznymi po rozpakowaniu

 

  • Zapisz załączniki jako – jeśli operator wybierze tę opcję, wówczas zostanie otwarte okno systemowe, w ramach którego należy wybrać lokalizację, w której zostaną zapisane załączniki dołączone do danej wiadomości

 

Wybór lokalizacji, w której zostaną zapisane załączniki dołączone do wiadomości

 

Wiadomości, które zostały pobrane w punkcie ACD, są oznaczone identyfikatorem punktu ACD i identyfikatorem użytkownika. Domyślnie wyświetlana lista wiadomości w ramach punktu to wszystkie wiadomości, które zostały pobrane z e-doręczeń przez zalogowanego użytkownika i z których nie wygenerował dokumentów do obiegu Comarch BPM (dawniej DMS).

Nad listą wiadomości znajduje się informacja „Liczba wiadomości”, obok której widoczna jest liczba wiadomości wyświetlanych na liście dla danego operatora.

Poniżej dostępny jest filtr [Pokaż wiadomości doręczone w ostatnich X dniach] – w ramach tego filtra można zawęzić listę wiadomości do takich wiadomości, których data doręczenia jest w wybranym zakresie dat.

Pod filtrem [Pokaż wiadomości doręczone w ostatnich X dniach] znajduje się parametr [Pokaż wszystkie wiadomości pobrane w punkcie], którego zaznaczenie umożliwia wyświetlenie wszystkich wiadomości, które pobrali w danym punkcie ACD wszyscy uprawnieni użytkownicy. Domyślnie parametr jest odznaczony – w takim przypadku dla zalogowanego operatora na liście wyświetlane są jedynie takie wiadomości, które ten operator pobrał z usługi e-doręczeń.

Poniżej dostępny jest filtr [Zaznacz wszystko] – jeżeli operator zaznaczy ten parametr, wówczas wszystkie wiadomości na liście zostaną zaznaczone.

Po zaznaczeniu wiadomości z listy w lewej części punktu ACD wyświetlane są dane dotyczące tej wiadomości. W górnej części okna widoczny jest podgląd załącznika graficznego – pierwszego z listy załączników, która jest wyświetlana obok podglądu.

W dolnej części okna znajdują się kontrolki, które wybrano w ramach zakładki „Kontrolki” podczas konfiguracji punktu ACD wraz z wartościami, które zostały określone za pomocą zapytań SQL.

 

Widok okna pracującego punktu ACD typu „Pobieranie wiadomości z systemu e-Doręczenia”

 

Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch BPM!

 




Praca z punktem ACD (pobieranie dokumentów zakupu z KSeF)

Uwaga
W wersji 2025.2.0 umożliwiono pełną automatyzację importowania oraz generowania dokumentów przez punkty ACD typu „Import dokumentów ze skrzynki e-Doręczenia” i „Import dokumentów zakupu z KSeF” – zob. Udostępnienie funkcji RPA (automatycznego trybu pracy) na punktach ACD typu „Import dokumentów ze skrzynki e-Doręczenia” oraz „Import dokumentów zakupu z KSeF”

 

W prawym panelu punktu ACD typu „Import dokumentów zakupu z KSeF” znajduje się przycisk [Import faktur z KSeF], który odpowiada za włączenie importu dokumentów z KSeF.

 

Uwaga
W systemie Comarch BPM (dawniej DMS) integracja z KSeF obejmuje wyłącznie import dokumentów.

 

Widok punktu ACD typu „Import dokumentów zakupu z KSeF”

 

W wersji 2024.3.0 wprowadzono zmiany dotyczące okna „Import faktur z KSeF”, które jest wyświetlane po kliknięciu w przycisk [Import faktur z KSeF]. W ramach okna „Import faktur z KSeF” dostępne są trzy opcje:

  • Nowe – opcja zaznaczona domyślnie; operator powinien zaznaczyć tę opcję, jeśli chce, aby zostały pobrane dane wszystkich faktur zarejestrowanych od czasu ostatniego importu faktur (przyjęte w KSeF w dniu, gdy ostatnio dokonywano importu lub później);

Uwaga
Jeżeli nie pobierano do tej pory żadnych faktur, wówczas po zaznaczeniu tej opcji i kliknięciu w przycisk „Importuj” importowane są dane faktur z bieżącego oraz poprzedniego miesiąca. W ramach tej opcji nie następuje weryfikacja, czy w historii importowania faktur są luki.

  • Za okres Od [dzień.miesiąc.data] Do [dzień.miesiąc.data] – operator powinien zaznaczyć tę opcję, a następnie wybrać daty w polach „Od” i „Do”, jeśli chce, aby zostały pobrane dane faktur przyjętych w KSeF w wybranym okresie; domyślnie w polach wybrana jest aktualna data;

Uwaga
W ramach opcji Za okres Od [dzień.miesiąc.data] Do [dzień.miesiąc.data] konieczny jest wybór wartości zarówno w polu „Od”, jak i „Do”. System sprawdza według numeru KSeF dokumentu, czy pobierane faktury zostały już zaimportowane do bazy Comarch BPM (dawniej DMS).

  • Numer KSeF – operator powinien zaznaczyć tę opcję, jeżeli chce pobrać dane konkretnej faktury przjętej w KSeF. Po zaznaczeniu opcji należy wprowadzić w wyznaczonym polu numer KSeF wybranej faktury;

Uwaga
System sprawdza według numeru KSeF dokumentu, czy dana faktura została już zaimportowana do bazy Comarch BPM (dawniej DMS)

Po wyborze opcji w oknie „Import faktur z KSeF” i ewentualnym wypełnieniu wymaganych pól należy kliknąć w przycisk [Importuj], aby pobrać dane faktur z bazy KSeF do bazy Comarch BPM (dawniej DMS), zgodnie z wybranymi kryteriami.

 

Uwaga
Jeśli autoryzacja przez token zakończy się niepowodzeniem, wówczas podczas próby importu dokumentów z KSeF zostanie wyświetlone okno z certyfikatami, w ramach którego należy wskazać właściwy certyfikat.

 

Jeżeli natomiast operator kliknie w przycisk [Anuluj] w ramach okna „Import faktur z KSeF”, wówczas okno zostanie zamknięte, a dane faktur z KSeF nie zostaną pobrane do Comarch BPM (dawniej DMS).

 

Okno „Import faktur z KSeF”

Kiedy użytkownik kliknie w przycisk [Importuj], wówczas:

  • jeśli przedtem na zakładce „KSeF” (tryb jednofirmowy) lub „Połączenia z ERP” (tryb wielofirmowy) uzupełniono tylko pole „NIP firmy”, a nie uzupełniono pola „Token KSeF” – zostanie otwarte okno „Importowanie dokumentów” oraz okno „Wybierz certyfikat”, w którym należy wybrać certyfikat uwierzytelniający do KSeF. Jeżeli użytkownik nie uzupełni pola „Token KSeF”, wówczas za każdym razem po naciśnięciu przycisku [Importuj] konieczny będzie wybór certyfikatu.

 

Uwaga
Zalecane jest uwierzytelnianie za pomocą tokena.

 

Wybór certyfikatu w oknie „Wybierz certyfikat”

 

  • jeśli przedtem na zakładce „KSeF” (tryb jednofirmowy) lub „Połączenia z ERP” (tryb wielofirmowy) uzupełniono zarówno pole „NIP firmy”, jak również pole „Token KSeF” – zostanie otwarte okno „Importowanie dokumentów”, bez konieczności wyboru certyfikatu

 

Uwaga
Jeśli token, który wprowadzono w polu „Token KSeF” został unieważniony w systemie KSeF, wówczas po kliknięciu przycisku [Importuj] również konieczny jest wybór certyfikatu.

 

W przypadku wyboru niewłaściwego certyfikatu lub wystąpienia innego błędu (zob. rozdział Przykładowe błędy poniżej) pobieranie faktur z KSeF nie będzie możliwe – zostaje wówczas wyświetlony następujący komunikat:

 

Komunikat wyświetlany, jeśli próbowano pobrać faktury z KSeF po wyborze niewłaściwego certyfikatu

 

Dokumenty, które zostały zarejestrowane w Comarch BPM (dawniej DMS), a nie zostały jeszcze wygenerowane do dokumentu Comarch BPM (dawniej DMS), są widoczne na liście dokumentów w prawym panelu.

Nazwy dokumentów KSeF, które nie zostały jeszcze otwarte w danym punkcie ACD, są zaznaczone pogrubioną czcionką na liście dokumentów.

 

Widok punktu ACD typu „Import dokumentów zakupu z KSeF” z nieprzeczytanym dokumentem (FS-30/24)

 

W wersji 2024.3.0 zmieniono dotychczasową nazwę kolumny z listą dokumentów „Numer dokumentu” na „Dokument” i dodano nowe ikony nad listą dokumentów:

[Filtry] – po kliknięciu w tę ikonę wyświetlane jest okno, które pozwala na zdefiniowanie warunków do wyszukiwania dokumentów na liście. W ramach okna dostępne są następujące pola:

    • NIP firmy – w ramach pola można zawęzić pobieranie danych według wprowadzonej wartości NIP; wprowadzoną wartość można wyczyścić, klikając w znak x po prawej stronie pola;
    • Data przyjęcia w KSeF – od – w ramach pola można wybrać datę, zgodnie z którą będzie filtrowana lista dokumentów w punkcie ACD – widoczne będą tylko faktury przyjęte w KSeF od wybranej daty; wprowadzoną wartość można wyczyścić, klikając w znak x po prawej stronie pola;
    • Data przyjęcia w KSeF – do – w ramach pola można wybrać datę, zgodnie z którą będzie filtrowana lista dokumentów w punkcie ACD – widoczne będą tylko faktury przyjęte w KSeF do wybranej daty; wprowadzoną wartość można wyczyścić, klikając w znak x po prawej stronie pola;
    • Wartość brutto [wartość od] [wartość do] – w ramach filtra można wprowadzić zakres wartości brutto faktury, zgodnie z którym nastąpi zawężenie pobieranych danych; dostępne są dwa pola: pierwsze pole od lewej strony, to pole „wartość od”, drugie pole od lewej strony to „wartość do”; operator może wybrać wartość w jednym z pól lub w obu
    • Typ dokumentu – w ramach filtra można wybrać jeden typ dokumentu według którego ma zostać zawężone pobranie danych dokumentów. Dostępne opcje to:
      • faktura VAT
      • faktura uproszczona
      • faktura rozliczeniowa
      • faktura zaliczkowa
      • faktura korygująca
      • faktura korygująca fakturę rozliczeniową
      • korekta faktury zaliczkowej

 

Wprowadzoną wartość można wyczyścić, klikając w znak x po prawej stronie pola.

 

Lista opcji dostępnych w polu „Typ dokumentu”

    • Stan faktury – w ramach filtra można wybrać jeden stan dokumentu, według którego ma zostać zawężone pobranie danych dokumentów. Dostępne opcje to:
    • zarejestrowane w BPM (dawniej DMS) – tzn. wygenerowano wcześniej w Comarch BPM (dawniej DMS) dokumenty o takich samych numerach KSeF i nie zostały one odrzucone w punkcie ACD;
    • niezarejestrowane w BPM (dawniej DMS) – opcja domyślnie zaznaczona; nie wygenerowano wcześniej w Comarch BPM (dawniej DMS) dokumentów o takich samych numerach KSeF i nie zostały one odrzucone w punkcie ACD;
    • odrzucone – dokumenty, które odrzucono na punkcie ACD
    • wszystkie – wszystkie dokumenty: zarejestrowane, niezarejestrowane i odrzucone

Aby uruchomić filtrowanie listy dokumentów według warunków zdefiniowanych w oknie filtry, należy kliknąć w przycisk [Filtruj] – wówczas lista dokumentów w punkcie ACD zostanie zawężona zgodnie z wybranymi wartościami.

 

Okno „Filtry”

 

[Usuń filtry] – jeśli operator kliknie w tę ikonę, wtedy wszystkie warunki wyszukiwania dokumentu, które zdefiniowano w oknie „Filtry” oraz w ramach wyszukiwarki obok przycisku „Szukaj”, zostaną usunięte

 

[Odśwież] – gdy operator kliknie w tę ikonę, wówczas zostanie wyświetlona aktualna lista dokumentów

Operator może również zawęzić listę dokumentów lub wyszukać na niej dokument, wpisując frazę w polu wyszukiwarki nad listą dokumentów, a następnie klikając przycisk [Szukaj], podobnie, jak miało to miejsce w dotychczasowych wersjach.

 

W wersji 2023.0.0 dodano opcję odrzucenia dokumentu w punkcie ACD – w tym celu operator powinien kliknąć prawym przyciskiem myszy na daną pozycję na liście dokumentów w punkcie ACD i kliknąć wyświetlony wówczas przycisk [Odrzuć] – wtedy dokument zniknie z listy dokumentów niezarejestrowanych (jeśli miał taki status) i zostanie zarchiwizowany.

 

Uwaga
Wybór opcji „Odrzuć” jest możliwy tylko dla jednego dokumentu na raz.

 

Odrzucenie dokumentu w punkcie ACD

 

W wersji 2023.0.0 dodano opcję przywrócenia dokumentu w punkcie ACD – w tym celu operator powinien kolejno:

    • Nacisnąć przycisk [Filtry];
    • Zaznaczyć opcję „odrzucone” lub „wszystkie” w ramach pola „Stan faktury”;
    • Nacisnąć przycisk [Filtruj];
    • Na wyświetlonej liście wszystkich dokumentów lub dokumentów odrzuconych kliknąć prawym przyciskiem myszy na daną pozycję i nacisnąć wyświetlony wówczas przycisk [Przywróć] – wtedy dokument zostaje przywrócony i jest widoczny na liście dokumentów niezarejestrowanych (jeśli przedtem miał taki status).

 

Uwaga
Wybór opcji „Przywróć” jest możliwy tylko dla jednego dokumentu na raz.

 

Przywrócenie dokumentu w punkcie ACD

 

Od wersji 2025.0.0 na liście przeprocesowanych dokumentów w zależności od tego, czy i ile nazw atrybutów wprowadzono na zakładce „Ogólne” podczas konfiguracji punktu ACD (0,1,2 lub 3) widoczne jest 1- 4 kolumn.

Aby wprowadzić wartość w dodatkowych kolumnach, należy kliknąć w daną komórkę w wybranej kolumnie i wierszu, a następnie w poszerzonym polu edycji wpisać tekst. Wówczas wprowadzone dane zostaną zapisane w wybranych kontrolkach typu tekst.

 

Widok listy dokumentów w punkcie ACD typu „Import dokumentów zakupu z KSeF”, jeśli na zakładce „Ogólne” uzupełniono pola „Atrybut 1”, „Atrybut 2” i „Atrybut 3” – przed rozpoczęciem pracy w punkcie

 

Widok listy dokumentów w punkcie ACD typu „Import dokumentów zakupu z KSeF”, jeśli na zakładce „Ogólne” uzupełniono pola „Atrybut 1”, „Atrybut 2” i „Atrybut 3” i przeprocesowano dokument – wprowadzanie wartości dla „Atrybutu 3” (w tym przypadku to „Forma płatności”)

 

Widok listy dokumentów w punkcie ACD typu „Import dokumentów zakupu z KSeF”, jeśli na zakładce „Ogólne” uzupełniono pola „Atrybut 1”, „Atrybut 2” i „Atrybut 3” i przeprocesowano dokument – mapowanie danych z atrybutów do kontrolek typu Tekst

 

Jeśli wcześniej wprowadzono wartość atrybutu do tabeli do.KS_Documents, wówczas po przesunięciu kursora na daną komórkę w ramach kolumny atrybutu zostanie wyświetlona pełna wartość komórki.

Kiedy operator kliknie w nazwę danej kolumny, obok niej pojawi się ikona   – w takim przypadku lista jest posortowana w danej kolumnie według wartości rosnąco. Jeżeli operator kliknie ponownie w nazwę kolumny, wówczas obok tej nazwy wyświetlona zostaje ikona   – wtedy lista zostaje posortowana w danej kolumnie według wartości malejąco

Sortowanie dokumentów rosnąco ma miejsce według następującej kolejności:

  • Uszeregowane alfabetycznie;
  • Uszeregowane według kolejności numerycznej (0-9);
  • Uszeregowane według znaków specjalnych.

Sortowanie dokumentów malejąco ma miejsce według następującej kolejności:

  • Uszeregowane według znaków specjalnych;
  • Uszeregowane według kolejności numerycznej (9-0);
  • Uszeregowane alfabetycznie.

 

Jeśli operator przesunie kursor na początek nazwy danej kolumny, wówczas między kolumnami pojawia się ikona dwustronnej strzałki (kolor strzałki jest zależny od ustawień komputera dla wyglądu kursora) – wówczas po kliknięciu lewym przyciskiem myszki można zmieni szerokość kolumny, przeciągając ją w prawo albo w lewo.

 

Po kliknięciu na daną pozycję na liście dokumentów podgląd dokumentu z KSeF zostanie wyświetlony w lewym panelu, a pod nim widoczna będzie lista kontrolek, którą określono w ramach zakładki „Kontrolki” podczas definiowania danego punktu konfiguracyjnego.

Jeśli dany operator nie ma prawa do edycji dokumentu KSeF w punkcie ACD (podczas konfiguracji danego punktu ACD typu „Import dokumentów zakupu z KSeF” w ramach zakładki „Uprawnienia” nie zaznaczono dla niego parametru „Edycja dokumentu”), wówczas kontrolki na danym dokumencie w punkcie ACD są wyszarzone i niedostępne do edycji.

 

Zaznaczanie parametru „Edycja dokumentu” dla operatora „Administrator”

 

Pracujący punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF” (gdy użytkownik ma prawo do edycji wartości w kontrolkach)

 

Pracujący punkt konfiguracyjny typu „Import dokumentów zakupu z KSeF” (gdy użytkownik nie ma prawa do edycji wartości w kontrolkach)

 

Po sprawdzeniu danych w kontrolkach i ewentualnym uzupełnieniu wartości należy kliknąć w przycisk [Generuj], aby został utworzony nowy dokument w ramach typu obiegu, który zdefiniowano dla danego punktu ACD.

Istnieje możliwość zatrzymania generowania dokumentów – w tym celu należy kliknąć w przycisk [Zatrzymaj], który znajduje się w oknie „Inicjowanie dokumentów”. Generowanie dokumentów zostanie wówczas przerwane.

 

Okno „Inicjowanie dokumentów” z przyciskiem „Zatrzymaj”

 

 

Dokument, który wygenerowano z punkt konfiguracyjnego typu „Import dokumentów zakupu z KSeF”

 

Jeżeli poprawnie skonfigurowano punkt ACD i zapisano zmiany, wówczas po wygenerowaniu danego dokumentu do Comarch DMS nastąpi automatyczne dodanie załącznika w formacie pdf z fakturą KSeF na tym dokumencie, z nazwą faktury jako nazwą załącznika (zgodnie z nazwą faktury w kolumnie KSD_NumerFaktury w tabeli do.KS_Documents). Po kliknięciu w nazwę załącznika lub automatycznie po otwarciu dokumentu podgląd dokumentu zostanie wyświetlony w oknie po prawej stronie karty obiegu, podobnie jak w przypadku innych załączników.

 

Podgląd pliku pdf z fakturą z KSeF

Przykładowe błędy

Jeśli po kliknięciu w przycisk [Importuj]:

 

  • w ramach okna „Wybierz certyfikat” użytkownik kliknie przycisk [Anuluj] lub znak X w oknie „Wybierz certyfikat”, wówczas okno zostanie zamknięte i wyświetlony zostanie poniższy komunikat:

Komunikat wyświetlany, jeśli nie wybrano certyfikatu

 

  • w ramach okna „Wybierz certyfikat” użytkownik wybrał niewłaściwy certyfikat, wtedy okno zostanie zamknięte i wyświetlony zostanie następujący komunikat:

 

Komunikat wyświetlany, jeśli wybrano niewłaściwy certyfikat

 

  •  przedtem na zakładce „Integracje” (tryb jednofirmowy) lub „Połączenia z ERP” (tryb wielofirmowy) uzupełniono poprawnie pole „Token KSeF”, ale nie uzupełniono pola „NIP firmy”, wówczas pobieranie faktur nie jest możliwe i zostaje wyświetlony następujacy komunikat:

Komunikat wyświetlany, jeśli nie uzupełniono pola „NIP firmy”

 

  • przedtem na zakładce „Integracje” (tryb jednofirmowy) lub „Połączenia z ERP” (tryb wielofirmowy) uzupełniono poprawnie pole „Token KSeF”, ale uzupełniono niepoprawnie pole „NIP firmy”, wówczas pobieranie faktur nie jest możliwe – zostanie wyświetlone okno „Wybierz certyfikat”, a po wyborze właściwego certyfikatu wyświetli się następujący komunikat:

Komunikat wyświetlany, jeśli nie uzupełniono pola „NIP firmy”

 

Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch BPM (dawniej DMS)!

 




Wybór lokalizacji zapisu załącznika w Comarch BPM Repozytorium przez operatora dodającego załącznik w aplikacji desktop

W wersji 2025.2.0 umożliwiono operatorowi, który dodaje załącznik do dokumentu w Comarch BPM, wybranie,do którego folderu w Comarch BPM Repozytorium ma trafić taki załącznik.

W tym celu na definicji kontrolki typu Załącznik, w ramach zakładki „Archiwa” dodano nowy parametr „Pozwalaj na wybór lokalizacji podczas dodawania załącznika”.

Parametr jest domyślnie odznaczony – w takim przypadku załącznik dodawany na dokumencie zostanie zapisany w domyślnej lokalizacji w Comarch BPM Repozytorium, wybranej w polu „Lokalizacja” na zakładce „Archiwa” na definicji kontrolki.

 

Parametr „Pozwalaj na wybór lokalizacji podczas dodawania załącznika” na definicji kontrolki typu Załącznik

 

Jeżeli parametr „Pozwalaj na wybór lokalizacji podczas dodawania załącznika” został zaznaczony, wówczas podczas dodawania załącznika na dokumencie Comarch BPM zostanie otwarte okno, w którym operator może wybrać lokalizację w Comarch BPM Repozytorium, w której ma zostać zapisany dany załącznik.

 

Wybór lokalizacji przy dodawaniu załącznika na nowym dokumencie – domyślna lokalizacja

 

W ramach listy dostępnych lokalizacji wyświetlana jest lokalizacja domyślna (z pola „Lokalizacja” na definicji danej kontrolki typu Załącznik) oraz te katalogi w Comarch BPM Repozytorium, do których dany operator/operator z konfiguracji ma prawo do dokonania zapisu. W oknie wyświetlanych jest jednocześnie do 10 pozycji; jeśli jest ich więcej, można przejść do nich za pomocą suwaka.

 

Uwaga
W przypadku, jeśli operator doda jednocześnie do kontrolki typu Załącznik wiele załączników, wówczas lokalizacja wybrana w ramach okna zostanie zastosowana w stosunku do wszystkich aktualnie dodawanych załączników.

 

Lista lokalizacji do wyboru przy dodawaniu załącznika na nowym dokumencie (gdy użytkownik ma uprawnienia do nie więcej niż 10 lokalizacji w Repozytorium)

 

Lokalizacja wybrana przy dodawaniu załącznika na nowym dokumencie

 

Po wyborze lokalizacji należy potwierdzić wybór, klikając w przycisk [OK] – wówczas załącznik zostanie zapisany w wybranej lokalizacji.

W przypadku, jeśli na definicji danej kontrolki typu Załącznik wybrano więcej niż 1 typ dokumentu, wówczas operator przy dodawaniu załącznika najpierw wybiera typ dokumentu, a później lokalizację.

Jeżeli na definicji danej kontrolki typu Załącznik w ramach pola „Podczas zapisu załącznika w Repozytorium stosuj” wybrano „Login własny operatora”, a operator, który dodaje załącznik, nie ma uprawnień do żadnej lokalizacji w Repozytorium, wówczas zostanie wyświetlony komunikat informujący o braku uprawnień do dostępnych lokalizacji.

 

Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch BPM!

 

 




Ręczna konfiguracja aplikacji WEB (nowej aplikacji web)

Po wykonaniu początkowych kroków instalacji Comarch BPM (dawniej DMS) oraz po instalacji aplikacji serwerowej (zob. artykuł Instalacja początkowa Comarch BPM (dawniej DMS) i instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym dla: Comarch BPM (dawniej DMS) Standalone , Comarch BPM (dawniej DMS) we współpracy z Comarch ERP XL, Comarch BPM (dawniej DMS) we współpracy z Comarch ERP Optima, Comarch BPM (dawniej DMS) we współpracy z Comarch ERP Enterprise) należy przystąpić do konfiguracji aplikacji WEB

Uwaga

Dla poprawnego działania aplikacji WEB należy zainstalować następujące dodatki do serwera IIS:

Po pobraniu i instalacji Application Request Routing należy kolejno:

1. w ramach Menedżera Internetowych usług Internetowych  kliknąć na ikonę „Application Request Routing Cache”

2. w ramach paneluAkcje” po prawej stronie ekranu nacisnąć link „Otwórz funkcje”.

 

Wybór ikony „Application Request Routing Cache”  i przycisku „Otwórz funkcje”

 

3.  zaznaczyć parametr „Enable proxy” w ramach zakładki „Application Request Routing” i potwierdzić zmianę przyciskiem „Zastosuj”.

 

Włączanie proxy w ustawieniach „Application Request Routing” na serwerze IIS

 

Aby skonfigurować aplikację kliencką (WEB), administrator powinien:

1. W ramach katalogu zawierającego aplikację web (nową aplikację webową) otworzyć do edycji plik index.html i uzupełnić nazwę aplikacji web (nowej aplikacji webowej) w ramach klucza „base href”, przykładowo:

<base href=”/BPMWeb/”>

a następnie zapisać wprowadzone zmiany;

 

Uzupełnianie klucza base href w pliku index.html

 

2. W ramach katalogu zawierającego aplikację web (nową aplikację webową) otworzyć do edycji plik web.config i uzupełnić:

    • W ramach „WorkflowApi” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja serwerowa (starsza aplikacja web) i zamiast DocumentWorkflow.Apinazwę aplikacji serwerowej (starszej aplikacji web)
    • W ramach „WorkflowDashboards” (dodane w wersji 2024.1.1) zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja serwerowa (starsza aplikacja web) i zamiast DocumentWorkflow.Apinazwę aplikacji serwerowej (starszej aplikacji web)
    • W ramach „WorkflowWebsockets” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja serwerowa (starsza aplikacja web) i zamiast DocumentWorkflow.Apinazwę aplikacji serwerowej (starszej aplikacji web)

a następnie zapisać wprowadzone zmiany.

Przyklad

<rule name=”WorkflowApi” stopProcessing=”true”>
<match url=”^api/(.*)” />
<action type=”Rewrite” url=”http://localhost/BPMApi/api/v3/{R:1}”
logRewrittenUrl=”true” />
</rule>
<rule name=”WorkflowDashboards” stopProcessing=”true”>
<match url=”^dashboards/(.*)” />
<action type=”Rewrite”
url=”http://localhost/BPMApi/reports/{R:1}”
logRewrittenUrl=”true” />
</rule>
<rule name=”WorkflowWebsockets” stopProcessing=”true”>
<match url=”^hubs/(.*)” />
<action type=”Rewrite” url=”http://localhost/BPMApi/signalr/{R:1}”
logRewrittenUrl=”true” />
</rule>

 

Uzupełnianie pliku web.config w aplikacji web Comarch BPM (dawniej DMS)

 

Jeśli aplikacja ma współpracować z Comarch BPM (dawniej DMS) Repozytorium, wówczas należy również uzupełnić:

    • W ramach „RepositoryApi” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja Repozytorium i zamiast DocumentManager.WebApi – nazwę aplikacji Repozytorium
    • W ramach „RepositoryWebsockets” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja Repozytorium i zamiast DocumentManager.WebApinazwę aplikacji Repozytorium

a następnie zapisać wprowadzone zmiany.

 

Przyklad

<rule name=”RepositoryApi” stopProcessing=”true”>
<match url=”^api/repository/(.*)” />
<action type=”Rewrite” url=”http://localhost/repozytorium/api/{R:1}”
logRewrittenUrl=”true” />
</rule>
<rule name=”RepositoryWebsockets” stopProcessing=”true”>
<match url=”^hubs/repository/(.*)” />
<action type=”Rewrite” url=”http://localhost/repozytorium/hubs/{R:1}”
logRewrittenUrl=”true” />
</rule>

 

Uzupełnianie pliku web.config w aplikacji web Comarch BPM (dawniej DMS)

 

 

Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch BPM!




Definiowanie punktu konfiguracyjnego

 

Dodawanie nowego punktu i zakładka „Tryb współpracy”

Aby utworzyć punkt konfiguracyjny typu ‘Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM)’ należy w oknie „Automatyczne generowanie dokumentów” dodać nowy punkt konfiguracyjny za pomocą ikony . Na liście trybów pracy punktu jako druga dostępna jest opcja „Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM)”.

 

Punkt konfiguracyjny typu Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM), zakładka Tryb współpracy

 

Zakładka „Ogólne”

Na zakładce „Ogólne” należy w rubryce:

  • Nazwa punktu – określić nazwę pod jaką punkt konfiguracyjny będzie widoczny na liście punktów
  • Typ obiegu – wskazać typ obiegu, w ramach którego  można będzie przekazywać skany do usługi Comarch OCR z poziomu kontrolki typu załącznik na szczegółach dokumentu
  • Kontrolka – wybrać kontrolkę typu załącznik z danego typu obiegu, z której dokumenty będą przekazywane do Comarch OCR
  • Typ rejestru VAT – określić typ rejestru VAT (zakupu/sprzedaży), pod kątem którego dokumenty będą przetwarzane przez Comarch OCR
  • Domyślna forma płatności – opcjonalnie wpisać domyślną formę płatności, która zostanie określona dla dokumentu przeprocesowanego w usłudze Comarch OCR, jeśli na przesłanym dokumencie nie  rozpoznano formy płatności.
  • Kraj dokumentu – wskazać kraj dokumentu: Polskę, Niemcy lub Francję
  • Rozpoznawanie kodów kreskowych – wskazać czy funkcjonalność rozpoznawania kodów kreskowych ma być włączona. Parametr przyjmuje wartości:

     

    Wyłączone – kody kreskowe nie będą rozpoznawane w usłudze Comarch OCR

    Włączone – kody kreskowe będą rozpoznawane – jeżeli zaznaczono tę opcję, wówczas poniżej  dostępny jest parametr „Kod kreskowy wskazuje pierwszą stronę dokumentu”- zaznaczenie parametru sprawi, że na podstawie rozpoznanych kodów kreskowych nastąpi łączenie stron dokumentów. Łączenie stron dokumentu realizowane jest w ten sposób, że wszystkie strony, które wystąpiły od strony z kodem kreskowym do strony poprzedzającej stronę z kolejnym kodem kreskowym są jednym dokumentem.

    Uwaga
    Można wskazać ten sam typu obiegu dla dwóch punktów konfiguracyjnych – Współpraca z Comarch OCR oraz Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM). W takiej konfiguracji możliwe jest również wskazanie tej samej kontrolki typu załącznik, do której załączany będzie skan dokumentu przeprocesowanego w usłudze Comarch OCR.

    Punkt konfiguracyjny typu Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM), zakładka Ogólne

     

 

Zakładka „Kontrolki”

Na zakładce „Kontrolki” za pomocą zapytań SQL należy wskazać wartości, które będą wyświetlane w poszczególnych kontrolkach po przeprocesowaniu dokumentu w usłudze Comarch OCR. Przykłady zapytań SQL zostały przedstawione w artykule Przykłady zapytań SQL w zakładce Kontrolki.

Uwaga
W przypadku tego rodzaju współpracy z Comarch OCR wartości w kontrolce typu załącznik  nie są definiowane zapytaniem SQL, ale bezpośrednio w konfiguracji punktu ACD, w zakładce „Ogólne” (rubryka „Kontrolka”).

Punkt konfiguracyjny typu Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM), zakładka Kontrolki

 

Widok zakładki Automatyczne generowanie dokumentów po skonfigurowaniu punktu ACD

 

Przesyłanie skanów z kontrolki załącznik

Po skonfigurowaniu punktu ACD należy przejść do wybranego w punkcie typu obiegu, dodać nowy dokument, a następnie dodać plik za pomocą kontrolki typu załącznik – wówczas skan jest automatycznie przesyłany do usługi Comarch OCR i po chwili kontrolki zostają wypełnione informacjami rozpoznanymi przez Comarch OCR, zgodnie z zapytaniami SQL  zapisanymi dla poszczególnych kontrolek w dedykowanym punkcie ACD.

 

Kontrolki na nowym dokumencie, wypełnione danymi odczytanymi przez Comarch OCR

 

Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch BPM!




Comarch BPM – Tworzenie szablonów wydruków w sPrint osadzonym w Comarch BPM na przykładzie szablonu wydruku „Pocztowa książka nadawcza“

<a href=”https://pomoc.comarch.pl/dms/wp-content/uploads/2025/08/Comarch-BPM-Tworzenie-szablonow-wydrukow-w-sPrint-osadzonym-w-Comarch-BPM-na-przykladzie-szablonu-wydruku-Pocztowa-ksiazka-nadawcza.pdf”>Comarch BPM – Tworzenie szablonów wydruków w sPrint osadzonym w Comarch BPM na przykładzie szablonu wydruku „Pocztowa książka nadawcza“</a>




Czy wiesz, że można znacznie uprościć proces przekazywania dokumentu do kolejnego etapu obiegu?

Zamiast ręcznie wybierać uprawnienia z rozbudowanej listy „Uprawnienia do następnego etapu”, można wskazać pracownika bezpośrednio w kontrolce na formularzu dokumentu — z zawężonej i precyzyjnie dobranej listy dostępnych osób.

W momencie kliknięcia przycisku „Przejdź do następnego etapu”,

osoba wskazana w kontrolce typu Lista na karcie obiegu automatycznie zostanie przypisana do uprawnień na kolejny etap. Dzięki temu dokument trafi do właściwego pracownika, który został wybrany, bez konieczności dodatkowej, ręcznej konfiguracji uprawnień.

Warunkiem koniecznym działania tego mechanizmu jest przypisanie w definicji typu obiegu do etapu, do którego automatycznie przypisujemy wskazanego w kontrolce typu Lista pracownika, użytkownika technicznego (można utworzyć pracownika „Techniczny” bez uprawnień administratora).

W przypadku, gdy nie zostanie wybrana osoba w kontrolce typu Lista, w momencie przekazania dokumentu do następnego etapu pojawi się komunikat:

„Nie wybrano dodatkowych uprawnień w kontrolce Pracownik. Wybierz pracownika z Listy, aby można było przekazać dokument do następnego etapu.”

 

Komunikat wyświetlany, gdy nie zostanie wybrana osoba w kontrolce typu Lista, w momencie przekazania dokumentu do następnego etapu

 

 

Konfiguracja przykładu:

1. W ramach typu obiegu należy dodać następujące kontrolki:

  • kontrolkę typu Lista „Dział” (identyfikator: Dzial)wypełnianą danymi z bazy danych na podstawie następującego zapytania SQL:
 select dcd_id, DCD_Name1 from do.DF_ConfOSDictionary where dcd_type=1 and DCD_Archival=0

 

Konfiguracja kontrolki typu Lista „Dział”

  • kontrolkę typu Lista „Pracownik” (identyfikator: Pracownik) –  w ramach pola „Kontrolki powiązane” należy wybrać kontrolkę „Dział (Dzial)”; kontrolka „Pracownik” natomiast powinna zostać wypełniona danymi z bazy danych na podstawie następującego zapytania SQL:
 select t2.dcd_id, t2.dcd_Name1 from do.DF_ConfOSTree as t1
inner join do.DF_ConfOSDictionary as t2 on t1.DCO_DCDId=t2.DCD_ID
inner join do.DF_ConfOSTree as t3 on t1.DCO_DCOId=t3.DCO_ID 
left join do.DF_ConfOSDictionary as t4 on t4.DCD_ID=t3.DCO_DCDId
where t1.DCO_Archival=0 and t2.dcd_type=2 and t4.DCD_Name1=@Dzial_Text@

 

Definicja kontrolki typu Lista „Pracownik”

 

2. Następnie należy przypisać użytkownika Technicznego na definicji typu obiegu do etapu, do którego ma zostać przekazany dokument – w przykładzie jest to etap „Akceptacja”

Należy zapisać wprowadzone zmiany.

Przypisanie użytkownika Technicznego

 

3. Na bazie BPM należy zmodyfikować procedurę On.DocumentPropagation.

 

Uwaga
Należy pamiętać,  aby  w ramach przykładu procedury On.DocumentPropagation zmienić Id typu obiegu dla DFH_Id na id typu obiegu, którego ma dotyczyć.

Jeżeli:

  • zmieniono identyfikator kontrolki „Pracownik”, wówczas należy wpisać aktualny identyfikator dla DKO_Name
  • zmieniono nazwę etapu na inną niż „Akceptacja”, wówczas należy wprowadzić nazwę etapu dla DDS_Name

 

Przykład modyfikacji procedury On.DocumentPropagation:

ALTER PROCEDURE [do].[OnDocumentPropagation]

@WorkflowId as int = NULL, -- DSH_ID z tabeli DF_ConfDSHead

@StageId as int = NULL,-- DDS_ID z tabeli DF_ConfDSDictionary

@DocumentId as int = NULL, -- DWD_ID z tabeli DF_Work

@PropagatedById as int = NULL, -- DCD_ID z tabeli DF_ConfOSDictionary

@DocumentOwnerId as int = NULL, -- DWD_DCDOwnerId z tabeli DF_Work

@IsAutomaticPropagation as bit = NULL

AS

------------------------Początek-----------------------------

BEGIN

DECLARE @ErrorMessage NVARCHAR(MAX);

BEGIN TRY

/* Warunek przekazania dokumentu w określonym typie obiegu i etapie */

IF EXISTS (

SELECT 1

FROM do.RO_StageActive

WHERE DFH_Id = 6 /* Id typu obiegu Dynamiczne uprawnienia Lista */

AND DDS_Name = 'Akceptacja' /* Nazwa etapu, do którego przekazujemy dokument */

AND DWD_ID = @DocumentId

)

BEGIN

/* Sprawdzenie, czy nie zostały wybrane uprawnienia w kontrolce Pracownik */

IF EXISTS (

SELECT 1

FROM do.DF_ConfCFCardDokFlow c

JOIN do.df_workcf w ON c.DKO_ID = w.DWC_DKOId

WHERE c.DKO_Name = 'Pracownik' -- identyfikator kontrolki lista

AND w.DWC_DWDId = @DocumentId

AND w.DWC_ValueListPos IS NULL

)

BEGIN

/* Rzucenie komunikatu, jeśli nie wybrano uprawnień w kontrolce typu Lista o nazwie Pracownik */

SET @ErrorMessage = 'UWAGA!!! ' + CHAR(13) + CHAR(10) +

'Nie wybrano dodatkowych uprawnień w kontrolce Pracownik.' + CHAR(13) + CHAR(10) +

'Wybierz pracownika z Listy, aby można było przekazać dokument do następnego etapu.';

THROW 50001, @ErrorMessage, 1;

END

/* Dodanie dynamicznych uprawnień */

INSERT INTO do.DF_WorkDSAccess ([WSA_DWSId], [WSA_DCDId], [WSA_DCPId], [WSA_TypeAccess], [WSA_Archival])

SELECT DISTINCT

s.DWS_ID,

w.DWC_ValueListPos,

NULL,

0,

0

FROM do.RO_ControlsValue c

JOIN do.DF_WorkCF w ON w.DWC_DKOId = c.DKO_ID

JOIN do.RO_StageActive s ON s.DWD_ID = w.DWC_DWDId

WHERE c.DKO_Name = 'Pracownik' -- identyfikator kontrolki lista

AND w.DWC_DWDId = @DocumentId;

END

END TRY

BEGIN CATCH

/* Obsługa błędów */

DECLARE @CatchErrorMessage NVARCHAR(MAX) = ERROR_MESSAGE();

DECLARE @ErrorSeverity INT = ERROR_SEVERITY();

DECLARE @ErrorState INT = ERROR_STATE();

RAISERROR (@CatchErrorMessage, @ErrorSeverity, @ErrorState);

END CATCH

END

 

4.  Nastepnie należy utworzyć nowy dokument i wybrać pracownika w kontrolce typu Lista o nazwie Pracownik (identyfikator: Pracownik)

 

Uwaga
Pomimo przypisania użytkownika Technicznego dokumentu nie można przekazać (pojawia się stosowny komunikat), dopóki nie zostanie wybrany pracownik w kontrolce typu Lista o nazwie Pracownik.

 

Wyświetlanie komunikatu przy próbie rzekazania dokumentu do kolejnego etapu, gdy nie wybrano pracownika w kontrolce typu Lista

 

5. Po wybraniu pracownika dokument zostaje przekazany do tej osoby.

 

Widok dokumentu po przekazaniu do nastepnego etapu do wybranego pracownika

 

Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch BPM!