Kopiowanie zawartości katalogu BPM Workflow Api

W pobranym pliku instalacyjnym należy wejść do katalogu ComarchBPM {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 bazie Comarch ERP XL.

Uruchamianie skryptów na bazie Comarch BPM

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

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 bazie Comarch ERP XL

Analogiczny scenariusz należy wykonać dla katalogu BPM Workflow Api \ SqlXL w tej samej lokalizacji, z tą różnicą, że zamiast nazwy bazy danych Comarch BPM należy podać nazwę bazy Comarch ERP XL, a zamiast Install.bat – InstallXL.bat.

Lokalizacja pliku:

katalog z plikami instalacyjnymi \ Comarch BPM {wersja} \ BPM Workflow Api \ SqlXL \ InstallXL.bat

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

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 InstallXL.bat – np. C:\inetpub\wwwroot\BPMWeb\SqlXL – a następnie nacisnąć Enter.

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

InstallXL.bat <nazwa_serwera> <nazwa_bazy_Comarch_ERP_XL>

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

 

 

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

 

Sposób 2

W katalogu BPM Workflow Api\SqlXL należy odnaleźć plik InstallXL.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_ERP_XL

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

 

 

Później należy kliknąć prawym przyciskiem myszki na plik InstallXL.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.

 

 

Uwaga

Skrypty na bazie Comarch BPM oraz bazie Comarch ERP XL mogą być uruchamiane wielokrotnie.

 

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 katalogu 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\dms202311\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.

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

 

 

Wskazówka

Zalecana jest reindeksacja bazy przy aktualizacji aplikacji Comarch BPM.

 

Weryfikacja poprawności konfiguracji aplikacji serwerowej

Poprawność instalacji można zweryfikować poprzez uruchomienie skonfigurowanej aplikacji serwerowej i zalogowanie się na użytkownika.

 

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).

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\BPMWeb\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.

 

 

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 katalogu 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\dms202311\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.

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

 

 

Wskazówka

Zalecana jest reindeksacja bazy przy aktualizacji aplikacji Comarch BPM.

 

Weryfikacja poprawności konfiguracji aplikacji serwerowej

Poprawność instalacji można zweryfikować poprzez uruchomienie skonfigurowanej aplikacji serwerowej i zalogowanie się na użytkownika.

 

 

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

W katalogu DMS 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\BPMWeb\Sql – a następnie nacisnąć Enter.

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

Install.bat <nazwa_serwera> <nazwa_bazy>

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 Altum

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

Lokalizacja plików:

 

katalog z plikami instalacyjnymi \ Comarch BPM {wersja} \ BPM Workflow Api  \ SqlAltum \ InstallAltumComp.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 InstallAltumConf.bat – np. C:\inetpub\wwwroot\BPMWeb\SqlAltum – a następnie nacisnąć Enter.

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

InstallAltumConf.bat <nazwa_serwera> <nazwa_bazy_konfiguracyjnej_Comarch_ERP_Altum>

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

 

 

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

InstallAltumComp.bat <nazwa_serwera> <nazwa_bazy_firmowej_Comarch_ERP_Altum>

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

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

 

 

Przyklad

Sposób 2

W katalogu BPM Workflow Api \SqlAltum należy odnaleźć plik InstallAltumConf.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_Altum

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

 

 

Później należy kliknąć prawym przyciskiem myszki na plik InstallAltumConf.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 DMS Workflow Api \SqlAltum należy odnaleźć plik InstallAltumComp.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_Altum

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

 

 

Później należy kliknąć prawym przyciskiem myszki na plik InstallAltumComp.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 katalogu 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\dms202311\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.

 

 

Wskazówka

Zalecana jest reindeksacja bazy przy aktualizacji aplikacji Comarch BPM (dawniej DMS).

 

Weryfikacja poprawności konfiguracji aplikacji serwerowej

Poprawność instalacji można zweryfikować poprzez uruchomienie skonfigurowanej aplikacji serwerowej i zalogowanie się na użytkownika.

 

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.

 

 

Wskazówka

Zalecana jest reindeksacja bazy przy aktualizacji aplikacji Comarch BPM (dawniej DMS).

 

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.

Uwaga

Komunikat nie jest wyświetlany jeśli w pliku Web.config w folderze z plikami aplikacji serwerowej <add key=”LegacyDocumentManagerAccess” value=”true” /> (zob. Dodanie klucza „LegacyDocumentManagerAccess” – umożliwienie dostępu do Menadżera dokumentów z aplikacji serwerowej) .

 

 

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.

 

 

 

Wskazówka

Istnieje możliwość zmiany numeracji dla dokumentów z numeracji w obrębie miesiąca na numerację w obrębie roku – aby zobaczyć, w jaki sposób, przejdź do artykułu Czy można przestawić numerację dla dokumentów z numeracji w obrębie miesiąca na numerację w obrębie roku?

 

 

 

- sekcja dokumentu. Każda utworzona na dokumencie sekcja może być zwinięta lub rozwinięta – sposób prezentacji sekcji uzależniony jest od ustawienia parametru ‘Prezentacja sekcji’ w panelu użytkownika w aplikacji desktop (zob. Szczegóły dokumentu ).

 

[Zapisz] – funkcjonalność zapisu zmian lub zatwierdzenia nowododanej pozycji:

[Do przekazania] – ikona przenosi dokument do okna "Przekazanie".

 

Przykładowe kontrolki

- kontrolka typu liczba (Liczba rzeczywista/Liczba całkowita/ Liczba stałoprzecinkowa). Wartości wprowadzane są ręcznie przez operatora lub pochodzą z zapytania SQL lub C# zdefiniowanego na formatce Inicjowanie lub Wzór na wartość w aplikacji desktop.

 

- kontrolka typu tekst (zob. Tekst). Wartości wprowadzane są ręcznie przez operatora lub pochodzą z zapytania SQL lub C# zdefiniowanego na formatce Inicjowanie lub Wzór na wartość w aplikacji desktop.

- kontrolka typu data i godzina (zob. Data i godzina). Operator może zmienić datę klikając w pole kontrolki - zostanie wówczas otwarte okno, w którym należy:

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.

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

- kontrolka typu Dokument elektroniczny z danymi zaczytanymi z programu Comarch ERP XL (zob. Dokument elektroniczny). Przycisk wywołuje listę ofert zakupu, użytkownik ma możliwość podglądu szczegółów dokumentu oraz zmiany dokumentu na inny. Przycisk odpina dokument elektroniczny z kontrolki.

 

- kontrolka typu załącznik (zob. Załącznik). Prezentowana jest nazwa załącznika,  ikona umożliwiająca usunięcie pliku oraz ikona zapisu załącznika na dysk.

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.