Instalacja początkowa Comarch BPM i instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym

Spis treści artykułu

• Konfiguracja Menedżera Internetowych Usług Informatycznych (IIS)
• Przygotowanie baz danych
• Konfiguracja pliku web.config
• Uruchamianie skryptów
• Zaprogramowanie klucza HASP za pomocą instalatora
• Reindeksacja bazy
• Weryfikacja poprawności konfiguracji aplikacji serwerowej

Konfiguracja Menedżera Internetowych Usług Informatycznych (IIS)

Do instalacji aplikacji Comarch BPM (dawniej DMS) wymagane jest posiadanie dodatku Microsoft .Net Framework w wersji 4.7.2  lub wyższej (zalecana 4.8) oraz zainstalowanie serwera IIS.
Po zainstalowaniu serwera IIS, należy włączyć następujące komponenty:

• Konsola zarzadzania usługami IIS
• Narzędzia i skrypty zarządzania usługami IIS
• Usługa zarządzania usługami IIS
• ASP
• Filtry ISAPI
• Błędy HTTP
• Dokument domyślny
• Przeglądanie katalogów
• Zawartość statyczna
• Filtrowanie żądań
• ASP .NET
• Rozszerzalność architektury .NET

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch BPM (dawniej DMS) {wersja} i  przekopiować zawartość katalogów BPM Workflow API i BPM Web do dwóch oddzielnych nowoutworzonych folderów na dysku C:\inetpub\wwwroot.

Nazwy folderów będą zarazem nazwami aplikacji webowych uruchamianych poprzez przeglądarkę, tzn:

• aplikacji serwerowej – dawnej aplikacji webowej – w tym przypadku jest to BPMApi;
• aplikacji web – nowej aplikacji webowej – w tym przypadku jest to BPMWeb

Uwaga

Lokalnemu użytkownikowi IUSR należy nadać uprawnienie do katalogu BPMApi.

Nadawanie uprawnień do katalogu BPMApi lokalnemu użytkownikowi IUSR

Po uruchomieniu Menedżera Internetowych Usług Informatycznych należy podświetlić nazwę serwera i przejść do opcji „Ograniczenia ISAPI i CGI”.

Okno Menadżer internetowych usług informatycznych (IIS)

Dla wpisów z Framework ASP.NetV4.0.* należy wybrać z menu kontekstowego opcję „Zezwalaj”.

Okno Ograniczenia ISAPI i CGI

W kolejnym kroku należy dodać/wybrać pule aplikacji, na których będą uruchamiane aplikacje Comarch BPM (dawniej DMS). Nowe pule aplikacji dodajemy klikając prawym przyciskiem myszy na kategorię „Pule aplikacji”.

Uwaga

Od wersji 2025.0.0 dla aplikacji serwerowej i dla aplikacji WEB wymagane jest skonfigurowanie osobnych pul aplikacji

Wybór puli dla aplikacji

Pojawi się okno dodawania puli aplikacji. Należy wpisać w nim nazwę puli dla aplikacji serwerowej, np. „BPMapi” i wybrać wersję .NetFramework v4.0 lub wyższą, a następnie ustawić „Zarządzany tryb potokowy” na Zintegrowany i zaznaczyć opcję „Uruchom pulę aplikacji natychmiast”.

Okno „Dodawanie puli aplikacji” dla aplikacji serwerowej

Następnie w kolejnym oknie dodawania puli należy wpisać nazwę puli dla aplikacji WEB, np. „BPMweb” i wybrać wersję Net Framework v4.0 lub wyższą, a następnie ustawić „Zarządzany tryb potokowy” na Zintegrowany i zaznaczyć opcję „Uruchom pulę aplikacji natychmiast”.

Okno „Dodawanie puli aplikacji” dla aplikacji WEB

Dla wybranych pul należy skonfigurować ustawienia zaawansowane.

Ustawienia zaawansowane

Pojawi się okno, w którym w przypadku każdej puli należy ustawić opcję „Włącz aplikacje 32-bitowe” jako False, natomiast jako „Tożsamość” należy ustawić opcję „ApplicationPoolIdentity”, a następnie sprawdzić czy pozostałe parametry zostały ustawione jak poniżej.

Ustawienia zaawansowane – wzór

Następnie należy skonwertować katalogi BPMApi (katalog, do którego skopiowano pliki z folderu BPM Workflow Api z pakietu instalacyjnego)  i BPMWeb (katalog, do którego skopiowano pliki z folderu BPM Web z pakietu instalacyjnego) na aplikacje i przypisać do nich utworzoną pulę (lub, od wersji 2025.0.0, utworzone pule).

Konwertowanie katalogu BPMApi na aplikację

Konwertowanie katalogu BPMWeb na aplikację

Uwaga

Konieczne jest, aby aplikacje: serwerowa i web znajdowały się na tej samej witrynie.

Uwaga

Zalecana jest instalacja Comarch BPM jako aplikacji w witrynie (np. w witrynie Default Web Site) , a nie jako odrębnej witryny.

Okno dodawania aplikacji BPMApi

Okno dodawania aplikacji BPMWeb

Przygotowanie baz danych

W kolejnym kroku instalacji należy przygotować bazę danych dla aplikacji Comarch BPM (dawniej DMS) oraz Comarch ERP XL.

Aplikacja może pracować na dwóch odrębnych bazach danych (baza Comarch BPM i baza ERP XL) lub na jednej wspólnej bazie (baza ERP XL). Poniżej został przedstawiony przykład instalacji z wykorzystaniem dwóch baz.

Aby utworzyć nową bazę danych Comarch BPM, należy uruchomić program Microsoft SQL Server Management Studio i za pomocą opcji New Database wykreować nową bazę.

Pojawi się okno, w którym należy podać nazwę bazy danych.

Tworzenie bazy w Microsoft SQL Serwer Management Studio

Konfiguracja pliku web.config

Uwaga

Comarch BPM (dawniej DMS) może pracować w trybie jednofirmowym lub wielofirmowym. Niektóre ustawienia pliku Web.config w trybie wielofirmowym są nieużywane i nie ma potrzeby ich definiowania. Tryb pracy (jedno/wielofirmowy) ustawiany jest w kluczu .

W pliku konfiguracyjnym Web.config znajdującym się w katalogu C:\inetpub\wwwroot{nazwa aplikacji serwerowej} należy wprowadzić następujące informacje:

Definicje connection stringów używane w obu trybach:

• W kluczu „strConnectDMS” należy wprowadzić connection string do bazy danych Comarch BPM (dawniej DMS);
• W kluczu „strConnectKeyManagerServer”,
• dodanym w wersji 2025.2.0, nie należy wprowadzać danych ręcznie – w ramach klucza zapisane są dane użytkownika CDNHASPDMS służące jedynie do komunikacji z serwerem, na którym znajduje się Menadżer Kluczy – klucz zostaje zmodyfikowany i zaszyfrowany podczas instalacji lub aktualizacji Comarch BPM za pomocą instalatora; w przypadku ręcznej instalacji Cmarch BPM należy skorzystać z opcji „Tworzenie użytkownika CDNHASPDMS na serwerze Menadżera Kluczy” (od wersji 2026.0.0 z opcji „Programowanie klucza HASP na serwerze Menadżera Kluczy”) w instalatorze Comarch BPM (zob. Zaprogramowanie klucza HASP za pomocą instalatora);

Definicje connection stringów używane w trybie jednofirmowym:

• W kluczu „strConnectERPComp” należy wprowadzić connection string do bazy Comarch ERP XL lub bazy firmowej Comarch ERP Optima / Comarch ERP Altum. Klucz jest wymagany do poprawnego działania integracji. Wprowadzenie klucza nie jest wymagane, jeżeli Comarch BPM (dawniej DMS) pracuje w trybie wielospółkowym.
• W kluczu „strConnectERPConf1” należy wprowadzić connection string do bazy konfiguracyjnej Comarch ERP Optima lub Comarch ERP Altum. Klucz ten jest wymagany po poprawnego działania integracji Comarch BPM (dawniej DMS) z Comarch ERP Optima lub Comarch ERP Altum. Klucz jest również wymagany w trybie chmurowym Comarch ERP Optima. Wprowadzenie klucza nie jest konieczne w przypadku pracy Comarch BPM (dawniej DMS) w trybie wielofirmowym.

Definicje connection stringów używane w trybie wielofirmowym:

• • Klucze „strConnectERPConf2”, „strConnectERPConf3” itd. mogą być używane w trybie chmurowym Comarch ERP Optima. Poprzez wprowadzenie connection stringów możliwe jest dodanie kilku baz konfiguracyjnych, które dostępne będą w Comarch BPM (dawniej DMS) w oknie definiowanie połączeń spółki z bazą ERP.

Uwaga

Od wersji 2024.0.0 instalator szyfruje connection strings w pliku Web.config w katalogu aplikacji serwerowej (dawnej web).

Ustawienia kluczy używane w obu trybach:

• – parametr określający numer wersji Comarch BPM (dawniej DMS).
• – parametr dodany w wersji 2025.0.0; usunięty od wersji 2025.2.0; od tego parametru jest zależna nazwa systemu wyświetlana w aplikacjach (zob. Zmiana nazwy systemu w zależności od rynku, na którym będzie sprzedawany ). Parametr może przyjmować następujące wartości:
• ”PL” – w takim przypadku produkt jest dedykowany na rynek polski – w systemie wyświetlane są nazwy „Comarch DMS” i „Repozytorium”
• ”Other” – w takim przypadku produkt jest dedykowany na rynki inne niż polski – w systemie wyświetlane są nazwy „Comarch BPM” i „Archive”
• – określenie współpracy Comarch BPM (dawniej DMS) z systemami ERP,
• • • • dla Comarch ERP Optima – wartość = „Optima”, - dla Comarch ERP XL – wartość = „XL”, - dla Comarch ERP Altum – wartość = „Altum”, - bez współpracy z systemem EPR – wartość = „Standalone”.
• – ustawienie trybu pracy jednofirmowy (false) i wielofirmowy (true).
• – definicja maksymalnej liczby kolumn karty obiegu, która będzie dostępna w konfiguracji typu obiegu.
• – klucz odpowiada za dostęp do funkcjonalności modelowania procesów w Comarch BPM (dawniej DMS) za pomocą kodu w języku C# (w tym do automatycznego trybu pracy – robotyzacji procesów) oraz za dostęp do obsługi pobierania i wysyłki wiadomości z usługi e-Doręczenia . Wartość „true” – funkcjonalność dostępna, wartość „false” – funkcjonalność niedostępna.
• – należy wpisać nazwę serwera licencji dla aplikacji Comarch BPM (dawniej DMS).
• – wartość „true” włącza możliwość wyboru języka pracy aplikacji Comarch BPM (dawniej DMS) w oknie logowania. Wartość „false” wyłącza tą możliwość.
• – wartość „true” wymusza stosowanie polityki mocnych haseł przez operatorów Comarch BPM (dawniej DMS)(min 8 znaków, wielka litera, znak specjalny).
• – wartość „true” klucza umożliwia rejestrowanie użytkowników z poziomu aplikacji web i aktywuje funkcje wpisywane do tabeli do.DF_ConfOSEmployeesQueue – tabeli z danymi rejestracji użytkowników. Okno rejestracji można wyświetlić po dodaniu do adresu aplikacji członu „/ExternalRegistration”, np. http://localhost/DMS/ExternalRegistration. Wartość klucza = „false” oznacza, że rejestracja użytkowników w aplikacji web jest niemożliwa.
• • • • – klucz określa, czy użytkownik będzie musiał podać NIP podczas rejestracji. Wartość „true” oznacza konieczność podania NIP, wartość „false” oznacza brak konieczności. - – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję regulamin oraz zapoznałem się z informacją o przetwarzaniu danych osobowych”. Wartość „true” spowoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Tekst regulaminu i informacji o przetwarzaniu danych osobowych należy wprowadzić odpowiednio do plików Rules_pl.txt i gdpr_pl.txt znajdujących się w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji. - – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję warunki pracy”. Wartość „true” powoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Treść informacji o warunkach pracy należy wprowadzić do pliku workingConditions_pl.txt w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.

Rejestracja użytkownika w DMS z poziomu aplikacji web, gdy parametr „TaxPayerIdRequired” value=”false” />, „PersonalDataProcessingConsentRequired” value=”true” /> i parametr „WorkingConditionsAcceptanceRequired” value=”true”

Uwaga

Do właściwego działania rejestracji użytkownika z poziomu aplikacji web konieczne jest poprawne wypełnienie przez administratora pól sekcji Ustawienia konta pocztowego w ramach zakładki Ustawienia w aplikacji desktopowej

Uwaga

W wersji 2026.0.0 zewnętrzna rejestracja użytkowników jest niedostępna.

• – możliwość zdefiniowania filtra zawężającego wyszukiwanie dokumentów, dla których przekazanie do kolejnego etapu odbyło się określoną ilość dni temu. Wartość klucza odpowiada liczbie dni. Niezależnie od ustawienia, operator może usunąć lub zmienić zdefiniowany filtr. Ustawienie wartość = 0 wyłącza domyślny filtr.
• – wartość „true” umożliwia współpracę Comarch BPM (dawniej DMS) z Comarch ERP XL w trybie chmurowym.
• – wartość „true” umożliwia współpracę Comarch BPM (dawniej DMS) z Comarch ERP Optima w trybie chmurowym.
• – parametr dostępny od wersji 2023.1.0; umożliwia wybór miejsca zapisu ścieżek punktów ACD. Klucz może przyjmować wartości:
• • • • Registry – wartość domyślna, oznaczająca, że ścieżki punktów ACD będą zapisywane w rejestrze (jak dotychczas)  . - Database– wartość oznaczająca, że ścieżki punktów ACD będą zapisywane w bazie danych w tabeli do.DF_ConfAPFolderPaths

Uwaga

Jeśli użytkownik pierwszy raz zmienia wartość klucza na „Database”, wówczas przy pierwszym ładowaniu widoku punktów ACD wszystkie dane z rejestru zapisują się do bazy.  Natomiast przy zmianie wartości z „Database” na „Registry” dane z bazy nie są automatycznie przepisywane do rejestru.

Uwaga

W wersji 2024.3.1 klucz ACDFolderPathsDestination został usunięty z pliku web.config –  od tej wersji włącznie ścieżki punktów ACD są zapisywane w bazie danych.

• – parametr odpowiedzialny za wyświetlanie komunikatów z pytaniem „Czy zapisać zmiany?” na szczegółach dokumentów Comarch BPM (dawniej DMS). W przypadku ustawienia value=”True”, komunikaty będą wyświetlane w aplikacji, w przypadku value=”False” komunikaty nie będą wyświetlane w aplikacji.

Uwaga

Gdy wartość klucza „AskAboutDocumentSave” zostanie ustawiona na „False”, w ustawieniach typu obiegu nie będzie możliwe włączenie funkcjonalności automatycznego zapisu po zainicjowaniu dokumentu.

• – klucz odpowiada za możliwość ustawienia różnych spółek dla kontrolek na definicji obiegu. Wyłączona możliwość ustawienia różnych spółek dla wszystkich kontrolek: value = „false”, włączona: value = „true”.
• – parametr odpowiedzialny za wyświetlanie liczby dokumentów utworzonych w ramach danego typu obiegu, liczba dokumentów prezentowana jest w nawiasie obok każdego typu obiegu na drzewie typów obiegów. Domyślnie funkcjonalność jest włączona z wartością 1, czyli odświeżenie danych o liczbie dokumentów w ramach danego typu/grupy typów obiegu odbywa się co 1 minutę. Klucz może przyjmować wartości:
• • • „-1” – wartość oznaczająca, że funkcjonalność jest wyłączona, na drzewie typów obiegów nie są prezentowane wartości z liczbą dokumentów.
  • „0” – wartość oznaczająca, że funkcjonalność jest włączona i sumowanie liczby dokumentów odbywa się przy każdym wejściu na listę dokumentów
  • „” – wartość oznaczająca, że funkcjonalność jest włączona, wpisana liczba określa wyrażony w minutach czas, po którym nastąpi automatyczne odświeżenie danych.
• – parametr, w którym operator określa, jak często baza danych będzie sprawdzać, czy są nowe maile (w minutach)
• – od wersji 2022.0.3 parametr, w którym operator określa, czy wiadomości email po wysłaniu powinny być usuwane czy zachowywane w tabelach. Klucz może przyjmować wartości:
• • • • „False” – wartość oznaczająca, że zarówno maile, jak I załączniki zostaną zarchiwizowane w tabelach po wysłaniu - „True” – wartość oznaczająca, że zarówno maile, jak i załączniki zostaną usunięte po wysłaniu
• – parametr, w ramach którego można wpisać rozszerzenia plików, które mają być zabronione przy dodawaniu nowych dokumentów do Managera Dokumentów. Domyślnie wartość klucza jest pusta – jeśli nie zostanie uzupełniona przez administratora, możliwe będzie dodawanie plików z każdym rodzajem rozszerzenia.
• <!– –> – musi pozostać zakomentowane. Parametr aktywny jeżeli ustawiono . Umożliwia pracę na wspólnym haśle podczas generowania dokumentów.

Uwaga

Odkomentowanie klucza o nazwie”XLAPIOpeHaslo” spowoduje zamianę wszystkich haseł operatorów Comarch ERP XL na hasło ustawione w kluczu.

• – parametr umożliwia wybór bazy, w której przechowywane będą załączniki dodane do dokumentów:
• • • • • baza BPM (dawniej DMS) – value = „DO”, - baza ERP XL – value = „XL”, - usługa IBARD – value = „IBARD”.
• – parametr umożliwia wybór bazy, w której przechowywane będą pliki dodane do Managera dokumentów lub usługi Comarch BPM (dawniej DMS)Repozytorium:
• • • • • baza BPM (dawniej DMS) – value = „DO”, - usługa IBARD – value = „IBARD”.
• – adres serwera usługi Comarch OCR, na który wysyłane są pliki do rozpoznania w Comarch OCR.
• – wartość to wyrażony w minutach czas, po którym przetwarzanie pliku zostanie przerwane i wyświetlony zostanie błąd (!), a program przejdzie do przetwarzania następnego dokumentu w kolejce.
• – klucz dodany w wersji 2025.1.0; czas awaryjnego zwolnienia blokady na plik przetwarzany przez OCR przez aplikację serwerową na IIS;

• – adres usługi 2FA z Comarch ERP Optima.

• add key=”KSeFWorkMode” value=”Demo” /> – klucz wprowadzony w wersji 2024.0.1; umozliwia określenie, czy Firma testuje funkcjonalność wysyłania faktur do KSeF, czy korzysta z niej produkcyjnie. Klucz może przybierać jedną z następujących wartości:

1.Demo – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Demo;

2.Production – od wersji 2026.0.0 wartość domyślna; w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie Produkcyjnym, czyli wersji produkcyjnej systemu;

3.Test – w przypadku wprowadzenia takiej wartości praca z systemem KSeF odbywa się w trybie testowym.

Uwaga

W celu przetestowania współpracy z Comarch BPM na prawdziwych danych zalecamy korzystanie z trybu Demo.

W kwestii różnic pomiędzy powyższymi trybami zob. Przełączanie trybu pracy z KSeF

• – klucz dodany w wersji 2026.0.0; ma umożliwić zmianę wersji KSeF dla pracy w trybie produkcyjnym. Klucz może przyjmować jedną z następujących wartości:
• 1 – wartość domyślna w wersji 2026.0.0; możliwa jest praca w trybie produkcyjnym KSeF 1.0
• 2 – możliwa jest praca w trybie produkcyjnym KSeF 2.0

Uwaga

Praca w trybie produkcyjnym KSeF 2.0 będzie możliwa jedynie wtedy, gdy  oraz  – ten tryb pracy będzie aktywny dopiero po uruchomieniu przez Ministerstwo Finansów środowiska produkcyjnego KSeF 2.0, tj. po 01.02.2026.

Klucz “KSeFProdVersion“ nie wpływa na pracę w trybie „Test“ oraz „Demo“.

• – klucz dodany w wersji 2024.1.0 związany z integracją z usługą e-Doręczenia; w kluczu znajduje się adres potrzebny do uzyskania tokenu dostępowego do API Search Engine i User Agent;
• – klucz dodany w wersji 2024.1.0; zmodyfikowany w wersji 2026.0.0; związany z integracją z usługą e-Doręczenia; w ramach klucza określony jest endpoint dla API Search Engine;
• – klucz dodany w wersji 2024.1.0; zmodyfikowany w wersji 2026.0.0; związany z integracją z usługą e-Doręczenia; w ramach klucza określony jest endpoint dla API User Agent;

Uwaga

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

• – klucz dodany w wersji 2024.1.0 związany z integracją z usługą e-Doręczenia; w ramach klucza określony jest maksymalny dopuszczalny rozmiar załączników, które są przesyłane w ramach usługi E-Doręczenia. Aktualnie wartość ta wynosi 15 MB. Klucz nieaktywny w pierwszej wersji funkcjonalności;
• – klucz dodany w wersji 2024.3.0; w ramach klucza znajduje się adres URL usługi Chat ERP;
• – klucz dodany w wersji 2024.3.0; w ramach klucza znajduje się zaszyfrowany klucz API – jest to stała wartość, której nie należy edytować;
• klucz dodany w wersji 2026.0.0; klucz uwierzytelniający, pozwala na otrzymywanie odpowiedzi z API ChataERP;
• <!– –> – klucz wymagany przy współpracy z Comarch ERP XL w trybie chmurowym (należy odkomentować). Należy zdefiniować serwer dla bazy ERP XL.

• <!– –> – jeżeli ERP XL w trybie chmurowym pracuje na więcej niż jednym serwerze, należy odkomentować i uzupełnić.

• – wartość klucza określa, którzy operatorzy są uprawnieni do zarządzania układem katalogów na drzewie w Managerze dokumentów. Domyślnie wartość klucza jest pusta, oznacza to, że wszyscy operatorzy mogą zarządzać kolejnością katalogów na drzewie. Jeżeli w kluczu zostaną wskazane identyfikatory operatorów BPM (dawniej DMS) (DCD_ID), będzie to oznaczać, że jedynie wskazani operatorzy posiadają uprawnienie do reorganizacji struktury katalogów. Identyfikatory operatorów powinny być rozdzielane przecinkiem.

• – klucz działa w trybie wielospółkowym, usunięty od wersji 2025.2.0;wartość „true” powoduje możliwość zawężania listy wyświetlanych spółek po wpisaniu frazy w okno wyszukiwania. Jeżeli wartość = „false”, spółkę należy znaleźć i wybrać z rozwijanej listy.
• – parametr wprowadzony w wersji 2025.2.0 zamiast parametru ”CompanyNameSearchModeEnabled”; dotyczy kwestii sposobu wyboru spółki w oknie logowania –parametr może przyjąć następujące wartości:
• List – wartość domyślna, ustawiana przez instalator podczas instalacji Comarch BPM – jeśli wprowadzono tę wartość, wówczas operator może wybrać spółkę z listy dostępnych spółek w oknie logowania;
• Search – jeśli wprowadzono tę wartość, wówczas operator może wyszukać nazwę spółki wraz z sugerowaną nazwą spółki, która zawiera wpisaną frazę, na liście dostępnych spółek w oknie logowania. Jeśli lista nie zawiera danej frazy, wówczas nie zostanie wyświetlona (aplikacja desktop i aplikacja web) lub zostanie wyświetlona pusta lista (aplikacje mobilne);

• Text – jeśli wprowadzono tę wartość, wówczas operator powinien wprowadzić nazwę spółki ręcznie w polu „Spółka” w oknie logowania.

• – parametr określający, czy do przechowywania dokumentów będzie używany moduł Manager dokumentów (wartość „false”), czy funkcjonalność Comarch DMS Repozytorium (wartość „true”).

• – w przypadku korzystania z funkcjonalności Comarch DMS Repozytorium, należy wprowadzić adres URL aplikacji DocumentManager.WebApi,
  np. http://localhost/DocumentManager.WebApi

• <add key=„WebClientUrl” value=”http:///DocumentWorkflow.Web” /> – wprowadzony w wersji 2024.0.0; klucz, w którym (w przypadku korzystania z funkcjonalności Comarch BPM Repozytorium) należy wprowadzić adres aplikacji nowego klienta web,
  np. http://localhost/ DocumentWorkflow.Web (w wersjach starszych niż 2024.0.0 w tym miejscu znajduje się klucz – w przypadku korzystania z funkcjonalności Comarch BPM (dawniej DMS) Repozytorium, należy wprowadzić adres URL aplikacji DocumentManager.WebClient,http://localhost/DocumentManager.WebClient).
• – klucz dostępny od wersji 2024.0.0; umożliwia zmianę zakresów czasowych  informacji prezentowanych na zakładce „Analiza wydajności” w sekcji „Statystyki”
• – klucz dostępny od wersji 2024.1.1; w ramach tego klucza należy podać, jaka ma być maksymalna liczba prób logowania dla operatora zanim nastąpi zablokowanie logowania – domyślna wartość to 5 (zob. Blokowanie logowania po kilku nieudanych próbach)
• – klucz dostępny od wersji 2024.1.1; w ramach tego klucza należy podać, po jakim czasie (liczonym w sekundach) operator będzie mógł podjąć kolejną próbę logowania, po tym, jak logowanie zostało zablokowane – domyślna wartość to 60 (zob. Blokowanie logowania po kilku nieudanych próbach)
• – klucz dostępny od wersji 2025.1.0;umożliwia dostęp do Menadżera dokumentów w aplikacji serwerowej pomimo braku możliwości pracy w aplikacji serwerowej. Klucz może przyjmować wartości:
• False – wartość domyślna; w takim przypadku Menadżer dokumentów w aplikacji serwerowej nie jest dostępny, a po przejściu do adresu aplikacji serwerowej wyświetlany jest komunikat „Ta wersja aplikacji Comarch DMS Web nie jest już dostępna” (zob. Dodanie komunikatu informującego o tym, że dawna wersja aplikacji web jest niedostępna );

• True – jeśli w ramach klucza wprowadzono taką wartość, wówczas Menadżer dokumentów w aplikacji serwerowej jest dostępny, a po przejściu do adresu aplikacji serwerowej operator może się zalogować – zostanie wówczas otwarte okno, w ramach którego dostępna jest jedynie zakładka „Manager dokumentów”

• - klucz dodany do pliku Web.config w wersji 2024.3.0 (od wersji 2024.2.0 możliwe jest samodzielne dopisanie go w ramach plliku); domyślna wartość to "false" - wówczas aplikacja korzysta ze starego mechanizmu uprawnień do dokumentów; jeżeli operator zmieni wartośc na "true", wówczas zostaje włączony nowy mechanizm uprawnień do dokumentów (zob. Nowy mechanizm uprawnień do dokumentów)

• - klucz dodany w wersji 2025.2.0; parametr który umożliwia dokonanie wyboru, gdzie powinny być zapisywane logi. Jeżeli wartość klucza to:
• False – wartość domyślna; w takim przypadku logi będą zapisywane w postaci plików (jeśli klucz „OptimaCloudMode” ma wartość „False”). Maksymalny rozmiar pliku to 1 MB -jeśli plik z logami przekroczy ten rozmiar, tworzony jest następny w tej samej lokalizacji z d odatkowymi znakami (np. „ _1”). Lokalizacja pliku jest zależna od obszaru pracy aplikacji (zob. opisy poszczególnych sekcji dotyczących logów w Comarch BPM);

• True – wówczas logi będą zapisywane wyłącznie w bazie danych Comarch BPM w tabeli do.DF_WorkLogEntries (jeśli klucz „OptimaCloudMode” ma wartość „False”);

• - klucz stosowany od wersji 2026.0.0; określa na jakim adresie i porcie działa Comarch sPrint;

• - klucz stosowany od wersji 2026.0.0; określa, czy współpraca z Comarch sPrint jest aktywna (true) czy nieaktywna (false);
• - klucz stosowany od wersji 2026.0.0; określa timeout serwera

Ustawienia kluczy używane w trybie jednofirmowym:

• <add key="CompanyName" value="" /> - można zdefiniować nazwę firmy, która zostanie wyświetlona w aplikacji przed loginem zalogowanego operatora.
• <add key="LicenceKeyServerERP" value="" /> - należy wpisać nazwę serwera licencji dla Comarch ERP XL / Comarch ERP Optima / Comarch ERP Altum.
• - parametr aktywny jeżeli ustawiono . Umożliwia dekretację kosztów i generowanie dokumentów.
• - parametr określa tryb pobierania wymiarów opisu analitycznego. Klucz przyjmuje następujące wartości:
• • • • • • • • 1 – bezpośrednie pobieranie wymiarów z bazy Comarch ERP XL, - 2 – tryb z buforowaniem i doczytywaniem wymiarów do nowej daty utworzenia dokumentów (tryb, w którym dotychczas były pobierane wymiary opisu analitycznego), - 3 – tryb z buforowaniem, ale bez doczytywania wymiarów (warunek: w Comarch ERP XL wymiary nie posiadają zakresów czasowych).
• - nr wersji systemu ERP XL, z którym współpracuje Comarch DMS.
• - klucz należy uzupełnić przy konfigurowaniu współpracy Comarch DMS z Comarch ERP Enterprise (CEE). Należy wprowadzić adres URL do systemu CEE. np. "https://nazwa_aplikacji.cisag.com". Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
• - należy uzupełnić klucz certyfikatu dla CEE. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
• -  w kluczu należy umieścić adres serwisu rest systemu Comarch ERP Enterprise.
• - należy wprowadzić nazwę bazy CEE. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
• - należy wprowadzić unikalny identyfikator (w formie GUID) domyślnej organizacji w CEE. Nie ma konieczności uzupełniania klucza w przypadku pracy w trybie wielospółkowym.
• - należy wprowadzić nazwę organizacji nadaną w systemie Comarch ERP Enterprise.
• - klucz wymagany przy współpracy z Comarch ERP XL w trybie chmurowym (należy odkomentować). Należy zdefiniować serwer dla bazy ERP XL.
• - jeżeli ERP XL w trybie chmurowym pracuje na więcej niż jednym serwerze, należy odkomentować i uzupełnić.

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 (dawniej DMS)

W katalogu DMS Workflow Api 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”.

Otwieranie wiersza polecenia

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

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

Przykładowy wiersz polecenia do instalacji skryptów na bazie Comarch BPM (dawniej DMS)

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

Przyklad

Sposób 2

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

Wybór pliku „Install.bat” 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 (dawniej DMS)

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

Plik „Install.bat” po uzupełnieniu danych i zapisaniu pliku

Uwaga

W wersji 2024.0.2 w pliku Install.bat został dodany dodatkowy argument ODUSERPASSWORD, (aktualnie PASSWORD), w którym należy uzupełnić hasło dla ODUsera w przypadku instalacji ręcznej aplikacji Comarch DMS, jeśli aplikacja Comarch BPM (dawniej DMS) jest instalowana po raz pierwszy i użytkownik ODUser nie istnieje w MSSQL.

Hasło dla użytkownika ODUser musi być zgodne z polityką haseł.
Należy używać silnego hasła, które spełnia wszystkie poniższe warunki:

• składa się z minimum 12 znaków;
• zawiera znaki alfabetyczne;
• zawiera znaki specjalne ze zbioru !@#$%^*()

Parametr PASSWORD w pliku Install.bat – przykład

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.

Wybór opcji „Uruchom jako administrator”

Uruchamianie skryptów na bazie Comarch ERP XL

Analogiczny scenariusz należy wykonać dla katalogu Workflow Api \ SqlXL w tej samej lokalizacji, z tą różnicą, że zamiast nazwy bazy danych Comarch BPM (dawniej DMS) 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”.

Otwieranie wiersza polecenia

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

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

InstallXL.bat

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

Przykładowy wiersz polecenia do instalacji skryptów na bazie Comarch ERP XL

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

Sposób 2

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

Wybór pliku „InstallXL.bat” 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.

Plik „InstallXL.bat” po uzupełnieniu danych i zapisaniu pliku

Uwaga

W wersji 2024.0.2 w pliku InstallXL.bat został dodany dodatkowy argument ODUSERPASSWORD, (aktualnie PASSWORD),  w którym należy uzupełnić hasło dla ODUsera w przypadku instalacji ręcznej aplikacji Comarch BPM (dawniej DMS), jeśli aplikacja Comarch BPM (dawniej DMS) jest instalowana po raz pierwszy i użytkownik ODUser nie istnieje w MSSQL.

Hasło dla użytkownika ODUser musi być zgodne z polityką haseł.
Należy używać silnego hasła, które spełnia wszystkie poniższe warunki:

• składa się z minimum 12 znaków;
• zawiera znaki alfabetyczne;
• zawiera znaki specjalne ze zbioru !@#$%^*()

Parametr PASSWORD w pliku InstallXL.bat – przykład

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.

Wybór opcji „Uruchom jako administrator”

Uwaga

Skrypty na bazie Comarch BPM (dawniej DMS) oraz bazie Comarch ERP XL mogą być uruchamiane wielokrotnie.

Zaprogramowanie klucza HASP 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” (Od wersji 2026.0.0 „Programowanie klucza HASP na serwerze Menadżera Kluczy”) . Opcja umożliwia programowanie klucza HASP 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. Zaprogramowanie klucza HASP jest konieczne dla poprawnego działania Comarch BPM.

Okno „Wybór aplikacji“ z opcją „Programowanie klucza HASP na serwerze Menadżera Kluczy”

Aby zaprogramować nowy klucz HASP, należy zaznaczyć opcję „Tworzenie użytkownika CDNHASPDMS na serwerze Menadżera Kluczy” (od wersji 2026.0.0 „Programowanie klucza HASP 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:

• Wybierz witrynę web – w tym polu z listy dostępnych witryn należy wybrać witrynę, na której znajduje się aplikacja serwerowa (dawna web), na której ma zostać zaprogramowany klucz HASP– domyślnie wyświetlana jest witryna Default Web Site;
• Port – nieedytowalne pole numeru portu, które jest widoczne jako wyszarzone;
• Wybierz aplikację serwerową – w ramach tego pola użytkownik z listy aplikacji dostępnych na danej witrynie wybiera tę aplikację serwerową (dawna web), na której ma zostać zaprogramowany klucz HASP

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

Okno „Wybór aplikacji serwerowej“ przed wyborem witryny i aplikacji

Okno „Wybór aplikacji serwerowej“ po wyborze witryny i aplikacji

W ramach okna, „Użytkownik CDNHASPDMS” (od wersji 2026.0.0 „Klucz HASP”)  znajdują się trzy pola:

• Nazwa serwera – w ramach tego pola znajduję się automatycznie wpisany klucz licencji, pobrany z pliku web.config;
• Login – w ramach tego pola należy wprowadzić login użytkownika z uprawnieniami administratora do serwera, który wskazano w polu „Nazwa serwera“
• Hasło – w ramach tego pola należy wprowadzić hasło użytkownika z uprawnieniami administratora do serwera, który wskazano w polu „Nazwa serwera“

Okno „Klucz HASP“ przed uzupełnieniem pól „Login“ i „Hasło“

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]  (od wersji 2026.0. 0  [Wykonaj]) 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.”.

Okno „Klucz HASP“, gdy błędnie uzupełniono dane w polach , po kliknięciu w przycisk „Połącz“

Jeżeli poprawnie wprowadzono dane w oknie „Klucz HASP“, 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] (od wersji 2026.0. 0[Wykonaj]) staje się aktywny.

Okno „Klucz HASP , gdy poprawnie uzupełniono dane w polach, po kliknięciu w przycisk „Połącz“

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

Okno „Klucz HASP“, gdy programowanie klucza HASP zakończyło się sukcesem

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 zaprogramowano klucz HASP.

Reindeksacja bazy

W katalogu SQL znajduje się plik reindex.bat, który umożliwia:

• • • • • • • Zreindeksowanie tabel schematu DO, - Odbudowę statystyk, - Rekompilacje procedur i funkcji schematu DO.

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

Otwieranie wiersza polecenia

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

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

reindex.bat

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.

Przykładowy wiersz polecenia do reindeksacji bazy Comarch BPM (dawniej DMS)

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 (zob. Dodanie klucza "LegacyDocumentManagerAccess" – umożliwienie dostępu do Menadżera dokumentów z aplikacji serwerowej) .

Okno „Ta wersja aplikacji Comarch DMS Web nie jest już dostępna”

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

Jeśli podczas uruchomiania aplikacji serwerowej (dawna web) pojawia się komunikat: „add name=”strConnct providerName=”System.Data.SqlClient" - sprawdź tutaj

Jeśli podczas próby uruchomienia aplikacji serwerowej (dawna web) pojawia się komunikat ”Błąd http 500.19 – Internal Server Error’’- sprawdź tutaj

W celu konfiguracji aplikacji WEB należy przejść do artykułu Ręczna konfiguracja aplikacji WEB (nowej aplikacji web)

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

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu