Istnieje możliwość edycji konfiguracji integracji Comarch BPM (dawniej DMS) z Comarch HRM w przypadku zmiany adresu URL aplikacji lub klucza wymiany.

Aby dokonać edycji, administrator Comarch HRM powinien w ramach Comarch HRM kliknąć na ikonę [Ustawienia] i  wybrać opcję „Konfiguracja”.

Następnie należy wybrać zakładkę „Integracje” i kliknąć w link „Zmień” w ramach pola „Comarch BPM”.

W otwartym oknie Integracja z Comarch BPM  należy zmienić dane, które uległy zmianie, kopiując je z aplikacji desktop Comarch BPM (dawniej DMS)  z zakładki „Struktura organizacyjna” z karty pracownika, którego konta użyto do integracji – analogicznie jak przy uruchamianiu integracji (zob. Uruchamianie integracji Comarch BPM z Comarch HRM). Później administrator Comarch HRM powinien kliknąć na przycisk [Zatwierdź].

Jeżeli edycja integracji zakończyła się sukcesem, wówczas w prawym dolnym rogu strony zostanie wyświetlony następujący komunikat:

Zarówno w trybie jedno -, jak i wielospółkowym dla każdego pracownika po wyborze zakładki API na karcie pracownika w ramach zakładki Struktura organizacyjna widoczne jest pole System współpracujący. Jeśli wybrano w nim opcję Brak, wówczas jest to jedyne pole widoczne w tej zakładce – konto danego pracownika nie zostało natomiast użyte do integracji z systemem współpracującym przez API.

Jeżeli jednak w ramach pola System współpracujący wybrano nazwę systemu współpracującego, wtedy wyświetlane są także pozostałe pola konieczne do przeprowadzenia integracji:

[Generuj nowy klucz wymiany] – naciśnięcie tej ikony powoduje wygenerowanie nowego klucza wymiany, który jest wyświetlany w polu Klucz wymiany

[Kopiuj klucz wymiany] – wybór tej ikony powoduje skopiowanie klucza wymiany, który jest wyświetlany w polu Klucz wymiany

– po wyborze tej ikony wyświetlona zostaje informacja, która wyjaśnia, do czego jest potrzebny klucz wymiany: Skopiowany klucz wymiany i adres URL aplikacji WEB należy wprowadzić w ustawieniach aplikacji, z którą konfigurowana jest współpraca.

Po uzupełnieniu pól należy zapisać zmiany za pomocą ikony [Zapisz].

W przypadku pracy w trybie wielospółkowym przy włączonej współpracy z Comarch ERP Optima w celu współpracy z systemem HRM adres URL aplikacji BPM (dawniej DMS) i wygenerowany klucz wymiany należy skopiować i wkleić w ustawieniach systemu HRM.

Wybór przycisku „Comarch BPM ” do włączenia integracji z Comarch BPM (dawniej DMS)[/caption]

Następnie  administrator powinien nacisnąć przycisk Wprowadź klucz wymiany.

Zostanie wówczas otwarte okno Integracja z Comarch BPM, w którym znajdują się dwa pola:

Aby poprawnie uzupełnić pole Adres WWW, należy:

1. zalogować się do Comarch BPM (dawniej DMS)  desktop jako administrator Comarch BPM (dawniej DMS) ;

2. wybrać spółkę Comarch ERP Optima

3. wybrać kartę pracownika,  którego konta użyto do integracji z systemem współpracującym z Comarch HRM (zob. Zakładka API na karcie pracownika – integracja BPM z HRM);

4. w zakładce „API” nacisnąć przycisk [Kopiuj URL aplikacji].

Skopiowany w ten sposób adres URL należy wkleić w polu Adres WWW w oknie Integracja z Comarch DMS w Comarch HRM.

Analogicznie aby poprawnie uzupełnić pole Klucz wymiany, należy, będąc zalogowanym  do Comarch BPM (dawniej DMS)  desktop jako administrator Comarch BPM (dawniej DMS) :

1. wybrać spółkę Comarch ERP Optima;

2. wybrać kartę pracownika,  którego konta użyto do integracji z systemem współpracującym z Comarch HRM (zob. Zakładka API na karcie pracownika – integracja BPM z HRM);

3. w zakładce „API” nacisnąć przycisk [Kopiuj klucz wymiany].

Skopiowany w ten sposób klucz wymiany należy wkleić w polu Klucz wymiany w oknie Integracja z Comarch BPM w Comarch HRM.

Po wprowadzeniu poprawnych danych w polach Adres WWW  i Klucz wymiany należy kliknąć przycisk [Zatwierdź].

Jeżeli uruchomienie integracji zakończyło się sukcesem, wówczas w prawym dolnym rogu strony zostanie wyświetlony następujący komunikat:

Następnie administrator Comarch HRM w ramach zakładki „Obieg dokumentów”  powinien wybrać przycisk Dodaj obieg dokumentów.

Następnie administrator powinien uzupełnić nastepujące pola:

Po uzupełnieniu wszystkich pól administrator powinien kliknąć przycisk [Zapisz].

Nowopowstały typ obiegu jest widoczny w Comarch HRM po kliknięciu na zakładkę  Obieg dokumentów i jest dostępny dla pracowników, zgodnie z ustawieniami dostępności dla danego typu obiegu.

W wersji 2024.1.0 wprowadzono integrację Comarch DMS z usługą e-Doręczenia.

W ramach zakładki [Automatyczne generowanie dokumentów] dostępny jest typ punktu ACD „Import dokumentów ze skrzynki e-Doręczenia”, który ma na celu umożliwienie pobierania wiadomości z usługi e-Doręczenia.

Zakładka „Tryb współpracy”

Aby utworzyć punkt konfiguracyjny typu „Import dokumentów ze skrzynki e-Doręczenia” należy w oknie „Automatyczne generowanie dokumentów” dodać nowy punkt konfiguracyjny za pomocą ikony , a następnie na liście trybów pracy punktu wybrać opcję „Import dokumentów ze skrzynki e-Doręczenia” .

Zakładka „Ogólne”

W ramach zakładki „Ogólne” znajdują się następujące pola:

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 danego typu obiegu po przeprocesowaniu dokumentu.

Załączniki przesłane w wiadomości zostaną dodane do wskazanej kontrolki typu Załącznik.

Zakładka Uprawnienia

Na zakładce definiowane są uprawnienia do pracy z punktem konfiguracyjnym. Uprawnienia mogą być dodawane poprzez wskazanie pracowników, nie ma możliwości dodania uprawnień dla pracowników wskazanego działu czy pracowników zajmujących określone stanowisko.

Na każdej zakładce znajduje się ikona [Eksport], która umożliwia eksportowanie danego punktu ACD do zapisu na dysk.

Otrzymany zamówiony certyfikat  (zob. Pierwsze kroki w konfiguracji integracji Comarch BPM z usługą e-Doręczenia – generowanie żądania certyfikatu CSR i zakup pieczęci elektronicznej) będzie zapisany w pliku z rozszerzeniem .crt.

Konwersja zakupionego certyfikatu do formatu Base-64

Plik należy przekonwertować do formatu Base-64, aby przygotować go do dalszej konfiguracji, zgodnie z poniższymi krokami – należy kolejno:

1. Plik certyfikatu umieścić w folderze lokalnego komputera

2. Kliknąć dwukrotnie na plik.

3. W nowym oknie kliknąć Otwórz;

4. Przejść do zakładki Szczegóły i nacisnąć Kopiuj do pliku…;

5. W oknie kreatora eksportu certyfikatów przejść dalej i w kroku Format pliku eksportu zaznaczyć Certyfikat X.509 szyfrowany algorytmem Base-64 (CER), następnie kliknąć Dalej,

6. Wprowadzić nazwę tworzonego pliku i kliknąć Dalej;

7. W ostatnim kroku Kończenie pracy kreatora eksportu certyfikatów wyświetlone zostanie podsumowanie wraz ze ścieżką do miejsca zapisu nowego pliku certyfikatu. Domyślnie będzie to ten sam katalog, w którym znajduje się źródłowy certyfikat. Kliknąć Zakończ;

W katalogu zostanie zapisany nowy plik o wskazanej nazwie, a kreator potwierdzi zakończenie eksportu. Teraz można zamknąć wszystkie wcześniej otwarte okna.

Rejestracja nowego systemu w usłudze e-Doręczenia

Nowy plik z certyfikatem w rozszerzeniu .cer zostanie wykorzystany do dodania nowego systemu w usłudze e-Doręczenia.

Link do portalu, na którym należy zarejestrować certyfikat, to ogólna strona logowania do systemu e-Doręczeń: e-Doręczenia – Portal Gov.pl

Należy zalogować się do swojej skrzynki e-Doręczeń (np. przez mObywatel lub Biznes.gov.pl – w zależności od typu podmiotu).

Plik należy wgrać w oknie Uprawnienia w skrzynce e-Doręczeń -> Systemy -> Dodaj system -> Wybierz środek uwierzytelniający -> Kwalifikowany środek uwierzytelniający.

Konfiguracja konta usługi e-Doręczenia w Comarch BPM

Po wgraniu uzyskanego w powyższych krokach certyfikatu z rozszerzeniem .cer, należy przystąpić do konfiguracji w BPM (dawniej DMS):

• dla trybu jednospółkowego: w menu Ustawienia -> zakładka Integracje, gdzie konieczne będzie podanie nazwy systemu dodanego w usłudze e-Doręczenia oraz wskazanie klucza prywatnego utworzonego w początkowej części artykulu Pierwsze kroki w konfiguracji integracji Comarch BPM z usługą e-Doręczenia – generowanie żądania certyfikatu CSR i zakup pieczęci elektronicznej 

 

 

 

W ramach zakładki dostępne są trzy pola:

• Adres skrzynki – adres skrzynki e-Doręczeń, pochodzący bezpośrednio ze skrzynki;

 

 

• Nazwa systemu wprowadzona w konfiguracji skrzynki e-Doręczenia – nazwa systemu Comarch BPM (dawniej DMS) integrowanego z usługa e-Doręczenia, którą dodano podczas konfiguracji skrzynki e-Doręczenia w polu „Systemy”.

 

 

 

• Klucz prywatny – pole, w którym należy dodać klucz prywatny, który jest pozyskiwany w procesie generowania certyfikatu – dostarczony razem z certyfikatem. Aby dodać klucz prywatny, należy kliknąć w przycisk , dostępny w ramach pola, a następnie w ramach otwartego okna systemowego wybrać odpowiedni klucz PEM i kliknąć w przycisk [Otwórz]. Klucz prywatny, który dodano do definicji punktu ACD, może zostać usunięty z punktu za pomocą ikony lub zapisany na dysku za pomocą ikony .

Wprowadzone zmiany należy zapisać za pomocą przycisku  [Zapisz], dostępnego w ramach sekcji.

• dla trybu wielospółkowego: w menu Ustawienia -> zakładka Połączenia z ERP  -> ustawienia odpowiedniej spółki, gdzie konieczne będzie podanie nazwy systemu dodanego w usłudze e-Doręczenia oraz wskazanie klucza prywatnego utworzonego w początkowej części artykulu Pierwsze kroki w konfiguracji integracji Comarch BPM z usługą e-Doręczenia – generowanie żądania certyfikatu CSR i zakup pieczęci elektronicznej [/su_list]

W ramach zakładki dostępne są trzy pola dotyczące konfiguracji współpracy Comarch BPM z usługą e-Doręczenia:

– adres skrzynki e-Doręczeń, pochodzący bezpośrednio ze skrzynki;

– nazwa systemu Comarch BPM (dawniej DMS) integrowanego z usługa e-Doręczenia, którą dodano podczas konfiguracji skrzynki e-Doręczenia w polu „Systemy”.

– pole , w którym należy dodać klucz prywatny, który jest pozyskiwany w procesie generowania certyfikatu – dostarczony razem z certyfikatem. Aby dodać klucz prywatny, należy kliknąć w przycisk , dostępny w ramach pola, a następnie w ramach otwartego okna systemowego wybrać odpowiedni klucz PEM i kliknąć w przycisk [Otwórz]. Klucz prywatny, który dodano do definicji punktu ACD, może zostać usunięty z punktu za pomocą ikony lub zapisany na dysku za pomocą ikony .

Wprowadzone dane należy zapisać, używając przycisku dyskietki   [Zapisz].

W systemie Comarch BPM (dawniej DMS) istnieje możliwość integracji z usługą e-Doręczenia.

Integracja polega na możliwości pobierania wiadomości przychodzących na skrzynkę oraz na możliwości wysyłania wiadomości w ramach usługi e-Doręczenia z poziomu systemu Comarch BPM (dawniej DMS).

Aby zintegrować system do zarządzania dokumentami (np. Comarch BPM) z usługą e-Doręczenia konieczne jest posiadanie kwalifikowanego certyfikatu. W związku z tym podmioty niepubliczne –  m.in. spółki, które chcą zintegrować Comarch BPM (dawniej DMS) z usługą e-Doręczenia – w celu pobierania i wysyłania wiadomości są zobligowane do zakupu pieczęci elektronicznej lub kwalifikowanego podpisu.

Do integracji Comarch BPM (dawniej DMS) z usługą e-Doręczenia, rekomendowany jest zakup Pieczęci elektronicznej Szafir wystawianej przez Krajową Izbę Rozliczeniową z wykorzystaniem żądania CSR.

Aby zakupić Pieczęć elektroniczną Szafir, należy:

1. Wygenerować żądanie certyfikatu CSR – poprzez wykorzystanie środowiska OpenSSL

• OpenSSL to oprogramowanie open source, oferujące prosty interfejs wiersza polecenia służący do generowania kluczy. Oprogramowanie dostępne jest np. na stronie: https://slproweb.com/products/Win32OpenSSL.html
• Do przygotowania żądania CSR potrzebny będzie klucz prywatny:
  • Aby wygenerować klucz prywatny, należy przejść do terminala i użyć polecenia:

openssl genrsa -out private_key.key 2048

 

• • Polecenie tworzy klucz prywatny o nazwie private_key.key o długości 2048

 

 

 

Uwaga

Plik private_key.key zostanie utworzony domyślnie w bieżącym katalogu roboczym, z którego uruchomiono polecenie.

Bezwzględnie należy zabezpieczyć klucz prywatny – nie może być udostępniany nikomu.

 

• Następnie za pomocą klucza prywatnego zostanie utworzone żądanie(CSR): do konsoli należy wkleić i wykonać komendę:

 

openssl req -new -key private_key.key -out request.pem

 

W efekcie otrzymamy plik request.pem z zapisanym żądaniem CSR, wygenerowany za pomocą klucza prywatnego private_key.key

 

• W trakcie wykonywania komendy, w konsoli zostanie wyświetlony komunikat w którym trzeba będzie podać dodatkowe informacje:
  • CountryName(kod kraju w formacie dwuliterowym),
  • State or Province Name(województwo),
  • Locality Name(miasto),
  • Organization Name(pełna nazwa organizacji),
  • Organizational Unit Name(dział organizacji),
  • Common Name(nazwa lub domena dla której wystawiany jest certyfikat).

 

 

• Po utworzeniu żądania CSR można zweryfikować jego zawartość za pomocą polecenia:

 

openssl req -text -noout -verify -in request.pem

 

Wyświetlony wynik powinien być zgodny z podanymi danymi

 

 

• Jeżeli dane są poprawne, plik request.pem można będzie przesłać do podmiotu certyfikującego w celu uzyskania kwalifikowanej pieczęci elektronicznej

 

Uwaga

Wygenerowany klucz prywatny należy zapisać i zabezpieczyć przed dostępem osób nieupoważnionych. Klucz prywatny, w pełnej jego formie, wraz z nagłówkami i stopką, będzie niezbędny do przeprowadzenia integracji z usługą e-Doręczenia.

 

2. Wygenerowane żądanie CSR request.pem przekazać do podpisu przy użyciu podpisu kwalifikowanego.

• Żądanie CSR (plik request.pem) musi być podpisane podpisem kwalifikowanym w formacie CAdES – jeśli Twoja aplikacja do podpisywania nie pozwala na złożenie podpisu w tym formacie skorzystaj z aplikacji Szafir do składania i weryfikacji podpisu elektronicznego: https://www.elektronicznypodpis.pl/aplikacje-i-sterowniki.
• Składanie i weryfikacja podpisu elektronicznego w aplikacji Szafir – w aplikacji Szafir należy kolejno:
  • przejść do sekcji Konfiguracja,
  • zmienić aktywną konfigurację,
  • ustawić format na CAdES (PKCS#7),
  • w sekcji Parametry podpisu zaznaczyć opcję Zapisz podpisywane dane razem z podpisem,
  • zapisać konfigurację i podpisać plik żądania certyfikatu, korzystając z aplikacji Szafir,

 

 

 

 Po podpisaniu żądania otrzymamy plik z rozszerzeniem .sig, który będzie można przekazać do KIR.

 

 

3.  przejść do sklepu Krajowej Izby Rozliczeniowej i odszukać produkt Pieczęć elektroniczna Szafir. Można skorzystać z tego linku.

• Na stronie sprzedawcy konieczne jest wybranie terminu ważności kwalifikowanej pieczęci elektronicznej. Dostępne opcje to: 1 rok lub 2 lata.
• Należy wybrać właściwą dla swojej organizacji wersję pieczęci wśród wymienionych poniżej:

• • Pieczęć elektroniczna kwalifikowana z wgraniem żądania CSR online:
    • Rozwiązanie wymaga posiadania kwalifikowanego podpisu, który jest niezbędny do podpisania żądania CSR związanego z certyfikatem. Dzięki temu sprawę można załatwić w pełni online.
    • Jeżeli żądanie CSR zostało wygenerowane, wówczas powinno zostać podpisane podpisem kwalifikowanym Prezesa lub Prokurenta. Szczegóły procesu podpisywania znajdują się w poprzednich krokach,
  • Pieczęć elektroniczna z dostarczeniem żądania CSR do placówki KIR:
    • Żądanie nie wymaga posiadania podpisu kwalifikowanego, ale konieczna jest fizyczna wizyta Prezesa lub Prokurenta w jednym z dwunastu Regionalnych Centrów Sprzedaży KIR (Krajowa Izba Rozliczeniowa), aby dostarczyć wygenerowany CSR z żądaniem certyfikatu.
• Nastepnie należy wykonać kolejno następujące kroki:
  • wybrać opcję Nowy zestaw, jeśli pieczęć kupujesz po raz pierwszy. Proszę NIE zaznaczać opcji Certyfikat do PSD2.
  • kliknąć Dodaj do koszyka,
  • przejść do koszyka i kliknąć Złóż zamówienie.
  • kliknąć Uzupełnij dane, w kolejnym kroku uzupełnić dane osoby upoważnionej do odebrania pieczęci elektronicznej,
  • przejść w dół do sekcji Dane do certyfikatu pieczęci elektronicznej i uzupełnić dane zgodnie z potrzebami organizacji oraz zgodnie z danymi przekazanymi w żądaniu CSR.
• Później należy przejść niżej do ostatniej sekcji:
  • Certyfikat online: Wgram żądanie PKCS#10 – w tym kroku należy przesłać plik CSR w rozszerzeniu .sig, który został podpisany kwalifikowanym podpisem.
  • Certyfikat w placówce KIR: Dostarczę żądanie PKCS#10 do placówki KIR – w tym kroku należy wybrać oddział, do którego zostanie dostarczone żądanie certyfikatu CSR.
• Następnie należy przejść do kroku 2 – Dane do zamówienia, a następnie do kroku 3 – Podsumowanie i płatność. W ramach wspomnianych kroków wykonać niezbędne działania opisane na stronie.
• Należy pobrać wygenerowane zamówienie wraz z umową i przekazać je do podpisu.

Uwaga

Koniecznie trzeba upewnić się, że dokumenty zostaną podpisane przez osobę reprezentującą spółkę zgodnie z KRS lub przez osobę posiadającą odpowiednie pełnomocnictwo.

• W celu dalszej konfiguracji integracji z usługą e-Doręczenie należy przejść do artykułu Konfiguracja współpracy Comarch BPM z usługą e-Doręczenia

 

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.

 

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.

Kontrolka typu „Własna akcja” umożliwia uruchomienie z poziomu karty obiegu:

Na właściwościach tej kontrolki dostępne są pola:

Istnieje możliwość przekazywania parametrów dynamicznych do procedury lub programu skonfigurowanego dla kontrolki „Własna akcja”.

Parametry dynamiczne to nazwy (identyfikatory) kontrolek znajdujących się na karcie obiegu oznaczone znakami „@” na początku i na końcu nazwy.

Kontrolkę można również zainicjować kodem w języku C#. Od wersji 2024.3.0 zablokowano możliwość zmiany miejsca wykonywania skryptów C# – dostępna jest jedynie opcja Proces (exe).

Funkcjonalność obsługuje następujące kontrolki:

Kontrolka typu Własna akcja i jej właściwości

Uruchamianie plików wykonywalnych na serwerze IIS

Funkcjonalność dotyczy stacjonarnej wersji aplikacji Comarch BPM (dawniej DMS). Umożliwia operatorom uruchamianie tego samego pliku *.exe umieszczonego bezpośrednio na serwerze IIS.

Przygotowany plik *.exe, należy umieścić w katalogu \bin\exe w folderze, w którym zainstalowano aplikację webową. Konfigurując kontrolkę ‘Własna akcja’ należy w polu IIS wprowadzić nazwę i ścieżkę  do pliku, który wywoła przygotowaną aplikację.
Nazwę i ścieżkę do pliku należy wprowadzić w cudzysłowie.

Uruchamianie plików wykonywalnych

Przyklad

Przykład pokazuje definiowanie kontrolki typu Własna akcja jako plik wykonywalny w taki sposób, aby wywoływany był kalkulator systemu Windows.

 

 

Po takim zdefiniowaniu kontrolki oraz zapisaniu zmian i typu obiegu  po kliknięciu na nowym dokumencie kontrolki „Akcja” zostanie wywołany kalkulator.

 

Przyklad

Przykład pokazuje definiowanie kontrolki typu Własna akcja jako plik wykonywalny w taki sposób, aby wywoływany był notatnik.

 

 

 

Po takim zdefiniowaniu kontrolki oraz zapisaniu zmian i typu obiegu  po kliknięciu na nowym dokumencie kontrolki „Akcja” zostanie wywołany notatnik.

 

Uruchomienie procedury z bazy Comarch BPM (dawniej DMS)

Aby uruchomić procedurę z bazy Comarch BPM (dawniej DMS), należy wybrać opcję „Procedura” i w otwartym oknie wpisać zapytanie według następującego wzoru:

exec nazwaprocedury
@pierwszy parametr z procedury = @identyfikator_kontrolki@,
@drugi parametr z procedury = @identyfikator_drugiej_kontrolki@,

itd.

Przyklad

Administrator dodał cztery kontrolki:

• kontrolka typu tekst o nazwie „Nazwa działu” (identyfikator: Nazwa_dzialu)
• kontrolka typu tekst o nazwie „Nazwa działu 2” (identyfikator: Nazwa_dzialu2)
• kontrolka typu liczba całkowita o nazwie „Id spółki” (identyfikator: Id)
• kontrolkę typu Własna akcja o nazwie  „Dodaj nowy dział” (identyfikator: Akcja)

Administrator chce, aby po wpisaniu danych do kontrolek „Nazwa działu”, „Nazwa działu 2”  i  „Id spółki”, a następnie kliknięciu w przycisk „Dodaj nowy dział” został dodany nowy dział w zakładce „Działy” w strukturze organizacyjnej wybranej spółki w Comarch BPM (dawniej DMS).

W tym celu wybrał procedurę do.AddDepartment, w której potrzebne są trzy parametry: @Name1 (varchar), @Name2 (varchar) i @CompanyId (int), jak jest widoczne na poniższej ilustracji.

 

 

Po utworzeniu wspomnianych czterech kontrolek administrator we właściwościach kontrolki „Dodaj nowy dział” klika w link „Ustaw” w polu „Procedura” i w otwartym oknie wprowadza nastepujące zapytanie:

exec do.AddDepartment
@Name1 = @Nazwa_dzialu@, 
@Name2 = @nazwa_dzialu2@,
@CompanyId = @Id@

 

 

Administrator zapisuje okno i typ obiegu. Od tej pory, kiedy operator BPM (dawniej DMS) wpisze wartości w kontrolkach „Nazwa działu”, „Nazwa działu 2”  i  „Id spółki”, a później kliknie w przycisk „Dodaj nowy dział” – zostanie dodany nowy dział w zakładce „Działy” w strukturze organizacyjnej wybranej spółki w Comarch BPM (dawniej DMS).

W konfiguracji kontrolki możliwe jest włączenie komunikatu z pytaniem, czy uruchomić daną akcję, pytanie wyświetlane jest po kliknięciu w przycisk wywołujący zdefiniowaną akcję.

W konfiguracji kontrolki można również  włączyć opcję wyświetlania  określonego komunikatu po wykonaniu akcji – w tym celu należy zaznaczyć checkbox w polu „Potwierdzenie wykonania akcji” i wpisać treść komunikatu w pustym polu poniżej. Wówczas po kliknięciu w przycisk akcji i po jej wykonaniu zostanie wyświetlony komunikat o określonej treści.

Od wersji 2024.2.0 umożliwiono:

Z pobranego pliku instalacyjnego, do instalacji Comarch BPM (dawniej DMS) Repozytorium należy wykorzystać katalog z instalatorem  – Comarch BPM {numer wersji} instalator

Uwaga

W wersji 2024.2.2 w Comarch BPM (dawniej DMS) Repozytorium wprowadzono szyfrowanie connection stringów znajdujących się w pliku appsettings.json w folderze z plikami Comarch BPM (dawniej DMS) Repozytorium.

 

Wybór języka instalacji

Po uruchomieniu instalatora zostaje wyświetlone okno początkowe, w ramach którego dostępne jest pole „Język instalatora”, w którym należy dokonać wyboru języka, w jakim ma zostać przeprowadzona instalacja aplikacji. Dostępne są następujące języki:

Po wyborze języka instalacji należy nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji, okna instalacji wymaganych dodatków. Jeżeli operator naciśnie przycisk [Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony następujący komunikat:

Jeśli użytkownik wybierze przycisk:

Od wersji 2024.0.1 po przejściu do okna instalacji wymaganych dodatków wyświetlany jest komunikat, który informuje o braku możliwości instalacji Comarch BPM (dawniej DMS) w systemach wcześniejszych niż:

Po kliknięciu w przycisk [OK] instalator zostaje zamknięty.

Okno przygotowania komponentów

W kolejnym kroku instalatora zostaje wyświetlone okno, informujące o tym, że instalator przygotowuje potrzebne komponenty. Przejście do następnego okna nastąpi automatycznie.

W następnym kroku instalatora wyświetlone zostaje okno powitalne instalatora.

Okno powitalne instalatora

Jeżeli użytkownik chce kontynuować instalację, wówczas powinien nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji. Jeżeli operator naciśnie przycisk [Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony komunikat analogiczny do przedstawionego powyżej.

Wybór aplikacji

Po przejściu do okna Wybór aplikacji należy wybrać opcję Instalacja aplikacji Comarch BPM oraz Comarch BPM Repozytorium.

Uwaga

Jeżeli użytkownik nie ma zainstalowanego serwera MongoDB, a chce korzystać z modułu Comarch BPM (dawniej DMS) Repozytorium, wówczas przed przystąpieniem do tworzenia aplikacji Comarch BPM (dawniej DMS) Repozytorium powinien wybrać opcję Instalacja serwera MongoDB i kliknąć [Dalej]. Dalsze kroki opisano w rozdziale Instalacja serwera Mongo DB za pomocą instalatora Comarch BPM .

Po kliknięciu przycisku [Dalej] użytkownik przechodzi do okna „Wybór aplikacji cd.”.

Wybór aplikacji cd.

W ramach okna „Wybór aplikacji cd.” operator może wybrać jedną z trzech opcji:

Jeżeli operator chce zainstalować tylko aplikację Comarch BPM (dawniej DMS) Repozytorium do wybranej aplikacji Comarch BPM (dawniej DMS) – wówczas powinien zaznaczyć opcję „Instalacja Comarch BPM Repozytorium” i nacisnąć [Dalej].

Warunki korzystania z oprogramowania

Po kliknięciu przycisku [Dalej] następuje przejście do okna Warunki korzystania z oprogramowania, gdzie należy zapoznać się z warunkami korzystania z oprogramowania Comarch BPM, zaznaczyć checkbox „Akceptuję warunki instalacji” i nacisnąć   [Dalej], aby przejść do kolejnego etapu – przycisk nie jest aktywny, jeśli nie została zaznaczona zgoda na warunki instalacji.

Internetowe usługi informacyjne (IIS)

W kolejnym oknie Internetowe usługi informacyjne (IIS) następuje weryfikacja, czy na danym komputerze dostępny jest serwer IIS. Jeżeli:

Serwer IIS nie jest dostępny – wyświetlana jest informacja „ Serwer IIS nie jest dostępny na tym komputerze” i nie jest możliwe przejście do kolejnego etapu instalacji.

W takim wypadku użytkownik może:

Po zastosowaniu jednego z powyższych sposobów możliwe będzie przejście do kolejnego kroku instalacji aplikacji web Comarch BPM za pomocą przycisku [Dalej]

Serwer IIS jest dostępny – wyświetlana jest informacja „ Serwer IIS został poprawnie zainstalowany” i należy przejść do kolejnego kroku, klikając przycisk [Dalej].

Wymagane dodatki

Po kliknięciu przycisku [Dalej], następuje przejście do następnego okna, w ramach którego następuje instalacja dodatków wymaganych dla poprawnego działania Comarch BPM.

W ramach pola dostępnego w prawej części okna dostępne są następujące kolumny:

Aby zainstalować wymagane dodatki i przejść do następnego okna należy nacisnąć przycisk [Dalej].

Pula aplikacji Comarch BPM Repozytorium

W ramach okna „Pula aplikacji Comarch BPM Repozytorium” należy określić, na jakiej puli aplikacji ma pracować aplikacja Comarch BPM (dawniej DMS) Repozytorium– w tym celu należy:

Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji , klikając przycisk   [Dalej].

Kreowanie aplikacji Repozytorium

Następnie w dodanym w wersji 2024.2.0 oknie Kreowanie aplikacji Repozytorium następuje konfiguracja aplikacji dla modułu Comarch BPM (dawniej DMS) Repozytorium.

Uwaga

W wersji 2024.2.2 w Comarch BPM (dawniej DMS) Repozytorium wprowadzono szyfrowanie connection stringów znajdujących się w pliku appsettings.json w folderze z plikami Comarch BPM Repozytorium.

 

W ramach okna Kreowanie aplikacji Repozytorium użytkownik:

Uwaga

W wersji 2025.2.0 wprowadzono walidację dodawanych nazw aplikacji w instalatorze. Jeśli we wprowadzonej nazwie aplikacji znajduje się co najmniej jeden z następujących znaków:

•  :
• /
• ?
• #
• [
• ]
• @
• !
• $
• &
• ’
• (
• )
• *
• +
• ,
• ;
• =
• <
• >
• „
• {
• }
• |
• \
•  ^
•  `
• Spacja

Wówczas w oknie instalatora zostanie wyświetlony komunikat „Nazwa aplikacji jest niepoprawna. Znak <znak> nie jest dozwolony.”.

W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Nazwa aplikacji” tak, aby nie zawierała już niedozwolonych znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].

Następnie należy kliknąć przycisk   [Utwórz aplikację], aby nowa aplikacja została utworzona. Podczas tworzenia aplikacji w dolnej części okna widoczna jest informacja „Trwa kreowanie aplikacji”. Jeżeli utworzenie aplikacji przebiegło pomyślnie, wówczas wyświetlana jest informacja „Aplikacja została utworzona pomyślnie”. Przycisk   [Utwórz aplikację] nie jest aktywny do czasu wybrania witryny i wpisania nazwy aplikacji przez użytkownika.

Operator ma również opcję dodania nowej witryny, na której utworzy aplikację Comarch BPM (dawniej DMS) Repozytorium, jednakże zaleca się, aby aplikację Comarch BPM (dawniej DMS) Repozytorium zainstalować na tej samej witrynie, na której zainstalowano moduł Workflow Comarch BPM (dawniej DMS).

Aby jednak utworzyć nową witrynę operator powinien:

Następnie operator powinien nacisnąć przycisk   [Utwórz witrynę]. Jeśli tworzenie witryny zakończyło się powodzeniem, wówczas w dolnej części okna wyświetlany jest napis Witryna została utworzona na serwerze IIS.

Po kliknięciu  [Dalej] następuje przejście do okna „Witryny i aplikacje Comarch BPM”.

Witryny i aplikacje Comarch BPM

W ramach okna operator powinien:

Kiedy operator wskazał witryny i aplikacje, a następnie kliknął przycisk  [Dalej], wówczas następuje weryfikacja zgodności wersji wybranych aplikacji Comarch BPM (dawniej DMS) z wersją modułu Comarch BPM (dawniej DMS) Repozytorium, która jest instalowana.

Jeżeli weryfikacja wykaże, że wersje nie są zgodne, wówczas zostanie wyświetlony następujący komunikat:

Gdy operator kliknie przycisk [OK], okno komunikatu zostanie zamknięte, a w ramach okna „Witryny i aplikacje Comarch BPM” konieczne będzie dokonanie wyboru odpowiednich aplikacji Comarch BPM .

Jeśli weryfikacja zgodności wersji wybranych aplikacji Comarch BPM (dawniej DMS) z wersją modułu Comarch BPM (dawniej DMS) Repozytorium zakończyła się powodzeniem, wówczas po kliknięciu przycisku  [Dalej] następuje przejście do okna „Baza danych Comarch BPM Repozytorium”.

Baza danych Comarch BPM Repozytorium

astępnie w ramach okna „Baza danych Comarch BPM Repozytorium” operator powinien uzupełnić:

Następnie należy sprawdzić poprawność wprowadzonych danych, klikając w przycisk [Połącz].

Jeśli próba nawiązania połączenia zakończyła się powodzeniem, w dolnej części okna wyświetlony zostaje napis „Nawiązano połączenie z serwerem MongoDB”.

W wersji 2025.1.0 w ramach instalatora Comarch BPM (dawniej DMS) dodano następujące komunikaty, które mogą zostać wyświetlone po uzupełnieniu pól „Nazwa serwera”, „Login” i „Hasło”, a następnie po kliknięciu [Połącz] w oknie „Baza danych Comarch BPM Repozytorium”:

• „Wprowadzono nieprawidłowy adres serwera” – komunikat wyświetlany, jeśli w polu „Nazwa serwera” wprowadzono niewłaściwy adres serwera.

 

 

• „Wprowadzono nieprawidłowe dane logowania” – komunikat wyświetlany, jeśli w polu „Login” i/lub „Hasło” wprowadzono niewłaściwe dane

Gdy połączenie zostało nawiązane, wówczas operator powinien wybrać bazę w ramach pola „Lista baz danych” (jeśli wcześniej przygotowano bazę przeznaczoną dla Comarch BPM (dawniej DMS) Repozytorium) albo nacisnąć przycisk [Dodaj bazę], aby utworzyć nową bazę danych dla aplikacji Comarch BPM Repozytorium.

Jeżeli operator kliknął w przycisk [Dodaj bazę], wówczas zostaje otwarte okno w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch BPM Repozytorium, a następnie kliknąć  [Zapisz]. Jeżeli użytkownik nie chce jednak dodać nowej bazy, wtedy powinien nacisnąć przycisk   [Anuluj] albo znak X.

Po naciśnięciu przycisku   [Zapisz] baza Comarch BPM (dawniej DMS) Repozytorium zostaje dodana i w ramach instalatora wyświetla się informacja „Baza danych została utworzona”.

Następnie operator powinien nacisnąć przycisk [Zmień hasło].

W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser serwera MongoDB, za którego pośrednictwem będzie odbywać się komunikacja aplikacji Comarch BPM (dawniej DMS) Repozytorium z bazą danych. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

Hasło powinno spełniać następujące warunki:

Jeżeli wpisano hasło, które nie spełnia któregoś z tych czterech wymagań, wówczas po kliknięciu przycisku   [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

• • • Jeśli hasło jest za krótkie

 

• • • Brakuje warunku/warunków wymaganych dla silnego hasła (brak znaku specjalnego, brak wielkiej litery)

Należy zmienić hasło, tak, aby spełniało wszystkie warunki.

Jeśli natomiast hasło wpisane w polu „Powtórz hasło” różni się od hasła wpisanego w polu „Hasło”, wtedy po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

Należy uzupełnić pole „Powtórz hasło” tak, aby zgadzało się z polem „Hasło”.

Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk   [Zapisz], okno zmiany hasła dla MongoUsera zostaje zamknięte, a hasło użytkownika MongoUser zostaje zmienione. Następnie operator powinien kliknąć  [Dalej].

Po kliknięciu w przycisk  [Dalej] następuje przejście do okna „Klucze licencji”.

Klucze licencji

W ramach okna operator powinien uzupełnić:

W wersji 2025.2.0 w ramach instalatora dodano opcję utworzenia użytkownika CDNHASPDMS, wygenerowania dla niego hasła oraz nadania mu uprawnień do procedur HASP. Nowy użytkownik CDNHASPDMS ma dostęp do następujących procedur HASP:

Dane użytkownika CDNHASPDMS zostają zaszyfrowane i zapisane; służą jedynie do komunikacji z serwerem, na którym znajduje się Menadżer Kluczy.

W instalatorze w ramach okna „Klucze licencji” dodano przycisk „Weryfikuj”. Poniżej opisano możliwe warianty dalszego postępowania, w zależności od tego, czy baza Comarch BPM i klucze licencji znajdują się na tym samym, czy na różnych serwerach.

Wariant 2

W ramach okna „Baza danych Comarch BPM” wybrano bazę, która znajduje się na serwerze 1, a w oknie „Klucze licencji” wprowadzono klucz/ licencji, który znajduje się na serwerze 2 (dotyczy instalacji Comarch BPM Standalone

Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji” zostanie wyświetlone okno logowania do serwera, które pozwoli na podanie loginu i hasła użytkownika z uprawnieniami administratora do serwera oraz na sprawdzenie połączenia – po kliknięciu w przycisk „Połącz” informacja o rezultacie próby połączenia z serwerem będzie widoczna w oknie logowania do serwera. Jeśli próba połączenia zakończy się pomyślnie, należy kliknąć w przycisk „Zapisz”.

 

 

Następnie jeśli:

• Nawiązano połączenie – w przypadku, gdy użytkownik istnieje już na serwerze, zostaje utworzony login CDNHASPDMS[numer] (z pierwszym wolnym numerem loginu CDNHASPDMS) – dla loginu zostaje nadane nowo wygenerowane hasło i sprawdzone są uprawnienia HASP. W przypadku, jeśli:
  • Uprawnienia do procedur HASP znajdują się na serwerze klucza licencji – wówczas zostaną nadane loginowi CDNHASPDMS[numer] (gdzie numer – to pierwszy wolny numer, licząc od 1); następnie należy kontynuować instalację Comarch BPM, klikając w przycisk „Instaluj”;
  • Uprawnienia do procedur HASP nie znajdują się na serwerze klucza licencji – wówczas nowy login nie zostanie utworzony i zostanie wyświetlony komunikat Na serwerze nie zainstalowano procedur niezbędnych do komunikacji z Menadżerem Kluczy. Sprawdź instalację Menadżera Kluczy, a następnie uruchom ponownie instalator Comarch BPM. Kliknij Zakończ, aby zakończyć pracę instalatora. Po kliknięciu w przycisk „Zamknij”, dostępny w ramach komunikatu, okno instalatora zostanie zamknięte;
• Nie nawiązano połączenia – zostaje wyświetlony komunikat informujący o błędzie. Operator może wielokrotnie podejmować próbę logowania do serwera. ale po zamknięciu okna logowania do serwera instalacja zostanie przerwana.

Instalacja

Po uzupełnieniu pól w ramach okna "Klucze licencji" operator powinien kliknąć [Instaluj]. Następuje wówczas przejście do kolejnego okna „Instalacja”.

Koniec pracy instalatora

Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji. Gdy użytkownik kliknie przycisk   [Zakończ], instalator zostanie zamknięty, natomiast zostanie otwarta przeglądarka na ekranie logowania do nowej aplikacji WEB Comarch BPM (dawniej DMS), zgodnie z nazwą aplikacji, którą wybrano w instalatorze.

Dalsze kroki dotyczące konfiguracji Comarch BPM (dawniej DMS) Repozytorium należy wykonać w ramach aplikacji desktop Comarch BPM (dawniej DMS) , a następnie w zakładce [Repozytorium] w aplikacji web Comarch BPM (dawniej DMS) (zob. Repozytorium – konfiguracja początkowa dla administratora).

Zastosowanie

Dzięki zastosowaniu tej konfiguracji, proces obiegu faktur kosztowych zyskuje pełną automatyzację. Głównym celem jest eliminacja ręcznego wprowadzania pozycji dokumentów — dane zaczytane przez Comarch OCR są automatycznie mapowane i wypełniają kontrolkę tabelaryczną na kacie obiegu. W efekcie skracamy czas obsługi faktury, minimalizujemy błędy przepisywania i zapewniamy, że proces akceptacji bazuje na poprawnych i spójnych danych przed ich zaksięgowaniem.

Zawartość przykładu

• Definicja Typu Obiegu (Workflow): Wzorcowa ścieżka obiegu dokumentu kosztowego z krokami akceptacji, konfiguracją kontrolki Dane tabelaryczne i wygenerowaniem dokumentu do Comarch ERPXL
• Punkt konfiguracyjny ACD: Wzorcowa konfiguracja, która jest odpowiedzialna za pobranie ID dokumentu OCR, Załącznika oraz wszystkich kluczowych danych nagłówkowych (NIP, Kontrahent, Dane kontrahenta, Data zakupu, Data wystawienia, Termin płatności, Forma płatności, Waluta) oraz inicjację dokumentu obiegowego.

 

Kliknij tutaj, aby pobrać przykład

 

Zasada działania

Mechanizm opiera się na pobieraniu danych z bazy Comarch BPM, które zostały zapisane po przetworzeniu ich przez Comarch OCR w punkcie ACD.

• Konfiguracja wykorzystuje ID dokumentu OCR (zapisane w dedykowanej kontrolce typu Liczba całkowita) jako identyfikator do pobrania danych. Kontrolka tabelaryczna obserwuje to pole, reagując na jego wypełnienie.
• Kluczowym elementem jest zapytanie SQL umieszczone na zakładce Inicjowanie Wartości kontrolki tabelarycznej. Zapytanie jest filtrowane za pomocą parametru @ID_OCR@, dzięki czemu pobiera ono wiersze z właściwego dokumentu OCR z tabeli do.OC_Document_Items w bazie BPM.
• Na podstawie zwróconych wierszy z tabeli do.OC_Document_Items, kontrolka Dane tabelaryczne jest automatycznie wypełniana pozycjami faktury (Nazwa, Cena, Ilość, Jednostka miary, Netto, Stawka VAT, Brutto, Kwota VAT).
• W zapytaniu SQL zawarta jest niezbędna logika CASE WHEN, która konwertuje wartości tekstowe (np. Stawki VAT oraz Jednostki miary) na identyfikatory liczbowe, których BPM wymaga do poprawnego działania mechanizmów systemowych i wyświetlania danych.

 

Konfiguracja przykładu

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

 

 

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

• ”Nazwa” (identyfikator kolumny: Nazwa) – typ Tekst
• ”Cena” (identyfikator kolumny: Cena) – typ Liczba stałoprzecinkowa
• ”Ilość” (identyfikator kolumny: Ilosc) – typ Liczba stałoprzecinkowa
• ”Jednostka miary” (identyfikator kolumny: JM) – typ Lista
• ”Netto” (identyfikator kolumny: Netto) – typ Liczba stałoprzecinkowa
• ”Stawka VAT” (identyfikator kolumny: StawkaVAT) – typ Lista
• ”Brutto” (identyfikator kolumny: Brutto) – typ Liczba stałoprzecinkowa
• ”Kwota VAT” (identyfikator kolumny: KwotaVAT) – typ Liczba stałoprzecinkowa

 

 

3. W kontrolce typu Dane tabelaryczne  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 typu Dane tabelaryczne, na zakładce Inicjowanie wartości, dodano powiązanie do kontrolki ID_OCR.

5.Zapytanie SQL: W kontrolce typu Dane tabelaryczne, na zakładce Inicjowanie wartości w sekcji Wzór na wartość SQL OD dodano zapytanie, które pobiera dane z tabel do.OC_Document_Items oraz do.OC_Documents na podstawie przekazanego parametru @ID_OCR@ (ID dokumentu OCR). W zapytaniu SQL konieczne jest użycie logiki CASE WHEN do konwersji wartości tekstowych jednostek miary (’szt’) i stawek VAT (np. '23.00′) na odpowiednie identyfikatory liczbowe akceptowane przez Comarch BPM.

If @^SenderControlName@ = 'ID_OCR'

Begin

Select

ODI_Name,/*Nazwa*/

ODI_NetUnitPrice, /*Cena netto*/

ODI_Count, /*Ilość*/

CASE

WHEN ODI_Unit='szt.' THEN 1

WHEN ODI_Unit='l' THEN 2

WHEN ODI_Unit='kg' THEN 3

Else 0

END, /*Jednostka miary*/

ODI_NetValue, /* Wartość Netto*/

CASE

WHEN ODI_VatRate='23.00' THEN 1

WHEN ODI_VatRate='8.00' THEN 2

WHEN ODI_VatRate='0.00' THEN 3

WHEN ODI_VatRate='5.00' THEN 7

Else 0

END,

ODI_GrossValue, /*Wartość Brutto*/

[ODI_GrossValue]-[ODI_NetValue], -- kwota VAT

1

from do.OC_Document_Items I

join do.OC_Documents D on D.OCD_Id=I.ODI_DocumentId

where ODI_DocumentId=@ID_OCR@

END

6.Punkt ACD: W punkcie konfiguracyjnym ACD (Współpraca z Comarch OCR), wykorzystywanym do inicjowania obiegu, na zakładce Kontrolki dodano kontrolkę ID_OCR i przypisano jej odpowiednie zapytanie:

select @Id1@

Uzupełniona Kontrolka Dane Tabelaryczne

Po pomyślnym zainicjowaniu dokumentu z punktu ACD, kontrolka typu Dane Tabelaryczne została automatycznie wypełniona. Dla każdej pozycji dokumentu (faktury) odczytanej przez Comarch OCR i zapisanej w tabeli do.OC_Document_Items, na formularzu BPM pojawił się oddzielny, kompletny wiersz z uzupełnionymi danymi.