Kopiowanie zawartości katalogu BPM Workflow Api

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch BPM {wersja} i przekopiować zawartość katalogu BPM Workflow Api  do folderu, który utworzono podczas poprzedniej instalacji i do którego wówczas przeniesiono zawartość folderu BPM (dawniej DMS) Workflow Api lub DMS Web (jeśli aktualizowana jest wersja wcześniejsza niż 2024.0.0) (np. C:\inetpub\wwwroot\BPM).

Wprowadzanie zmian w pliku Web.config

Następnie w pliku konfiguracyjnym Web.config znajdującym się w katalogu C:\inetpub\wwwroot\{nazwa aplikacji serwerowej} należy wprowadzić potrzebne informacje, analogicznie jak podczas instalacji Comarch BPM (dawniej DMS) (zob. punkt Konfiguracja pliku web.config w artykule Instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym) i zapisać plik.

Uruchamianie skryptów

Następnie należy uruchomić skrypty na bazie Comarch BPM (dawniej DMS) oraz na bazach: konfiguracyjnej  i firmowej Comarch ERP Optima.

Uruchamianie skryptów na bazie Comarch BPM (dawniej DMS)

W katalogu BPM Workflow Api\Sql znajduje się plik Install.bat, który służy do instalacji skryptów na bazie Comarch BPM (dawniej DMS).

Lokalizacja pliku:

katalog z plikami instalacyjnymi \ Comarch BPM {wersja} \ BPM Workflow Api \ Sql \ Install.bat

Aby uruchomić skrypty, należy postępować w jeden z następujących sposobów:

Przyklad

Sposób 1

Należy uruchomić wiersz polecenia, wpisując cmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.

 

Następnie należy wpisać cd, nacisnąć spację i podać ścieżkę do lokalizacji pliku Install.bat – np. C:\inetpub\wwwroot\BPMapi\Sql – a następnie nacisnąć Enter.

Później należy uruchomić plik z linii poleceń wpisując:

Install.bat <nazwa_serwera> <nazwa_bazy_Comarch_BPM>

a następnie klikając Enter – wówczas zostaną uruchomione skrypty.

 

 

Po wykonaniu skryptów należy zamknąć okno Wiersza polecenia.

Przyklad

Sposób 2

W katalogu BPM Workflow Api\Sql należy odnaleźć plik Install.bat i otworzyć go do edycji.

 

 

 

Następnie w ramach okna edytora należy uzupełnić dane w następujący sposób:

set SERVER=nazwa_serwera

SHIFT

set DATABASE=nazwa_bazy_Comarch_BPM

a następnie zapisać zmiany i zamknąć okno.

 

 

 

Później należy kliknąć prawym przyciskiem myszki na plik Install.bat i wybrać opcję „Uruchom jako administrator”. Wówczas, po wyrażeniu zgody na dokonanie zmian przez Windows Command Processor, zostaną uruchomione skrypty. Po wykonaniu skryptów okno zostanie automatycznie zamknięte.

 

Uruchamianie skryptów na bazach konfiguracyjnej i firmowej Comarch ERP Optima

Analogiczny scenariusz należy wykonać dla katalogu BPM Workflow Api \ SqlOptima w tej samej lokalizacji.

Lokalizacja plików:

katalog z plikami instalacyjnymi \ Comarch BPM {wersja} \ BPM Workflow Api \ SqlOptima \ InstallOptimaComp.bat

Aby uruchomić skrypty, należy postępować w jeden z następujących sposobów:

Przyklad

Sposób 1

Należy uruchomić wiersz polecenia, wpisując cmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.

 

 

Następnie należy wpisać cd, nacisnąć spację i podać ścieżkę do lokalizacji pliku InstallOptimaConf.bat – np. C:\inetpub\wwwroot\BPMapi\SqlOptima – a następnie nacisnąć Enter.

Póżniej należy uruchomić plik z linii poleceń wpisując:

InstallOptimaConf.bat <nazwa_serwera> <nazwa_bazy_konfiguracyjnej_Comarch_ERP_Optima>

 

a następnie klikając Enter – wówczas zostaną uruchomione skrypty na bazie konfiguracyjnej Comarch ERP Optima.

 

 

Po wykonaniu skryptów w ramach tego samego okna należy wpisać następującą linię polecenia:

InstallOptimaComp.bat <nazwa_serwera> <nazwa_bazy_firmowej_Comarch_ERP_Optima>

 

a następnie kliknąć Enter – wówczas zostaną uruchomione skrypty na danej bazie firmowej Comarch ERP Optima.

Po wykonaniu skryptów należy zamknąć okno Wiersza polecenia.

 

Przyklad

Sposób 2

W katalogu DMS Workflow Api \SqlOptima należy odnaleźć plik InstallOptimaConf.bat i otworzyć go do edycji.

 

 

Następnie w ramach okna edytora należy uzupełnić dane w następujący sposób:

set SERVER=nazwa_serwera

SHIFT

set DATABASE=nazwa_bazy_konfiguracyjnej_Comarch_ERP_Optima

a następnie zapisać zmiany i zamknąć okno.

 

 

Później należy kliknąć prawym przyciskiem myszki na plik InstallOptimaConf.bat i wybrać opcję „Uruchom jako administrator”. Wówczas, po wyrażeniu zgody na dokonanie zmian przez Windows Command Processor, zostaną uruchomione skrypty. Po wykonaniu skryptów okno zostanie automatycznie zamknięte.

 

 

Następnie w tym samym katalogu BPM Workflow Api \SqlOptima należy odnaleźć plik InstallOptimaComp.bat i otworzyć go do edycji.

 

 

Następnie w ramach okna edytora należy uzupełnić dane w następujący sposób:

set SERVER=nazwa_serwera

SHIFT

set DATABASE=nazwa_bazy_firmowej_Comarch_ERP_Optima

a następnie zapisać zmiany i zamknąć okno.

 

 

Później należy kliknąć prawym przyciskiem myszki na plik InstallOptimaComp.bat i wybrać opcję „Uruchom jako administrator”. Wówczas, po wyrażeniu zgody na dokonanie zmian przez Windows Command Processor, zostaną uruchomione skrypty. Po wykonaniu skryptów okno zostanie automatycznie zamknięte.

 

Utworzenie użytkownika CDNHASPDMS za pomocą instalatora

W wersji 2025.2.3 w ramach okna „Wybór aplikacji” w instalatorze Comarch BPM dodano opcję „Tworzenie użytkownika CDNHASPDMS na serwerze Menadżera Kluczy”. Opcja umożliwia utworzenie użytkownika CDNHASPDMS bez konieczności przejścia całości procesu instalacji aplikacji Comarch BPM w przypadku, gdy operator przeprowadził ręczną instalację lub aktualizację Comarch BPM. Dodanie użytkownika CDNHASPDMS jest konieczne dla poprawnego działania Comarch BPM.

Aby dodać nowego operatora CDNHASPDMS, należy zaznaczyć opcję „Tworzenie użytkownika CDNHASPDMS na serwerze Menadżera Kluczy” i kliknąć w przycisk [Dalej].

Następnie operator przechodzi do okna „Wybór aplikacji serwerowej”, gdzie dostępne są następujące pola:

Po wyborze witryny i aplikacji należy kliknąć przycisk [Dalej], aby przejść do następnego okna, „Użytkownik CDNHASPDMS”.

W ramach okna, „Użytkownik CDNHASPDMS” znajdują się trzy pola:

Gdy pola „Nazwa serwera”, „Login” i „Hasło” są uzupełnione, wówczas należy kliknąć w przycisk [Połącz]. Jeśli w którymś z pól wprowadzono błędne dane, wówczas przycisk [Utwórz] pozostanie wyszarzony, a w dolnej części okna zostanie wyświetlona informacja: ”Wprowadzono nieprawidłowe dane logowania”. W takim przypadku należy poprawić dane i ponownie kliknąć w przycisk [Połącz].

Jeżeli na danym serwerze nie znajdują się odpowiednie procedury HASP, wówczas użytkownik nie zostaje utworzony, a w dolnej części okna zostaje wyświetlony komunikat „Nie znaleziono procedur HASP na serwerze.”.

Jeżeli poprawnie wprowadzono dane w oknie „Użytkownik CDNHASPDMS“, wówczas po kliknięciu w przycisk [Połącz] w dolnej części okna wyświetlona zostaje informacja „Nawiązano połączenie z serwerem”, a przycisk [Utwórz] staje się aktywny.

Następnie należy nacisnąć przycisk [Utwórz], a po chwili, gdy proces zakończy się powodzeniem, w dolnej części okna zostanie wyświetlona informacja „Użytkownik CDNHASPDMS został utworzony”.

Następnie należy kliknąć w przycisk [Zakończ] – wówczas instalator zostanie zamknięty. Operator może przystąpić do pracy z zainstalowaną aplikacją Comarch BPM, dla której dodano użytkownika CDNHASPDMS.

Reindeksacja bazy

W katalog BPM Workflow Api \ SQL znajduje się plik reindex.bat, który umożliwia:

Aby reindeksować bazę, należy uruchomić wiersz polecenia, wpisując cmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.

Następnie należy wpisać cd, nacisnąć spację i podać ścieżkę do lokalizacji pliku reindex.bat – np. C:\inetpub\wwwroot\BPMapi\Sql – a następnie nacisnąć Enter.

Póżniej należy uruchomić plik z linii poleceń wpisując:

reindex.bat <nazwa_serwera> <nazwa_bazy_Comarch_BPM>

a następnie klikając Enter – wówczas zostanie uruchomiona reindeksacja bazy Comarch BPM (dawniej DMS).

Po wykonaniu reindeksacji należy kliknąć dowolny przycisk, a później zamknąć okno Wiersza polecenia.

Weryfikacja poprawności konfiguracji aplikacji serwerowej

Poprawność instalacji można zweryfikować poprzez uruchomienie skonfigurowanej aplikacji serwerowej (dawny web) i zalogowanie się na użytkownika administrator (bez hasła). Od wersji 2025.1.0 w przypadku, gdy aplikację Comarch BPM instalowano za pomocą instalatora, w polu „Hasło” należy wprowadzić hasło, które wprowadzono dla administratora podczas instalacji, w ramach okna „Klucze licencji i hasło Administratora”.

Od wersji 2025.1.0 wsparcie dla starej wersji aplikacji web zostało zakończone – z tego powodu w przypadku, jeśli użytkownik próbuje uruchomić adres aplikacji serwerowej (dawnej web) w przeglądarce, wówczas zostanie wyświetlone okno z informacją Ta wersja aplikacji Comarch DMS Web nie jest już dostępna. Aby korzystać z aplikacji Comarch DMS Web oraz wszystkich jej funkcji, pobierz najnowszą wersję. Klikając w poniższy przycisk, zostaniesz przekierowany do strony nowej aplikacji Web.

Po kliknięciu w przycisk [Nowa aplikacja] operator zostaje przeniesiony na odpowiednią stronę nowej aplikacji Web.

Komunikat zostaje wyświetlony w języku używanym aktualnie przez przeglądarkę; jeśli dany język nie jest obsługiwany, wówczas komunikat wyświetla się w języku angielskim.

– domyślna ikonka typu obiegu; istnieje możliwość zmiany ikonki dla konkretnego typu obiegu  z poizomu aplikacji desktop Comarch DMS (zob. Zmiana ikony typu obiegu w aplikacji mobilnej (Android)  )

– nazwa typu obiegu, w ramach którego utworzono dany dokument

– numer dokumentu aplikacji Comarch DMS. Numer składa się z 4 części:

FAKT – prefix, 50- kolejny numer, 3- miesiąc, w którym został wystawiony dokument, 2024 – rok.

[Powrót] – powrót na listę dokumentów; jeżeli operator wprowadzi zmiany na karcie obiegu (np. wprowadzi dane do kontrolki/kontrolek), a następnie kliknie w tę ikonkę bez zapisywania zmian, wówczas wyświetlony zostanie następujący komunikat:

 

 

Jeżeli operator wybierze przycisk:

 [Odrzuć] – nastąpi powrót na listę dokumentów, a zmiany wprowadzone na karcie obiegu nie zostaną wprowadzone

[Zapisz]  –  nastąpi powrót na listę dokumentów, a zmiany wprowadzone na karcie obiegu zostaną wprowadzone

 [Info] – po kliknięciu w tę ikonę zostaje otwarte okno „Szczegóły dokumentu”, które składa się z dwóch części:

1. Informacje – w ramach tej zakładki widoczna jest informacja o tym, ile czasu pozostało na realizację zadania na danym etapie (jeśli ustawiono czas na realizację zadania – zob. Właściwości etapu – zakładka Przekazanie ) oraz jakie osoby są uprawnione do danego etapu.

 

 

2. Status – w ramach tej zakładki  widoczna jest informacja, na jakim etapie znajduje się dokument, do kogo jest przypisany i kiedy został przekazany.

Jeśli ustawiono czas na realizację zadania na danym etapie i ten czas minął, wówczas pod nazwą etapu wyświetlana jest także informacja „Po terminie” wraz z czasem, który upłynął od wyznaczonego czasu ukończenia zadania.

 

Po kliknięciu w przycisk [Zobacz historię przekazania]  następuje przejście do okna „Historia przekazania” , gdzie widoczny jest diagram obiegu dokumentu aż do chwili obecnej. Na niebiesko oznaczono aktualny etap, zaś na zielono – poprzednie.

 

Aby powrócić do okna „Szczegóły dokumentu”, należy kliknąć w znak X w lewym górnym rogu okna „Historia przekazania”

Aby powrócić z okna „Szczegóły dokumentu” na kartę obiegu dokumentu, należy kliknąć w znak w lewym górnym rogu okna „Szczegóły dokumentu”.

 

 

[Usuń] – umożliwia usunięcie wskazanego dokumentu.

Dokument może usunąć tylko operator z odpowiednimi uprawnieniami. Dokument po usunięciu znika z interfejsu, pozostaje jednak w bazie jako archiwalny. Istnieje możliwość przywrócenia takiego dokumentu.

Nie ma możliwości usunięcia dokumentu na innym etapie, niż przypisany do zalogowanego operatora oraz dokumentu z zakończonym obiegiem.

Po kliknięciu na ikonę usuwania dokumentu pojawia się komunikat informujący o próbie usunięcia dokumentu

 

Jeżeli operator wybierze przycisk:

[Anuluj] lub kliknie poza komunikatem – komunikat zostanie zamknięty, a dokument nie zostanie usunięty.

[Usuń] – nastąpi powrót na listę dokumentów, a dokument zostanie usunięty.

Przykładowe kontrolki

1. wybrać rok - klikając w rok widoczny na niebieskim tle w górnej części okna, a następnie przesuwając palcem listę lat (w górę - lata poprzednie, w dół - lata późniejsze) i naciskając na odpowiedni rok

2. wybrać miesiąc -  przesuwając palcem listę miesięc y(w górę - miesiące poprzednie, w dół - miesiące późniejsze) i naciskając na odpowiedni miesiąc

Następnie należy kliknąć [OK], aby wybrana data została wprowadzona w kontrolce typu data i godzina. Jeśli użytkownik chce zrezygnować z ustawiania daty, powinien nacisnąć [Anuluj] - wówczas data nie zostanie wprowadzona do kontrolki.

Jeżeli na definicji kontrolki typu Data i godzina w aplikacji desktop w ramach pola "Czas" wybrano opcję "Tak", wówczas po wyborze roku oraz miesiąca i  zatwierdzeniu wyboru przyciskiem [OK] zostaje wyświetlone okno z zegarem.

W górnej części zegara wyświetlana jest aktualna godzina, a poniżej - tarcza zegara, na której należy wybrać godzinę wraz z minutami, która ma zostać wprowadzona do danej kontrolki typu Data i godzina. W tym celu należy kliknąć najpierw na wybraną godzinę, a następnie na wybrany czas w minutach.

Jeżeli operator wybrał godzinę i minuty, ale chciałby edytować godzinę - wówczas wystarczy, że kliknie na godzinę na ciemnogranatowym tle w górnej części okna, a następnie wybierze poniżej na tarczy zegarowej odpowiednią godzinę .

Analogicznie, jeśli operator wybrał godzinę i minuty, ale chciałby edytować minuty - wówczas wystarczy, że kliknie na minuty w górnej części okna, a następnie wybierze poniżej na tarczy zegarowej odpowiednią liczbę minut .

Następnie należy kliknąć [OK], aby wybrana data została wprowadzona w kontrolce typu data i godzina. Jeśli użytkownik chce zrezygnować z ustawiania daty, powinien nacisnąć [Anuluj] - wówczas data nie zostanie wprowadzona do kontrolki.

----------------------------------------------------------------------------------------------------------------------------------

Gdy jest włączona opcja wersjonowania załączników, obok nazwy załącznika wyświetlana jest cyfra określająca liczbę wersji pliku załącznika.

W wersji 2023.0.0 uległa zmianie ikona załącznika w formacie PDF, zarówno w aplikacji serwerowej (dawny web) , jak i w aplikacji desktop. Aktualna ikona dla załącznika PDF to ikona 

- kontrolka typu wartość logiczna (zob. Wartość logiczna). Prezentuje wartości: Tak/Nie.

- kontrolka typu lista (zob. Lista). Wartości kontrolki definiowane są na jej właściwościach lub pochodzą z zapytania SQL lub C# zdefiniowanego na formatce Inicjowanie.

- kontrolka typu Dokument związany (zob. Dokumenty związane). Prezentuje wiązania wszystkich dokumentów z systemu Comarch ERP XL, do których dowiązany jest aktualny dokument z aplikacji Comarch DMS. Przycisk wywołuje listę dokumentów z systemu Comarch ERP XL, użytkownik ma możliwość podglądu szczegółów dokumentu oraz zmiany dokumentu na inny. Przycisk odpina dokument  z kontrolki. Jednocześnie operacja ta usuwa wiązania z tabeli cdn.dokzwiazane.

- kontrolka typu Dokument ERP XL (zob. Dokument ERP XL). Prezentuje numer dokumentu w systemie Comarch ERP XL, który został wygenerowany z poziomu aplikacji Comarch DMS wraz z opisem analitycznym. W kontrolce prezentowane są także numery istniejących dokumentów z systemu Comarch ERP XL, które zostały dowiązane.

- kontrolka typu dane tabelaryczne (zob. Dane tabelaryczne). Możliwość dodawania nieograniczonej ilość wierszy.

Typ i ilość kolumn jest określana na właściwościach kontrolki podczas definicji typu obiegu.

Wartości kontrolki mogą być wprowadzane ręcznie przez operatora, definiowane na jej właściwościach, pobierane z systemu Comarch ERP XL lub pochodzić z funkcjonalności inicjowania kontrolek zapytaniami SQL, kodem C# lub wyrażeniem.

- kontrolka typu ‘Dokument elektroniczny’ (zob. Dokument elektroniczny), dla kontrolki umożliwiono zatwierdzanie dokumentu pod względem merytorycznym oraz formalno – rachunkowym.

Zatwierdzenie dokumentu ERP XL pod względem merytorycznym i formalno-rachunkowym może zrealizować operator natywny DMS lub operator ERP XL zalogowany do Comarch DMS. W przypadku zatwierdzenia przez operatora natywnego DMS do dokumentu ERP XL zostanie przekazany login operatora DMS.

-  w kontrolce ‘Dokument ERP XL”, analogicznie do kontrolki ‘Dokument elektroniczny’ umożliwiono zatwierdzanie dokumentu pod względem merytorycznym oraz formalno – rachunkowym.

Uwaga

Należy pamiętać, aby na zakładce „Schemat obiegu” na  etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#”  przy danej kontrolce i  aby zapisać wszystkie wprowadzone zmiany  za pomocą przycisku [Zapisz] .

1.

Przyklad

Zainicjowanie kontrolki dokumentem ERP o identyfikatorze 5024 i typie 1521:

Globals.MainFrame.ERPDocument1.Id = 5024; Globals.MainFrame.ERPDocument1.IdType = 1521;

 

Poniższy film przedstawia zainicjowanie kontrolki typu Dokument elektroniczny podczas tworzenia nowego dokumentu:

Globals.MainFrame.ERPDocument1.IdText = "E97B3CE0-F719-44CD-A473-54A59ABF20D5"; 
Globals.MainFrame.ERPDocument1.IdTextType = "3EEC4A14-8263-4196-B721-CE7A61C12F45"; 
Globals.MainFrame.ERPDocument1.IdTextCategory = "2C755635-6E2F-4995-A0DA-2A2257FAC2F9";

 Globals.MainFrame.String1.Text=Globals.MainFrame.ERPDocument1.Number

m

W ramach pracy z punktem ACD typu „Import e-faktur ZUGFeRD i XRechnung” operatorzy dodają do punktu dokumenty, które następnie mają zostać zaimportowane do systemu Comarch DMS.

Aby poprawnie pracować z punktem, po zdefiniowaniu oraz zapisaniu punktu konfiguracyjnego należy w oknie tego punktu konfiguracyjnego nacisnąć ikonę [Ustaw folder], a następnie w ramach otwartego okna kliknąć przycisk „Ustaw” i wybrać lokalizację, z której będą pobierane dokumenty do przeprocesowania.

Operator może zaznaczyć parametr „Nie archiwizuj przeprocesowanych plików”. Jeśli parametr „Nie archiwizuj przeprocesowanych plików” zostanie zaznaczony, wówczas przeprocesowane pliki nie ulegną archiwizacji – po przetworzeniu zostaną usunięte i nie będą już dostępne w katalogu „Wysłane” w katalogu, który wybrano jako ten, z którego pobierane są pliki dokumentów do przeprocesowania.

Po wyborze lokalizacji i (opcjonalnie) zaznaczeniu parametru „Nie archiwizuj przeprocesowanych plików” należy kliknąć w przycisk „Zapisz”.

Aby dodać dokumenty do przetworzenia operator powinien:

Następnie należy zaznaczyć parametr [Włącz procesowanie dokumentów] i nacisnąć przycisk [Odśwież], aby odświeżyć listę dokumentów. Wówczas po prawej stronie okna, na liście dokumentów pojawią się zaimportowane dokumenty, zaś po lewej stronie – kontrolki wypełnione zgodnie z konfiguracją punktu ACD. W ramach pola „Przeprocesowane” widoczna jest liczba dokumentów, które zwróci zapytanie z zakładki „Lista” na definicji punktu ACD.

Aby wygenerować dokument DMS, należy wybrać wartość w ramach pola „Dokumenty” i kliknąć w przycisk „Generuj”, analogicznie jak w przypadku współpracy z Comarch OCR.

:

W ramach okna „Wybór aplikacji” w instalatorze Comarch BPM dodano opcję „Tworzenie użytkownika CDNHASPDMS na serwerze Menadżera Kluczy”. Opcja umożliwia utworzenie użytkownika CDNHASPDMS bez konieczności przejścia całości procesu instalacji aplikacji Comarch BPM w przypadku, gdy operator przeprowadził ręczną instalację lub aktualizację Comarch BPM.

Aby dodać nowego operatora CDNHASPDMS, należy zaznaczyć opcję „Tworzenie użytkownika CDNHASPDMS na serwerze Menadżera Kluczy” i kliknąć w przycisk [Dalej].

Następnie operator przechodzi do okna „Wybór aplikacji serwerowej”, gdzie dostępne są następujące pola:

Po wyborze witryny i aplikacji należy kliknąć przycisk [Dalej], aby przejść do następnego okna, „Użytkownik CDNHASPDMS”.

W ramach okna, „Użytkownik CDNHASPDMS” znajdują się trzy pola:

Gdy pola „Nazwa serwera”, „Login” i „Hasło” są uzupełnione, wówczas należy kliknąć w przycisk [Połącz]. Jeśli w którymś z pól wprowadzono błędne dane, wówczas przycisk [Utwórz] pozostanie wyszarzony, a w dolnej części okna zostanie wyświetlona informacja: ”Wprowadzono nieprawidłowe dane logowania”. W takim przypadku należy poprawić dane i ponownie kliknąć w przycisk [Połącz].

Jeżeli na danym serwerze nie znajdują się odpowiednie procedury HASP, wówczas użytkownik nie zostaje utworzony, a w dolnej części okna zostaje wyświetlony komunikat „Nie znaleziono procedur HASP na serwerze.”.

Jeżeli poprawnie wprowadzono dane w oknie „Użytkownik CDNHASPDMS“, wówczas po kliknięciu w przycisk [Połącz] w dolnej części okna wyświetlona zostaje informacja „Nawiązano połączenie z serwerem”, a przycisk [Utwórz] staje się aktywny.

Następnie należy nacisnąć przycisk [Utwórz], a po chwili, gdy proces zakończy się powodzeniem, w dolnej części okna zostanie wyświetlona informacja „Użytkownik CDNHASPDMS został utworzony”.

Następnie należy kliknąć w przycisk [Zakończ] – wówczas instalator zostanie zamknięty. Operator może przystąpić do pracy z zainstalowaną aplikacją Comarch BPM, dla której dodano użytkownika CDNHASPDMS.

W wersji 2025.2.3 dodano możliwość współpracy Comarch BPM z XL API 2025.1.

W wersji 2025.2.3 wprowadzono następujące zmiany dotyczące współpracy z KSeF:

Przebieg konfiguracji współpracy Comarch BPM z KSeF nie uległ zmianie – konfigurację opisano w artykule Konfiguracja współpracy Comarch BPM z KSeF – Baza Wiedzy programu Comarch BPM (dawniej DMS).

Aplikacje Comarch BPM w wersji 2025.2.3  współpracują z następującymi Systemami Comarch ERP:

Zastosowanie

Dzięki zastosowaniu tej zintegrowanej konfiguracji, proces obiegu faktur kosztowych w Comarch BPM zyskuje pełną automatyzację i spójność danych. Dane są pobierane bezpośrednio z systemu KSeF (poprzez BPM), a kontrolka tabelaryczna jest automatycznie wypełniana.

Głównym celem jest:

Konfiguracja przykładu

1. Utworzono kontrolkę ID_KSeF: Na karcie obiegu dodano kontrolkę typu Liczba całkowita o nazwie (identyfikatorze) ID_KSeF, do której będzie zapisywane ID dokumentu KSeF.

2. Utworzono kontrolkę Tabelaryczną: Dodano kontrolkę typu Dane tabelaryczne o nazwie (identyfikatorze) Elementy i skonfigurowano w niej następujące kolumny:

3. W kontrolce typu Dane tabelaryczne o nazwie (identyfikatorze) Elementy na zakładce Listy zdefiniowano zapytanie pobierające:

 

• Stawki VAT:

 select Naz_gidLp as Id,  
 CASE  
  WHEN Naz_Nazwa='A 23.00' THEN '23%' 
  WHEN Naz_Nazwa='B 8.00' THEN '8%' 
  WHEN Naz_Nazwa='C 0.00' THEN '0%' 
  WHEN Naz_Nazwa='D 0.00' THEN 'ZW' 
  WHEN Naz_Nazwa='E 0.00' THEN 'NP' 
  WHEN Naz_Nazwa='F 7.00' THEN '7%' 
  WHEN Naz_Nazwa='G 5.00' THEN '5%' 
 END  
 from CDN.Nazwy  
 where Naz_GIDTyp = 624  AND trim(substring(Naz_Nazwa,9,2))=''

 

 

• Jednostki miary:

SELECT Naz_GIDLp,Naz_Nazwa from cdn.Nazwy where Naz_GIDTyp=144;

4. Dodano obserwację kontrolki: W kontrolce Dane tabelaryczne, na zakładce Inicjowanie wartości, dodano powiązanie do kontrolki ID_KSeF oraz do samej siebie.

5. Dodano zapytanie SQL: W kontrolce Dane tabelaryczne, na zakładce Inicjowanie wartości w sekcji Wzór na wartość SQL ERP dodano zapytanie, które pobiera dane z tabel do.KS_DocumentItems na podstawie przekazanego parametru @ID_KSeF@ (ID dokumentu KSeF).

W zapytaniu SQL konieczne jest użycie logiki CASE WHEN do konwersji wartości pola KSI_ElementStawkaVAT (np. 'Stawka23′, 'zw’) na ujednolicony klucz, który następnie jest mapowany na identyfikatory liczbowe (Naz_GIDLp) stawek VAT z tabeli CDN.Nazwy z bazy XL. Logika CTE z ROW_NUMBER() zapewnia unikalność mapowanych ID.

IF @^SenderControlName@ = 'ID_KSeF' /*Identyfikator kontrolki do której pobierane jest ID dokumentu KSeF */

BEGIN

/* Tryb 1: Inicjowanie wierszy z dokumentu KSeF */

WITH ProcessedDocumentItems AS (

/* CTE 1: Ujednolicenie stawek VAT, tabela KSI_ElementStawkaVAT */

SELECT

KSI_ElementNazwa,

KSI_ElementCenaNetto,

KSI_ElementIlosc,

KSI_ElementWartoscNetto,

KSI_ElementStawkaVAT,

CASE

WHEN di.KSI_ElementStawkaVAT LIKE 'Stawka%' THEN LTRIM(RTRIM(SUBSTRING(di.KSI_ElementStawkaVAT, 7, LEN(di.KSI_ElementStawkaVAT) - 6)))

WHEN di.KSI_ElementStawkaVAT = 'zw' THEN 'ZW'

WHEN di.KSI_ElementStawkaVAT = 'np' THEN 'NP'

ELSE di.KSI_ElementStawkaVAT

END AS StandardizedStawkaVAT

FROM

[BAZA_BPM].do.KS_DocumentItems AS di /*Należy wskazać nazwę bazy BPM*/

WHERE KSI_DocumentId = @ID_KSeF@ /*Identyfikator kontrolki liczba całkowita, do której pobierane jest ID dokumentu KSeF*/

),

ProcessedNazwyRanked AS (

/* CTE 2: Porządkowanie stawek VAT z tabeli słownikowej (CDN.Nazwy), w celu zapewnienia unikalności */

SELECT

Naz_GIDLp,

Naz_Nazwa1,

CASE

WHEN LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%ZW%' THEN 'ZW'

WHEN LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%NP%' THEN 'NP'

WHEN CHARINDEX(' ', LTRIM(RTRIM(n.Naz_Nazwa1))) > 0 THEN LTRIM(RTRIM(SUBSTRING(n.Naz_Nazwa1, 1, CHARINDEX(' ', n.Naz_Nazwa1) - 1)))

ELSE LTRIM(RTRIM(n.Naz_Nazwa1))

END AS StandardizedNazwa1_ForJoin,

CASE

WHEN LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%ZW%' OR LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%NP%' THEN 0.00

WHEN ISNUMERIC(

CASE

WHEN CHARINDEX(' ', LTRIM(RTRIM(n.Naz_Nazwa1))) > 0 THEN LTRIM(RTRIM(SUBSTRING(n.Naz_Nazwa1, 1, CHARINDEX(' ', n.Naz_Nazwa1) - 1)))

ELSE LTRIM(RTRIM(n.Naz_Nazwa1))

END

) = 1 THEN CAST(

CASE

WHEN CHARINDEX(' ', LTRIM(RTRIM(n.Naz_Nazwa1))) > 0 THEN LTRIM(RTRIM(SUBSTRING(n.Naz_Nazwa1, 1, CHARINDEX(' ', n.Naz_Nazwa1) - 1)))

ELSE LTRIM(RTRIM(n.Naz_Nazwa1))

END

AS DECIMAL(5, 2)) / 100.0

ELSE 0.00

END AS CalculatedVATRate,

/* Numerujemy rekordy dla tego samego klucza łączenia. */

ROW_NUMBER() OVER (PARTITION BY

CASE

WHEN LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%ZW%' THEN 'ZW'

WHEN LTRIM(RTRIM(n.Naz_Nazwa1)) LIKE '%NP%' THEN 'NP'

WHEN CHARINDEX(' ', LTRIM(RTRIM(n.Naz_Nazwa1))) > 0 THEN LTRIM(RTRIM(SUBSTRING(n.Naz_Nazwa1, 1, CHARINDEX(' ', n.Naz_Nazwa1) - 1)))

ELSE LTRIM(RTRIM(n.Naz_Nazwa1))

END

ORDER BY n.Naz_GIDLp ASC) as RN

FROM

CDN.Nazwy AS n

WHERE Naz_GIDTyp = 624

),

ProcessedNazwy AS (

/* CTE 3: Finalne, unikalne stawki */

SELECT

Naz_GIDLp,

StandardizedNazwa1_ForJoin,

CalculatedVATRate

FROM

ProcessedNazwyRanked

WHERE RN = 1 /* Wybieramy tylko jeden (pierwszy) rekord dla każdej unikalnej stawki */

)

/* Końcowy SELECT: Zwraca żądany zestaw kolumn */

SELECT

pi.KSI_ElementNazwa,

pi.KSI_ElementCenaNetto,

pi.KSI_ElementIlosc,

pi.KSI_ElementWartoscNetto,

pn.Naz_GIDLp AS 'stawka VAT', /* ID stawki z drugiej tabeli */

pi.KSI_ElementWartoscNetto * (1 + pn.CalculatedVATRate) AS 'Wartość brutto',

NULL AS 'NULL'

FROM

ProcessedDocumentItems AS pi

JOIN

ProcessedNazwy AS pn

ON

pi.StandardizedStawkaVAT = pn.StandardizedNazwa1_ForJoin;

END

ELSE

IF @^SenderControlName@ = 'Elementy' /*Identyfikator kontrolki Dane tabelaryczne*/

BEGIN

/* Tryb 2: Automatyczne przeliczanie wartości w trybie edycji */

/* Kolumny 2-Cena, 3-Ilość, 5-Stawka VAT */

IF @Elementy_Column@=2 OR @Elementy_Column@=3 OR @Elementy_Column@=5

BEGIN

DECLARE @VAT as decimal (4,2)

/* Pobranie stawki VAT z tabeli słownikowej */

SELECT @VAT=CAST(SUBSTRING (Naz_Nazwa1, 0, CHARINDEX (' ', Naz_Nazwa1)) as decimal (4,2))/100

FROM CDN.Nazwy

WHERE Naz_GIDTyp=624 AND Naz_GIDLp=

(SELECT [Stawka VAT]

FROM @Elementy@

WHERE POS=@Elementy_Row@)

UPDATE @Elementy@

/* Aktualizacja wartości Netto */

SET [Netto] = (Ilosc * Cena),

/* Aktualizacja wartości Brutto */

[Brutto] = (Ilosc * Cena) * (@VAT + 1)

WHERE POS=@Elementy_Row@

/* Zwrócenie zaktualizowanej tabeli - Obowiązkowy select */

SELECT * FROM @Elementy@

END

END

6. Utworzono kontrolkę liczbową: Dodano kontrolkę typu Liczba stałoprzecinkowa o nazwie (identyfikatorze) WartoscNetto, w której dodano powiązanie do kontrolki Elementy i skonfigurowano w niej zapytanie, które zlicza wartość z kolumny Netto z kontrolki tabelarycznej:

select sum (Netto) from  @Elementy@

7. Utworzono kontrolkę liczbową: Dodano kontrolkę typu Liczba stałoprzecinkowa o nazwie (identyfikatorze) WartoscBrutto, w której dodano powiązanie do kontrolki Elementy i skonfigurowano w niej zapytanie, które zlicza wartość z kolumny Brutto z kontrolki tabelarycznej:

select sum (Brutto) from  @Elementy@

8. Punkt ACD: W punkcie konfiguracyjnym ACD (Współpraca z KSeF), na zakładce Kontrolki, dodano kontrolkę ID_KSeF i przypisano jej zapytanie, które pobiera ID dokumentu KSeF:

 select @Id1@

Uzupełniona kontrolka typu Dane Tabelaryczne

Po pomyślnym zainicjowaniu dokumentu z punktu ACD, kontrolka typu Dane Tabelaryczne została automatycznie wypełniona pozycjami odczytanymi z KSeF.

Dla każdej pozycji, system automatycznie przeliczył i uzupełnił wartości w kolumnach Netto i Brutto w tym samym wierszu. W przypadku nieprawidłowości w kwotach możliwe jest przeliczanie wartości Netto/Brutto poprzez zmianę Ceny/Ilości lub Stawki VAT.

Kolumna Netto oraz Brutto jest zablokowana do ręcznej edycji (tryb „Do odczytu”), co gwarantuje poprawność danych.

Kontrolka Wartość Netto wyświetla poprawną sumę końcową z kolumny Netto kontrolki typu Dane tabelaryczne.

Kontrolka Wartość Brutto wyświetla poprawną sumę końcową z kolumny Brutto kontrolki Dane tabelaryczne.