Definiowanie punktu konfiguracyjnego (współpraca z Comarch OCR (generowanie dokumentów do Repozytorium))
W wersji 2023.0.0 dodany został nowy typ punktu ACD o nazwie Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium). Umożliwia on przesyłanie dokumentów do Comarch BPM (dawniej DMS) Repozytorium oraz przeprocesowanie ich przez usługę Comarch OCR.
W ramach tego typu możliwe jest utworzenie wielu punktów konfiguracyjnych, podobnie jak ma to miejsce w przypadku innych typów punktów ACD.
Uwaga
Typ punktu konfiuracyjnego “Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)” jest dostępny na liście tylko, jeśli została włączona współpraca z modułem Repozytorium, czyli gdy w pliku web.config klucz UseRepository=”True” (zob. przykładowo Instalacja aplikacji web w trybie ręcznym).
Jeżeli UseRepository=”False”, wówczas punkt typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)” nie jest dostępny.
Uwaga
Typ punktu konfiguracyjnego “Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)” nie jest dostępny, jeśli w pliku web.config klucz WorkMode=”Lite” (Comarch DMS pracuje w trybie Lite)
Punkt ACD typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)”, zakładka „Tryb współpracy”
Zakładka Ogólne
Punkt ACD typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)”, zakładka „Ogólne”
W ramach zakładki „Ogólne” znajdują się następujące pola:
Nazwa punktu – w polu należy wpisać nazwę punktu nadaną przez użytkownika
Typ dokumentu – w ramach pola wyświetlana jest lista typów dokumentów dostępnych w module Repozytorium, zgodnie z listą znajdującą się w module Repozytorium w zakładce , w zakładce „Zarządzanie aplikacją”, w sekcji „Typy dokumentów”. Użytkownik powinien wybrać z listy typ dokumentu, który zostanie nadany dokumentom wygenerowanym w punkcie ACD
Przykładowa lista typów dokumentów wyświetlana w module Repozytorium
Punkt ACD typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)”, zakładka „Ogólne”, pole „Typ dokumentu” – przykładowa lista typów dokumentu dostępnych w module Repozytorium
Lokalizacja – w ramach pola dostępna jest lista lokalizacji zgodnie ze strukturą folderów w module Repozytorium; użytkownik powinien wybrać lokalizację, do której w ramach modułu Repozytorium mają trafiać dokumenty wygenerowane w punkcie ACD
Przykładowa struktura folderów w module Repozytorium
Punkt ACD typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)”, zakładka „Ogólne”, pole „Lokalizacja” – przykładowa lista lokalizacji dostępnych w module Repozytorium
Wyszukiwanie w treści plików w module Repozytorium – domyślnie zaznaczona opcja; jeżeli checkbox jest zaznaczony, wówczas możliwe jest wyszukiwanie przesłanych dokumentów w module Repozytorium według frazy znajdującej się w treści dokumentu, a także wyszukiwanie fraz w ramach treści dokumentu na podglądzie
Zakładka Lista
Na zakładce „Lista”, analogicznie do pozostałych trybów pracy punktów konfiguracyjnych, należy za pomocą zapytania SQL określić listę dokumentów, która będzie wyświetlana w oknie ACD po przeprocesowaniu plików w usłudze Comarch OCR.
Przyklad
Przykład zapytania wyświetlającego listę dokumentów
BEGIN TRY
select OCD_ID, NULL, OCD_Number from do.OC_Documents
left join do.OC_WorkAPProcess on OCD_ID = OCW_DocumentID /*tabela przeprocesowanych dokumentów */
join do.DF_ConfAPDictionary on OCW_APDId=APD_ID
where OCW_Status = 2 and OCW_Archival = 0 and OCW_APDid =@PointId@ -- zmienna dynamiczna
--and OCW_OperatorID=@IdOperatorBPM@ /*dodatkowy warunek, aby na liście operator widział dokumenty przeprocesowane przez siebie*/
END TRY
BEGIN CATCH
DECLARE @ErrorMessage varchar(max) = 'W zapytaniu wystąpił błąd: ' + ERROR_MESSAGE();
THROW 50001, @ErrorMessage ,1;
END CATCH
Uwaga
Od wersji 2024.2.1 w zapytaniu na zakładce „Lista” należy dodać „and OCW_Archival=0”, zgodnie z powyższym przykładem.
Punkt ACD typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)”, zakładka „Lista”
Zakładka Atrybuty
Uwaga
W konfiguracji punktu ACD typu “Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)” zakładka Kontrolki została zastąpiona zakładką Atrybuty.
W ramach zakładki można mapować wartości z bazy SQL, pochodzące z dokumentu, który został przeprocesowany, na atrybuty na dokumencie przesłanym do Repozytorium.
Kiedy użytkownik kliknie przycisk [Dodaj], wyświetlana jest lista atrybutów, które w module Repozytorium zostały przypisane do danego typu dokumentu, wybranego w ramach konfiguracji punktu ACD na zakładce „Ogólne” w polu „Typ dokumentu”.
Użytkownik może wybrać z listy atrybuty, na które mają zostać zmapowane wartości. Obok nazwy wybranego atrybutu wyświetlany jest również w nawiasie typ danego atrybutu.
Przykładowa lista atrybutów przypisana przez użytkownika do danego typu dokumentu w module Repozytorium
Punkt ACD typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)”, zakładka „Atrybuty”– przykładowa lista atrybutów dostępnych dla danego typu dokumentu w module Repozytorium
Po wyborze z listy atrybutu należy zdefiniować zapytanie SQL, które pobierze z bazy odpowiednią wartość po przeprocesowaniu dokumentu za pomocą usługi OCR, analogicznie jak ma to miejsce w przypadku innych typów punktów ACD.
Punkt ACD typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)”, zakładka „Atrybuty”– zapytanie SQL dla przykładowego atrybutu „Data wystawienia”
Zakładka Uprawnienia
Na zakładce „Uprawnienia” należy wskazać pracowników, którzy będą mogli procesować dokumenty w ramach punktu. Uprawnienia mogą być dodawane wyłącznie 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.
Punkt ACD typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)”, zakładka „Uprawnienia” w trybie wielospółkowym
Uwaga
Dodanie operatora do uprawnień na punkcie konfiguracyjnym skutkuje nadaniem mu uprawnień do zakładki ACD (we właściwościach pracownika, na zakładce „Uprawnienia”, w sekcji „Funkcjonalności” zostaje zmieniona wartość parametru „Automatyczne generowanie dokumentów” na „TAK”)
Konieczne jest, aby operatorzy, którym nadano uprawnienia do punktu ACD typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)” posiadali:
Uprawnienia do pracy z Repozytorium (na karcie pracownika na zakładce „Struktura organizacyjna” na zakładce „Uprawnienia” w sekcji „Funkcjonalności” w polu „Praca z modułem” mają wybraną wartość „Obieg dokumentów i Repozytorium” – zob. Struktura organizacyjna)
Uprawnienia administratora lub edytora do lokalizacji w module Repozytorium wybranej w punkcie ACD na zakładce „Ogólne” w polu „Lokalizacja” (nadawanie takich uprawnień odbywa się w module Repozytorium podczas dodawania folderu – w przypadku uprawnienia administratora – lub z poziomu menu kontekstowego dodanego folderu – w przypadku uprawnienia administratora lub edytora – zob. Instrukcja Repozytorium
Jeżeli operator nie posiada któregoś z powyższych uprawnień, wówczas nie jest możliwe przesłanie dokumentu poprzez punkt ACD do modułu Repozytorium i przy próbie generowania dokumentu wyświetlony zostaje następujący komunikat:
Komunikat wyświetlany w przypadku braku uprawnień użytkownika próbującego generować dokument
Na każdej zakładce znajduje się ikona [Eksport], która umożliwia eksportowanie danego punktu ACD do zapisu na dysk (zob. Eksport punktu ACD).
Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o ComarchBPM (dawniej DMS) i chcesz dowiedzieć się więcej?
Praca z punktem ACD (generowanie dokumentów do Repozytorium)
Analogicznie do typu współpracy „Współpraca z Comarch OCR” aby rozpocząć pracę z punktem ACD należy kolejno:
nacisnąć przycisk [Ustawienia OCR] i wybrać folder, z którego będą pobierane dokumenty do procesowania przez usługę Comarch OCR; w wersji 2025.2.1 w ramach okna wyświetlanego po kliknięciu w przycisk [Ustawienia OCR] dodano dwa pola, analogiczne do tych znajdujących się w punkcie ACD typu „Współpraca z OCR“:
Zakres stron do przetworzenia – pole umożliwia wprowadzenie zakresu stron do przetworzenia.
Łączenie stron przesyłanych plików – pole umożliwia wybór sposobu łączenia stron przetwarzanych przez OCR:
Według treści - łączenie stron w przesłanym pliku będzie odbywało się na podstawie zawartości zinterpretowanej przez algorytm usługi OCR
Jeden przesłany plik to jeden dokument - dokument nie zostaje podzielony i jest w całości przekazany do Repozytorium.
Kiedy zakres stron zostanie określony, OCR najpierw wybierze ten zakres stron z dokumentu, później zaś w tym zakresie połączy strony dokumentu według treści lub według założenia, że jeden przesłany plik jest równy jednemu dokumentowi (zgodnie z wybraną opcją).
Widok okna „Ustawienia OCR“ z polami „Zakres stron do przetworzenia“ i „Łączenie stron przesyłanych plików“
Widok okna „Ustawienia OCR“ z polami „Zakres stron do przetworzenia“ i „Łączenie stron przesyłanych plików“ – widoczne są opcje dostępne w ramach pola „Łączenie stron przesyłanych plików“
kliknąć przycisk [Dodaj pliki], aby wskazać plik, który zostanie umieszczony w folderze wybranym do pobierania dokumentów do procesowania lub przycisk [Skanuj], aby dodać dokument bezpośrednio ze skanera
Aby uruchomić przetwarzanie dokumentów w usłudze Comarch OCR należy zaznaczyć parametr „Włącz procesowanie dokumentów”. Po zaznaczeniu parametru dokumenty umieszczone we wskazanym folderze zostaną automatycznie przesłane do Comarch OCR i przeniesione do podkatalogu „Wysłane”.
Kiedy pliki zostały przeprocesowane przez usługę OCR, dokumenty wyświetlają się na liście, według zapytania z zakładki „Lista”, a informacje pochodzące z przeprocesowanego dokumentu zostają przeniesione do odpowiednich pól atrybutów, zgodnie z atrybutami wybranymi na zakładce „Atrybuty”. Obok nazwy atrybutu widoczny jest jego typ.
Następnie należy zaznaczyć checkbox znajdujący się obok danej pozycji na liście, a następnie kliknąć przycisk . Zostaje wówczas wyświetlone okno „Inicjowanie dokumentów”.
Okno „Inicjowanie dokumentów” informujące o wysyłaniu dokumentów do modułu Repozytorium
W ramach okna „Inicjowanie dokumentów” operator może kliknąć na przycisk [Zatrzymaj]. W takim przypadku, jeśli:
Generowany pojedynczy dokument zdążył zostać zainicjowany i przesłany – nie jest już widoczny na liście w punkcie ACD i znajduje się wybranej lokalizacji w module Repozytorium
Generowany pojedynczy dokument nie zdążył zostać przesłany – nadal jest widoczny na liście w punkcie ACD
Żaden z wielu generowanych dokumentów nie zdążył zostać przesłany – wszystkie dokumenty nadal są widoczne na liście w punkcie ACD
Tylko część z wielu generowanych dokumentów zdążyła zostać przesłana – wówczas ta część dokumentów nie jest już widoczna na liście w punkcie ACD i znajduje się w wybranej lokalizacji w module Repozytorium, a pozostałe nadal są na liście
Wszystkie z wielu generowanych dokumentów zdążyłyzostać przesłane – wówczas żaden z tych dokumentów nie jest już widoczny na liście w punkcie ACD i wszystkie znajdują się w wybranej lokalizacji w module Repozytorium
Dokument przetworzony przez Comarch OCR jest wysyłany do modułu Repozytorium, do lokalizacji, którą wybrano w ramach definicji punktu konfiguracyjnego. Przeprocesowane dane są także wprowadzane do bazy MongoDB.
Okno pracującego punktu konfiguracyjnego typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)”
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?
Właściwości kontrolki typu załącznik, którą wybrano w punkcie konfiguracyjnym
Po skonfigurowaniu punktu ACD w ramach Współpracy z Comarch OCR (przesyłania skanów z kontrolki załącznik na dokumencie BPM) (zob. Definiowanie punktu konfiguracyjnego) wystarczy tylko utworzyć nowy dokument i dodać wybrany plik do kontrolki typu załącznik, która została wskazana w zakładce 'Ogólne’ punktu konfiguracyjnego.
Plik jest wtedy przesyłany do Comarch OCR, a wówczas kontrolki, które zostały skonfigurowane zapytaniem SQL w zakładce 'Kontrolki’ punktu konfiguracyjnego, są automatycznie uzupełniane danymi z załącznika.
Dane rozpoznane w Comarch OCR mogą zostać zweryfikowane poprzez włączenie podglądu dokumentu i porównanie z plikiem.
Uwaga
Kontrolka typu załącznik, z której dokument przesyłany jest do Comarch OCR, podlega pewnym ograniczeniom:
do kontrolki możliwe jest dodanie tylko jednego pliku
jeśli plik PDF dodany w ramach kontrolki składa się z dwóch lub więcej faktur, dodane będą tylko dane z pierwszej z faktur
możliwość dodawania skanów wprost ze skanera w ramach tej kontrolkizostała zablokowana – załącznik może pochodzić z dysku albo z managera dokumentów (po uprzednim zaznaczeniu opcji 'Manager dokumentów’ na karcie kontrolki typu załącznik)
jedynie pliki jpg, jpeg i pdfmogą zostać dodane w ramach kontrolki
Dodawanie załącznika do kontrolki, dla której utworzono punkt ACD
Dokument z danymi wczytanymi z pliku przesłanego z kontrolki typu załącznik do Comarch OCR, z włączonym oknem podglądu pliku
Od wersji 2025.2.0 w przypadku, jeśli obieg, który wybrano na definicji danego punktu ACD typu „Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM” na zakładce „Ogólne” w polu „Typ obiegu” jest skonfigurowany do pracy z Repozytorium i wyboru lokalizacji w Repozytorium (na kontrolce typu Załącznik zaznaczono parametry: „Współpraca z Repozytorium” i „Pozwalaj na wybór lokalizacji podczas dodawania załącznika”), wówczas podczas dodawania załącznika zostanie wyświetlone okno wyboru lokalizacji, do której ma trafić plik załącznika w Comarch BPM Repozytorium (por. Wybór lokalizacji zapisu załącznika w Comarch BPM Repozytorium przez operatora dodającego załącznik w aplikacji desktop).
Wybór lokalizacji w Comarch BPM Repozytorium, do której ma trafić plik załącznika
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?
Dlaczego aplikacja Comarch BPM nie generuje żadnych plików logów?
Zakładka Ustawienia – Logi systemowe
Przyczyna: Wyłączona opcja ładowania profilu użytkownika w sesji nieinteraktywnej. Uniemożliwia to procesowi dostęp do zmiennych środowiskowych (np. %TEMP%) oraz gałęzi rejestru HKEY_CURRENT_USER.
Rozwiązanie:
W ustawieniach Puli Aplikacji BPM Serwerowej (IIS) należy ustawić parametr Load User Profile (Załaduj profil użytkownika) na True.
Należy zweryfikować, czy konto serwisowe posiada uprawnienia Modyfikacja/Zapis do katalogu, w którym mają być składowane logi.
Ustawienia zaawansowane puli aplikacji serwerowej
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?
Akceptacja Faktury kosztowej w Comarch BPM pobranej z Comarch ERP Optima
Zastosowanie
Scenariusz opisuje proces akceptacji dokumentów w systemie Comarch BPM, które zostały uprzednio pobrane z Krajowego Systemu e-Faktur (KSeF) do systemu Comarch ERP Optima. Głównym celem rozwiązania jest automatyzacja obiegu faktur kosztowych poprzez wyeliminowanie konieczności ręcznego przepisywania danych. Dzięki wykorzystaniu unikalnego identyfikatora dokumentu z bazy Comarch ERP Optima (VaN_VaNID), system Comarch BPM dynamicznie zaczytuje szczegółowe informacje bezpośrednio do kontrolek na karcie obiegu oraz kontrolki tabelarycznej ‘Elementy’.
Zawartość przykładu
Definicja Typu Obiegu (Workflow): Wzorcowa ścieżka obiegu dokumentu kosztowego z krokami akceptacji, konfiguracją kontrolki Dane tabelaryczne.
Proces automatyzacji opiera się na integracji bazy danych Comarch ERP Optima z procesem BPM:
Pobranie i Rejestracja (Optima): Dokument zostaje pobrany z bramki KSeF do Comarch ERP Optima. Na jego podstawie tworzony jest dokument w Rejestrze VAT (tabela CDN.VatNag).
Pobranie dokumentów przez Comarh BPM: Poprzez punkt ACD (Współpraca z dowolnym programem OCR ) do Comarch BPM zostają pobrane dokumenty z systemu Comarch ERP Optima.
Pobranie ID dokumentu: W punkcie ACD pobierany jest unikalny identyfikator dokumentu z bazy Comarch ERP Optima (VaN_VaNID).
Tworzenie dokumentów w Comarch BPM: Na podstawie pobranych danych z poziomu punktu ACD tworzone są dokumenty w Comarch BPM, w celu ich akceptacji.
Automatyczne uzupełnianie danych: Informacje w poszczególnych kontrolkach karty obiegu są uzupełniane automatycznie na podstawie ID dokumentu, zaczytanego w punkcie ACD. Wykorzystując ten unikalny klucz, system za pomocą zapytań SQL zaczytuje szczegółowe dane bezpośrednio z bazy Comarch ERP Optima.
Konfiguracja Punktu ACD
W celu umożliwienia akceptacji dokumentów pobranych z Comarch ERP Optima w systemie Comarch BPM skonfigurowano punkt o trybie współpracy: Współpraca z dowolnym programem OCR .
Tryb współpracy – Współpraca z dowolnym programem OCR
1.Zakładka Ogólne: Skonfigurowano połączenie do bazy Comarch ERP Optima, z której będą pobierane dokumenty.
Zakładka ogólna
W polu Połączenie do bazy po kliknięciu opcji Zmień, należy uzupełnić:
Nazwę serwera, na którym jest podpięta baza Comarch ERP Optima
Nazwę bazy danychComarch ERP Optima, z której mają być pobierane dokumenty
Użytkownika ODUSER zmapowanego z tą bazą
Hasło dla użytkownika ODUSER
Połączenie do bazy
Tworzenie tabeli: Utworzono tabelę poprzez kliknięcie opcji Utwórz tabelę, która przechowuje informacja o utworzonych dokumentach, podając login i hasło administratora bazy danych MS SQL.
Login i hasło administratora bazy danych MS SQL
2. Zakładka Lista: Wprowadzono poniższe zapytanie, które pobiera listę dokumentów gotowych do akceptacji oraz ich unikalne ID (VaN_VaNID):
BEGIN TRY
SELECT
V.VaN_VaNID,
V.VaN_Typ,
CONCAT(
V.VaN_Dokument, /*Numer dokumentu z rejestru */
' | ',
V.VaN_KntNazwa1, /* Nazwa kontrahenta */
' | ',
CONVERT(VARCHAR(10), V.VaN_DataZap, 104), /* Data wpływu */
' | KSeF: ',K.DKF_NumerKSeF /*Numer KSeF pobrany z tabeli DokumentyKSeF */
) AS [InformacjeWyswietlaneNaLiscie]
FROM
CDN.VatNag AS V
INNER JOIN
CDN.DokumentyKSeF AS K ON V.VaN_VaNID = K.DKF_VaNId
LEFT JOIN
dbo.DF_WorkAPProcess AS B1
ON B1.APW_DocumentID1 = V.VaN_Typ /*Rejestr zakupu w Optimie to 1 */
AND B1.APW_DocumentID2 = V.VaN_VaNID /*Mapowanie po VaNID */
AND B1.APW_APDId = @PointId@ /*ID punktu ACD z tabeli do.DF_ConfAPDictionary pobierany dynamicznie*/
WHERE
V.VaN_Typ = 1 /*Filtr: Rejestr Zakupów */
AND K.DKF_Typ = 1 /*Dokumenty KSeF typu zakupowego*/
AND B1.APW_ID IS NULL /*Wykluczamy już przeprocesowane */
ORDER BY
V.VaN_DataZap DESC;
END TRY
BEGIN CATCH
DECLARE @ErrorMessage varchar(max) = 'W zapytaniu wystąpił błąd: ' + ERROR_MESSAGE();
THROW 50001, @ErrorMessage ,1;
END CATCH
3. Zakładka Kontrolki: Dodano kontrolkę ID_VanID (ID_Optima) i przypisano jej zapytanie, które pobiera VANID dokumentu z Comarch ERP Optima:
Zakładka Kontrolki
Konfiguracja kontrolek na karcie obiegu
W definicji dokumentu, do każdej kontrolki przypisano zapytanie SQL, które na podstawie pobranego ID (przekazanego do parametru @ID_OPTIMA@) pobiera konkretne dane z bazy.
Przykładowe zapytania dla kontrolek:
Data wpływu:
select VaN_DataZap from CDN.VatNag where VaN_VaNID = @ID_OPTIMA@
Data zakupu:
select VaN_DataOpe from CDN.VatNag where VaN_VaNID = @ID_OPTIMA@
Data wystawienia:
select VaN_DataWys FROM CDN.VatNag where VaN_VaNID = @ID_OPTIMA@
Dokument:
select VaN_Dokument from CDN.VatNag where VaN_VaNID = @ID_OPTIMA@
Kontrahent:
select VaN_PodID from CDN.VatNag where VaN_VaNID = @ID_OPTIMA@
Waluta:
select W.WNa_WNaID , W.WNa_Symbol, W.WNa_WNaID
from CDN.VatNag AS V
JOIN CDN_KNF_KONFIGURACJA.CDN.WalNazwy as W /* Należy wskazać właściwą nazwę bazy konfiguracyjnej */
on ISNULL(NULLIF(V.VaN_Waluta, ''), 'PLN') = W.WNa_Symbol
where V.VaN_VaNID = @ID_OPTIMA@
Forma płatności:
select F.FPl_FPlId, F.FPl_Nazwa, F.FPl_FPlId from CDN.VatNag as V JOIN CDN.FormyPlatnosci as F ON
V.VAN_FPLID = F.FPL_FPLID where V.VaN_VaNID = @ID_OPTIMA@
Termin płatności:
select VaN_Termin from CDN.VatNag where VaN_VaNID = @ID_OPTIMA@
Numer rachunku bankowego:
select Van_PlatnikRachunekNr from CDN.VatNag where VaN_VaNID = @ID_OPTIMA@
Notatka:
select VaN_Opis from CDN.VatNag where VaN_VaNID = @ID_OPTIMA@
Rejestr:
select G.Gru_GruID, G.Gru_Nazwa,G.Gru_GruID from CDN.VatNag as V JOIN CDN.Grupy as G on V.VaN_Rejestr =
G.Gru_Nazwa where V.VaN_VaNID = @ID_OPTIMA@ AND G.Gru_Typ = 1
Kategoria:
select K.Kat_KatID, K.Kat_KodSzczegol, K.Kat_KatID from CDN.VatNag as V JOIN CDN.Kategorie as K on V.VaN_KatID = K.Kat_KatID
where V.VaN_VaNID = @ID_OPTIMA@
Opis Kategorii:
select K.Kat_Opis from CDN.VatNag as V JOIN CDN.Kategorie as K on V.VaN_KatID = K.Kat_KatID where
V.VaN_VaNID = @ID_OPTIMA@
Numer KSeF:
select DKF_NumerKSeF from CDN.DokumentyKSeF where DKF_VaNId = @ID_OPTIMA@
Data przyjęcia z KSeF:
select DKF_DataPozyskania from CDN.DokumentyKSeF where DKF_VaNId = @ID_OPTIMA@
Walidator:
select VaN_VaNID from cdn.VatNag where VaN_VaNID = @ID_OPTIMA@
Rejestr VAT zakupu:
select VaN_VaNID from cdn.VatNag where VaN_VaNID = @ID_OPTIMA@
Zapytanie do kontrolki Dane tabelaryczne Elementy:
IF @^SenderControlName@ = 'ID_OPTIMA' /*Identyfikator kontrolki do której pobierane jest ID dokumentu z Comarch ERP Optima */
BEGIN
SELECT
V.VaT_KatID AS [KategoriaID],
V.VaT_KatOpis AS [Kategoria],
V.VaT_Kat2ID AS [Kategoria2ID],
V.VaT_Kat2Opis AS [Kategoria2],
/* Pobieramy ID stawki ze słownika */
(SELECT TOP 1 K.Kon_KonId
FROM CDN_KNF_Konfiguracja.cdn.Konfig AS K
WHERE K.Kon_Numer = 301
AND K.Kon_Wartosc LIKE V.VaT_StawkaSymbol + '%') AS [StawkaID],
V.VaT_Netto AS [Netto],
V.VaT_VATWal,
(V.VaT_Netto + V.VaT_VAT) AS [Brutto],
V.VaT_RodzajZakupu AS [Rodzaj],
V.VaT_Odliczenia AS [Odliczenia]
FROM CDN.VatTab AS V
WHERE V.VaT_VaNID = @ID_OPTIMA@
END
Uzupełniony dokument w Comarch BPM
Dokumenty z Comarch ERP Optima zostały pobrane do punktu ACD i poprawnie zainicjowane w Comarch BPM.
Pobrane dokumenty w punkcie ACD
Dane na karcie obiegu zostały zaczytane dynamicznie z bazy Comarch ERP Optimana podstawie unikalnego identyfikatora ID__OPTIMA (VaN_VaNID). System wykorzystał ten klucz, aby wykonać zapytania SQL przypisane do poszczególnych kontrolek, co wyeliminowało konieczność ręcznego przepisywania danych z faktury.
Karta obiegu
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?
Podczas instalacji za pomocą Instalatora (Instalator Comarch BPM.exe) potrzebny jest dostęp do Internetu.
Instalacja – etapy początkowe
Instalację aplikacji serwerowej i WEB należy przeprowadzić na serwerze (komputerze) z zainstalowanym serwisem IIS (Internet Information Services).
W wersji 2023.0.0 wprowadzono nowe instalatory aplikacji web dla:
Comarch BPM (dawniej DMS) Standalone
Comarch BPM (dawniej DMS) we współpracy z Comarch ERP XL
Comarch BPM (dawniej DMS) we współpracy z Comarch ERP Optima
Od wersji 2023.0 istnieje również możliwość instalacji serwera bazodanowego Microsoft SQL Server Express z poziomu instalatora aplikacji Comarch BPM (dawniej DMS) (zob.Instalacja Microsoft SQL Server Express za pomocą instalatora Comarch BPM). Z poziomu instalatora aplikacji web można także przejść bezpośrednio do instalatora aplikacji desktop Comarch BPM (dawniej DMS).
Od wersji 2026.0.0 podczas instalacji Comarch BPM za pomocą instalatora zostaje zainstalowany Comarch sPrint.
Uwaga
Instalacje wersji WWW nie są zalecane na stacjach roboczych. Instalacja powinna być przeprowadzona na dedykowanym serwerze.
Aby uruchomić instalator Comarch BPM (dawniej DMS), w pobranym pakiecie instalacyjnym należy wejść do katalogu Comarch BPM [wersja] instalator Comarch BPM i uruchomić Instalator Comarch BPM.exe
Zostanie uruchomiony instalator aplikacji webowej, dzięki któremu możliwa jest:
Instalacja koniecznych komponentów serwera IIS
Konfiguracja puli na której będzie pracowała aplikacji Comarch BPM (dawniej DMS)
Instalacja i konfiguracja aplikacji Comarch BPM (dawniej DMS)
Aktualizacja aplikacji serwerowej i webowej Comarch BPM (dawniej DMS)
Instalacja serwera MongoDB (od wersji Comarch DMS 2024.2.0)
Instalacja i aktualizacja aplikacji Comarch BPM Repozytorium (od wersji Comarch DMS 2024.2.0)
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:
Polski
Angielski
Niemiecki
Francuski
Okno początkowe instalatora aplikacji web Comarch BPM (dawniej DMS) – wybór języka instalacji
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:
Komunikat, który zostanie wyświetlony po naciśnięciu przycisku „Anuluj” lub przy próbie zamknięcia okna instalatora
Jeśli użytkownik wybierze przycisk:
Tak – instalator zostanie zamknięty
Nie – użytkownik pozostanie w tym samym oknie, a komunikat będzie zamknięty
Od wersji 2026.0.0 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ż:
Windows 8×64
Windows 8 x86
Windows Server 2016 x64
Po kliknięciu w przycisk [OK] instalator zostaje zamknięty.
Komunikat informujący o braku możliwości instalacji Comarch BPM (dawniej DMS)
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.
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 SQL, wówczas przed przystąpieniem do instalacji aplikacji web powinien wybrać opcję InstalacjaMicrosoft SQL Server Express i kliknąć [Dalej]. Dalsze kroki opisano w artykule Instalacja Microsoft SQL Server Express za pomocą instalatora Comarch BPM.
Jeżeli użytkownik nie ma zainstalowanego serwera MongoDB, a chce korzystać z modułu Comarch BPM (dawniej DMS) Repozytorium, wówczas powinien wybrać opcję Instalacja serwera MongoDB i kliknąć [Dalej]. Dalsze kroki opisano w rozdziale Instalacja serwera Mongo DB za pomocą instalatora Comarch BPM .
W przypadku instalacji aplikacji Comarch BPM za pomocą instalatora korzystanie z opcji „Programowanie klucza HASP na serwerze Menadżera Kluczy” nie jest konieczne – programowanie klucza nastąpi podczas instalacji.
Wybór instalacji aplikacji web Comarch BPM (dawniej DMS) za pomocą instalatora
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:
Instalacja aplikacji Comarch BPM (zob. poniżej: Instalacja aplikacji Comarch BPM – aby instalować jedynie Comarch BPM (dawniej DMS);
Jeśli w oknie „Wybór aplikacji cd.” operator zaznaczył opcję „Instalacja aplikacji Comarch BPM”, a następnie [Dalej], wówczas następuje przejście do okna „Tryb pracy”.
Tryb pracy
W ramach okna Tryb pracy należy zaznaczyć opcję Współpraca z Comarch ERP XL; ta opcja umożliwia zainstalowanie Comarch BPM (dawniej DMS), w którym będzie możliwa praca w powiązaniu z Comarch ERP XL.
Po wyborze opcji należy kliknąć [Dalej], aby przejść do kolejnego kroku instalacji.
Okno „Tryb pracy” – wybór opcji współpracy z Comarch ERP XL
Warunki korzystania z oprogramowania
W ramach okna Warunki korzystania z oprogramowania 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.
Okno „Warunki korzystania z oprogramowania”
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:
Nacisnąć przycisk [Zainstaluj IIS] – nastąpi wówczas instalacja IIS. Podczas instalacji wyświetlany jest komunikat „ Trwa instalacja serwera IIS”. Po zakończonej instalacji przycisk „Zainstaluj IIS” zostaje wyszarzony i wyświetlany jest napis „Serwer IIS został poprawnie zainstalowany”.
Pozostawić otwarte okno instalatora Comarch BPM, zainstalować ręcznie IIS, a potem kliknąć [Odśwież]
Zamknąć instalator za pomocą przycisku [Anuluj] lub znaku x, wykonać ręczną instalację IIS i ponownie przejść przez kolejne kroki instalatora do okna „Internetowe usługi informacyjne (IIS)”
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].
Okno „Internetowe usługi informacyjne”, jeśli na danym komputerze dostępny jest serwer IIS
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:
Name – zawiera nazwę danego dodatku
Required – zawiera numer wymaganej wersji danego dodatku
Found – zawiera numer wersji danego dodatku zainstalowanej już na komputerze
Action – zawiera nieaktywny przycisk Pomiń – jeśli na komputerze jest już odpowiednia wersja i dany dodatek nie wymaga instalacji, wówczas jego instalacja zostanie automatycznie pominięta
Okno „Wymagane dodatki”
Aby zainstalować wymagane dodatki i przejść do następnego okna należy nacisnąć przycisk [Dalej].
Wybór puli aplikacji serwerowej
Od wersji 2025.0.0 dla aplikacji serwerowej i dla aplikacji WEB wymagane jest skonfigurowanie osobnych pul aplikacji. Wobec tego na kolejnym kroku, w oknie Pula dla aplikacji serwerowej należy określić, na jakiej puli aplikacji ma pracować aplikacja serwerowa Comarch BPM – w tym celu należy:
Wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią
lub
Dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „„Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji serwerowej BPM.
Uwaga
Pula aplikacji, na której ma pracować aplikacja serwerowa Comarch BPM (dawniej DMS) nie może być tą samą pulą, na której ma pracować aplikacja web Comarch BPM (dawniej DMS) .
Dodawanie puli „NowaPula”
Okno „Pula dla aplikacji serwerowej”, w którym wybrano pulę „DefaultAppPool”
Kiedy operator wybrał pulę aplikacji z listy albo dodał nową pulę i ją zaznaczył, wówczas następuje sprawdzenie, czy pula spełnia konieczne wymagania. Jeśli pod listą pul aplikacji zostanie wyświetlony komunikat:
Wybrana pula spełnia wymagania instalowanej aplikacji – można przejść do dalszego kroku instalacji Comarch BPM (dawniej DMS)
Wybrana pula nie spełnia wymagań instalowanej aplikacji – przed kontynuacją instalacji Comarch BPM należy wybrać inną pulę spełniającą wymagania lub dodać nową
Wybrana pula jest zatrzymana. Przed uruchomieniem aplikacji należy uruchomić pulę w Menedżerze IIS. – przed kontynuacją instalacji Comarch BPM należy uruchomić pulę aplikacji
Pula o tej nazwie już istnieje. – przed kontynuacją instalacji Comarch BPM należy wybrać inną pulę spełniającą wymagania lub dodać nową o innej nazwie
Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji, klikając przycisk [Dalej].
Kreowanie aplikacji serwerowej
Uwaga
Od wersji 2024.3.0 podczas instalacji Comarch BPM (dawniej DMS) za pomocą instalatora użytkownikowi IIS_IUSRS zostają nadane pełne uprawnienia na folderze aplikacji serwerowej.
Uwaga
Aplikacje: serwerowa i web powinny znajdować się na tej samej witrynie.
W tym oknie następuje konfiguracja aplikacji serwerowej (webowej starszego typu). W ramach okna Kreowanie aplikacji serwerowej użytkownik:
w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
w polu „Wprowadź nazwę aplikacji serwerowej” – wpisuje nadaną przez siebie nazwę aplikacji, np. BPMapi
Uwaga
W wersji 2025.2.0 wprowadzono walidację dodawanych nazw aplikacji: serwerowej i web 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.”.
Komunikat informujący o niepoprawnej nazwie aplikacji
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.
Okno „Kreowanie aplikacji serwerowej” po tym, jak aplikacja została utworzona
Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Nazwa witryny” i ponownie kliknąć [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.
Operator ma także opcję dodania nowej witryny, na której utworzy aplikację serwerową. W tym celu powinien:
W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;
W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny
Okno „Kreowanie aplikacji serwerowej” podczas dodawania nowej witryny
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.
Okno „Kreowanie aplikacji serwerowej” po pomyślnym dodaniu nowej witryny
Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].
Okno „Kreowanie aplikacji serwerowej”, gdy próbowano utworzyć nową witrynę o takiej samej nazwie jak już istniejąca
Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].
Okno „Kreowanie aplikacji serwerowej”, gdy próbowano utworzyć nową witrynę na porcie, który jest już wykorzystywany
Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.
Wybór puli aplikacji webowej
Od wersji 2025.0.0 dla aplikacji serwerowej i dla aplikacji WEB wymagane jest skonfigurowanie osobnych pul aplikacji. Z tego powodu na kolejnym kroku, w oknie Pula dla aplikacji WEB należy określić, na jakiej puli aplikacji ma pracować aplikacja web Comarch BPM (dawniej DMS) – w tym celu należy, podobnie jak w przypadku aplikacji serwerowej:
wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią
lub
dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji web BPM (dawniej DMS).
Uwaga
Pula aplikacji, na której ma pracować aplikacja WEB Comarch BPM (dawniej DMS) nie może być tą samą pulą, na której ma pracować aplikacja serwerowa Comarch BPM (dawniej DMS) .
Okno „Pula dla aplikacji WEB”, w którym dodano i wybrano pulę „bpm202520web"
Kiedy operator wybrał pulę aplikacji z listy albo dodał nową pulę i ją zaznaczył, wówczas następuje sprawdzenie, czy pula spełnia konieczne wymagania. Jeśli pod listą pul aplikacji zostanie wyświetlony komunikat:
Wybrana pula spełnia wymagania instalowanej aplikacji – można przejść do dalszego kroku instalacji Comarch BPM (dawniej DMS);
Wybrana pula nie spełnia wymagań instalowanej aplikacji – przed kontynuacją instalacji Comarch BPM należy wybrać inną pulę spełniającą wymagania lub dodać nową;
Wybrana pula jest zatrzymana. Przed uruchomieniem aplikacji należy uruchomić pulę w Menedżerze IIS. – przed kontynuacją instalacji Comarch BPM należy uruchomić pulę aplikacji;
Wybrana pula została wskazana we wcześniejszym kroku instalacji, na tę na której ma pracować aplikacja serwerowa. Aplikacja webowa wymaga wskazania innej puli. – przed kontynuacją instalacji Comarch BPM należy wybrać inna pulę, która spełnia wymagania albo dodać nową pulę;
Pula o tej nazwie już istnieje. – przed kontynuacją instalacji Comarch BPM należy wybrać inną pulę spełniającą wymagania lub dodać nową o innej nazwie.
Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji, klikając przycisk [Dalej].
Kreowanie aplikacji WEB
Uwaga
Konieczne jest, aby aplikacje: serwerowa i web znajdowały się na tej samej witrynie.
W tym oknie następuje konfiguracja aplikacji webowej z nowym interfejsem. W ramach okna Kreowanie aplikacji WEB użytkownik:
w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
w polu „Wprowadź nazwę aplikacji WEB” – wpisuje nadaną przez siebie nazwę aplikacji, np. BPMweb.
Uwaga
W wersji 2025.2.0 wprowadzono walidację dodawanych nazw aplikacji: serwerowej i web 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.”.
Komunikat informujący o niepoprawnej nazwie aplikacji
W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Wprowadź nazwę aplikacji WEB” 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.
Okno „Kreowanie aplikacji WEB” po tym, jak aplikacja została utworzona
Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Wybierz lub utwórz witrynę web” i ponownie kliknąć [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.
Operator ma także opcję dodania nowej witryny, na której utworzy aplikację WEB. W tym celu powinien:
W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;
W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny
Okno „Kreowanie aplikacji WEB” podczas dodawania nowej witryny
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.
Okno „Kreowanie aplikacji WEB” po pomyślnym dodaniu nowej witryny
Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].
Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę o takiej samej nazwie jak już istniejąca
Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].
Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę na porcie, który jest już wykorzystywany
Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.
Opcje instalacji
W następnym oknie „ Opcje instalacji” w ramach pola „Domyślny język instalowanej aplikacji” wybierany jest język, w którym wyświetlana będzie domyślnie aplikacja Comarch BPM (dawniej DMS).
Okno „Opcje instalacji” w przypadku instalacji Comarch BPM we współpracy z systemem Comarch ERP XL
Dostępne są również cztery parametry:
Utwórz osobną bazę danych dla Comarch BPM – domyślnie zaznaczony parametr; wyświetlany w przypadku instalacji Comarch BPM (dawniej DMS) we współpracy z systemami Comarch ERP. Jeżeli parametr zostanie odznaczony, wówczas system Comarch BPM będzie korzystał z bazy Comarch ERP XL
Opcja zmiany języka na ekranie logowania do aplikacji – jeżeli parametr zostanie zaznaczony, wówczas na ekranie logowania dostępny będzie link [aplikacja desktop] lub opcja [aplikacja webowa], po kliknięciu w które możliwy jest wybór z listy jednego z czterech języków aplikacji: polskiego, angielskiego, niemieckiego lub francuskiego. W przypadku zaznaczenia parametru dostępna jest również sekcja „Język aplikacji” na zakładce „Preferencje” w ramach zakładki „Ustawienia” w aplikacji web – w sekcji można wybrać język, w którym ma być wyświetlana aplikacja (dostępne są powyżej wymienione) ;
Wymagaj przestrzegania polityki mocnych haseł – domyślnie zaznaczony parametr; sprawia, że hasła ustawiane w aplikacji muszą spełniać określone warunki:
Składać się z min. 12 znaków
Zawierać cyfry
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Wersja Premium – opcja domyślnie zaznaczona; funkcjonalność modelowania procesów za pomocą kodu C# (w tym również dostęp do automatycznego trybu pracy - robotyzacji procesów) oraz dostęp do obsługi pobierania i wysyłki wiadomości z usługi e-Doręczenia[/su_list]
Uwaga
Od wersji 2023.0 w ramach instalatora nie jest już dostępne opcja:
Włącz funkcjonalność opisu analitycznego – opcja wyświetlana w poprzedniej wersji instalatora podczas instalacji Comarch DMS z Comarch ERP XL; aktualnie funkcjonalność opisu analitycznego jest domyślnie włączona
Po ustawieniu parametrów należy kliknąć na przycisk [Dalej], aby kontynuować instalację – jeżeli w ramach okna „Opcje instalacji” :
zaznaczono parametr „Utwórz osobną bazę danych dla Comarch BPM” – kolejnym krokiem instalacji jest przejście do okna „Baza danych Comarch BPM”
odznaczono parametr „Utwórz osobną bazę danych dla Comarch BPM” – wówczas następuje przejście bezpośrednio do okna „Baza danych Comarch ERP XL”.
Baza danych Comarch BPM
Poniżej przedstawiono kolejne kroki instalacji po kliknięciu przycisku [Dalej] w oknie „Opcje instalacji” , jeśli zaznaczono parametr „Utwórz osobną bazę danych dla Comarch BPM”
Po przejściu do okna „Baza danych Comarch BPM”należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:
Logowanie zintegrowane
lub
Logowanie SQL – jeśli wybrano tę opcję, należy podać:
W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
W polu „Hasło” – hasło użytkownika logującego się do serwera SQL
Uwaga
Hasło wprowadzane w polu „Hasło” nie może zawierać znaku ”
Okno „Baza danych Comarch BPM” przed uzupełnieniem danych
Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.
Okno „Baza danych Comarch BPM” po uzupełnieniu pola „Nazwa serwera”, wyborze typu logowania i naciśnięciu „Połącz”
Jeśli nawiązano połączenie z serwerem, użytkownik powinien kliknąć przycisk [Dodaj użytkownika], który został dodany w wersji 2025.0.0 w miejsce przycisku „Zmień hasło”. Przycisk [Dodaj użytkownika] umożliwia utworzenie nowego użytkownika bazodanowego.
Uwaga
We wcześniejszych wersjach instalatora tworzony był użytkownik SQL ODUser, służący do komunikacji z bazą danych. Od wersji 2025.0.0 operator samodzielnie nadaje login dla użytkownika SQL pełniącego taka funkcję.
Po kliknięciu w przycisk [Dodaj użytkownika] zostaje otwarte okno, w którym należy uzupełnić następujące pola:
Login – w tym polu operator powinien wpisać login nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server;
Hasło – w tym polu operator powinien wpisać hasło nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server;
Powtórz hasło – w ramach tego pola operator powinien powtórnie wprowadzić hasło nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server.
Uwaga
Zaleca się, aby login był unikalny dla każdej instalacji Comarch BPM (dawniej DMS).
Okno ustawienia loginu i hasła dla nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server
W przypadku, gdy operator wprowadził login i hasło użytkownika, którego login był już wykorzystywany dla innej instalacji na tym samym serwerze , a następnie kliknął w przycisk [Zapisz], wówczas w dolnej części zostanie wyświetlony komunikat ostrzegawczy „Wpisany login jest już wykorzystany do komunikacji z bazą danych na tym serwerze. Zalecamy zmianę loginu dla nowej instalacji”. Komunikat nie blokuje następnych kroków instalacji – po ponownym kliknięciu w przycisk [Zapisz] użytkownik z podanym loginem oraz hasłem zostanie utworzony.
Okno ustawienia loginu i hasła dla nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server w przypadku, gdy wprowadzono login i hasło użytkownika, którego login był już wykorzystywany dla innej instalacji na tym samym serwerze
Hasło powinno być silne – tzn. spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Hasło nie może zawierać następujących znaków:
;
‘
”
Jeżeli wpisano hasło, które nie spełnia któregoś z warunków dla silnego hasła, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane, użytkownik nie zostaje utworzony i wyświetlany jest komunikat:
Jeśli hasło jest za krótkie
Jeśli brakuje warunku/warunków wymaganych dla silnego hasła (przykładowo brak znaku specjalnego, brak wielkiej litery)
Jeśli zaś 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, operator nie zostaje utworzony i wyświetlany jest następujący komunikat:
Komunikat wyświetlany, jeśli hasła nie są zgodne
Po poprawnym uzupełnieniu pól oraz po kliknięciu przycisku [Zapisz] użytkownik z podanym loginem i hasłem zostaje utworzony, okno zamyka się, a w ramach okna „Baza danych Comarch BPM” wyświetlony zostaje napis „Nowy użytkownik został utworzony”.
Aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server za pomocą nowoutworzonego użytkownika – jego hasło i login zostają również wpisane w ramach wszystkich „connection string” w pliku Web.config znajdującym się w folderze z plikami aplikacji serwerowej.
Uwaga
Jeżeli definiujemy połączenia bazodanowe w trybie wielospółkowym, wówczas należy pamiętać, aby nowy login i hasło podać we wszystkich połączeniach definicji spółek.
Uwaga
Od wersji 2024.0.0 instalator szyfruje connection strings w pliku Web.config w katalogu aplikacji serwerowej (dawnej web).
Okno „Baza danych Comarch BPM” – widok po dodaniu nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL
Następnie użytkownik powinien nacisnąć przycisk [Dodaj bazę]. Wtedy zostanie otwarte okno, w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch BPM, a następnie kliknąć [Zapisz]. Jeżeli użytkownik nie chce jednak dodać nowej bazy, wtedy powinien nacisnąć przycisk [Anuluj] albo znak X.
Okno dodawania nowej bazy Comarch BPM
Po naciśnięciu przycisku [Zapisz] baza Comarch BPM zostaje dodana i w ramach instalatora wyświetla się informacja „Baza danych BPM została utworzona”.
Uwaga
Jeśli użytkownik instaluje Comarch BPM (dawniej DMS) po raz pierwszy, ma tylko możliwość dodania nowej bazy dla DMS – nie może dokonać wyboru z listy istniejących baz, jak w poprzednim instalatorze.
Uwaga
Od wersji 2024.0.0 instalator szyfruje connection strings w pliku Web.config w katalogu aplikacji serwerowej (dawnej web).
Dodawanie nowej bazy
Gdy baza danych została dodana, wówczas należy kliknąć przycisk [Uruchom skrypty] w celu przygotowania bazy Comarch BPM (dawniej DMS) do pracy. Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji – do okna „Baza danych Comarch ERP XL” (zob. poniżej rozdział Baza danych Comarch ERP XL).
Okno „Baza danych Comarch BPM” po pomyślnym wykonaniu skryptów
Baza danych Comarch ERP XL
W ramach okna „Baza danych Comarch ERP XL” należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:
Logowanie zintegrowane
lub
Logowanie SQL – jeśli wybrano tę opcję, należy podać:
W polu „Nazwa użytkownika”– nazwę użytkownika logującego się do serwera SQL – np. sa
W polu „Hasło” – hasło użytkownika logującego się do serwera SQL
Uwaga
Hasło wprowadzane w polu „Hasło” nie może zawierać znaku "
Okno „Baza danych Comarch ERP XL” przed uzupełnieniem danych
Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.
Jeśli:
Baza firmowa Comarch ERP XL i wcześniej połączona z aplikacją baza są na tym samym serwerze – wówczas po nawiązaniu połączenia z serwerem należy przejść do wyboru bazy w polu „Lista baz danych”
Okno „Baza danych Comarch ERP XL” po nawiązaniu połączenia z serwerem i wyborze bazy firmowej – jeśli baza Comarch ERP XL i wcześniej połączona z aplikacją baza są na tym samym serwerze
Baza Comarch ERP XL znajduje się na innym serwerze lub w oknie „Opcje instalacji” nie zaznaczono opcji „Utwórz osobną bazę danych dla Comarch BPM”– wtedy po nawiązaniu połączenia z serwerem konieczne jest kliknięcie w przycisk [Dodaj użytkownika]
Okno „Baza danych Comarch ERP XL” – widok po nawiązaniu połączenia z serwerem (gdy baza Comarch ERP XL jest na innym serwerze niż baza BPM (dawniej DMS) lub nie zaznaczono utworzenia osobnej bazy BPM)
Po kliknięciu w przycisk [Dodaj użytkownika] zostaje otwarte okno, w którym należy uzupełnić następujące pola:
Login – w tym polu operator powinien wpisać login nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server;
Hasło – w tym polu operator powinien wpisać hasło nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server;
Powtórz hasło – w ramach tego pola operator powinien powtórnie wprowadzić hasło nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server.
Uwaga
Zaleca się, aby login był unikalny dla każdej instalacji Comarch BPM (dawniej DMS).
Okno ustawienia loginu i hasła dla nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server
W przypadku, gdy operator wprowadził login i hasło użytkownika, którego login był już wykorzystywany dla innej instalacji na tym samym serwerze , a następnie kliknął w przycisk [Zapisz], wówczas w dolnej części zostanie wyświetlony komunikat ostrzegawczy „Wpisany login jest już wykorzystany do komunikacji z bazą danych na tym serwerze. Zalecamy zmianę loginu dla nowej instalacji”. Komunikat nie blokuje następnych kroków instalacji – po ponownym kliknięciu w przycisk [Zapisz] użytkownik z podanym loginem oraz hasłem zostanie utworzony.
Okno ustawienia loginu i hasła dla nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server w przypadku, gdy wprowadzono login i hasło użytkownika, którego login był już wykorzystywany dla innej instalacji na tym samym serwerze
Hasło powinno być silne – tzn. spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Hasło nie może zawierać następujących znaków:
;
‘
”
Jeżeli wpisano hasło, które nie spełnia któregoś z warunków dla silnego hasła, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane, użytkownik nie zostaje utworzony i wyświetlany jest komunikat:
Jeśli hasło jest za krótkie
Jeśli brakuje warunku/warunków wymaganych dla silnego hasła (przykładowo brak znaku specjalnego, brak wielkiej litery)
Jeśli zaś 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, operator nie zostaje utworzony i wyświetlany jest następujący komunikat:
Komunikat wyświetlany, jeśli hasła nie są zgodne
Po poprawnym uzupełnieniu pól oraz po kliknięciu przycisku [Zapisz] użytkownik z podanym loginem i hasłem zostaje utworzony, okno zamyka się, a w ramach okna „Baza danych Comarch ERP XL” wyświetlony zostaje napis „Nowy użytkownik został utworzony”.
Okno „Baza danych Comarch ERP XL” – widok po dodaniu nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL
Aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server za pomocą nowoutworzonego użytkownika – jego hasło i login zostają również wpisane w ramach wszystkich „connection string” w pliku Web.config znajdującym się w folderze z plikami aplikacji serwerowej.
Uwaga
Jeżeli definiujemy połączenia bazodanowe w trybie wielospółkowym, wówczas należy pamiętać, aby nowy login i hasło podać we wszystkich połączeniach definicji spółek.
Następnie należy przejść do wyboru bazy w polu „Lista baz danych”
W ramach pola „Lista baz danych” użytkownik powinien wybrać jedną z dostępnych baz Comarch ERP XL, a następnie kliknąć przycisk [Uruchom skrypty] w celu przystosowania bazy Comarch ERP XL do pracy z systemem Comarch BPM (dawniej DMS).
Uwaga
Dodanie nowej bazy firmowej Comarch ERP XL nie jest możliwe z poziomu instalatora Comarch BPM (dawniej DMS).
Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej] i przejść do okna „Klucze licencji i hasło Administratora”.
Klucze licencji i hasło Administratora
W ramach okna „Klucze licencji i hasło Administratora” należy:
w polu „Serwer klucza licencji Comarch BPM”wpisać klucz licencji Comarch BPM (dawniej DMS) zgodnie ze wzorem nazwa_serwera_klucza::numer_klucza
W polu „Serwer klucza licencji Comarch ERP XL”wpisać klucz licencji Comarch ERP XL zgodnie ze wzorem nazwa_serwera_klucza::numer_klucza
W polu „Hasło dla operatora Administrator" – pole wprowadzone w wersji 2025.1.0; w ramach tego pola należy wprowadzić hasło, jakim będzie się posługiwać operator Administrator podczas logowania do Comarch BPM (dawniej DMS)
W polu „Potwierdzenie hasła" – pole wprowadzone w wersji 2025.1.0; w ramach tego pola należy ponownie wprowadzić hasło, które wpisano w polu „Hasło dla operatora Administrator”
Hasło dla Administratora musi spełniać następujące warunki:
Składać się z co najmniej 12 znaków
Zawierać wielkie i małe litery
Zawierać cyfry
Zawierać znaki specjalne
Okno „Klucze licencji i hasło Administratora” ze wzorcem zapisu klucza licencji
W przypadku, jeśli:
W polu „Hasło dla operatora Administrator” wpisano zbyt krótkie hasło, wyświetlony zostaje następujący komunikat:
W polu „Hasło dla operatora Administrator” wpisano hasło, które nie spełnia wymogów silnego hasła (np. nie zawiera znaków specjalnych, cyfr), wyświetlony zostaje następujący komunikat:
W polu „Potwierdzenie hasła” wprowadzono inne hasło niż w polu „Hasło dla operatora Administrator”, wyświetlony zostaje następujący komunikat:
Hasło wprowadzone podczas instalacji zostanie zapisane w bazie – podczas pierwszego logowania do dowolnej aplikacji Comarch BPM konieczne będzie wprowadzenie oprócz loginu „Administrator” również tego hasła.
Podczas aktualizacji nie ma konieczności zmiany hasła albo wpisywania hasła dla operatora „Administrator”.
Uwaga
W ramach instalatora nie następuje weryfikacja klucza – jeśli wprowadzono niepoprawny klucz licencji, wystąpi błąd przy próbie logowania do aplikacji web Comarch BPM (dawniej DMS).
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:
xp_HASPAddKey
xp_HASPCheck
xp_HASPCheckWeb
xp_HASPGetAttributes
xp_HASPGetIdleTime
xp_HASPGetKeyInfo
xp_HASPGetKeyInfo2
xp_HASPGetKeyNumber
xp_HASPGetKeyNumberList
xp_HASPGetSignData
xp_HASPGetVersion
xp_HASPLicenceStateInfo
xp_HASPLicenceStateInfo2
xp_HASPLicenceStateInfoWeb
xp_HASPLoggedUsersInfo
xp_HASPLogin
xp_HASPLoginWeb
xp_HASPLogout
xp_HASPLogoutWeb
xp_HASPRefreshKeysData
xp_HASPSetIdleTime
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 i hasło Administratora” 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 1
W ramach okna „Baza danych Comarch BPM” wybrano bazę, która znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” wprowadzono klucz/klucze licencji, które również znajdują się na serwerze 1
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” zostanie utworzony login CDNHASPDMS[numer] (jeśli użytkownik istnieje na serwerze, login zostaje utworzony z pierwszym wolnym numerem loginu CDNHASPDMS[numer] – dla loginu zostaje nadane nowo wygenerowane hasło i sprawdzane 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.
Wariant 2 (dotyczy instalacji Comarch BPM we współpracy z Comarch ERP Optima lub Comarch ERP XL)
W ramach okna „Baza danych Comarch BPM” wybrano bazę, która znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” wprowadzono:
1 klucz licencji, który znajduje się na serwerze 1
oraz
1 klucz licencji, który znajduje się na serwerze 2
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” zostanie wyświetlone okno logowania do serwera 2. Następnie jeśli:
Nawiązano połączenie – w przypadku, gdy użytkownik istnieje już na serwerze 2, 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 2. ale po zamknięciu okna logowania do serwera 2 instalacja zostanie przerwana.
Okno logowania do serwera, gdy pomyślnie nawiązano połączenie
Wariant 3 (dotyczy instalacji Comarch BPM we współpracy z Comarch ERP Optima lub Comarch ERP XL)
W ramach okna „Baza danych Comarch BPM” wybrano bazę, która znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” wprowadzono klucze licencji, które znajdują się na serwerze 2
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” zostaje wyświetlone okno logowania do serwera 2. Następnie jeśli:
Nawiązano połączenie – w przypadku, gdy użytkownik istnieje już na serwerze 2, 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 2. ale po zamknięciu okna logowania do serwera instalacja zostanie przerwana.
Wariant 4 (dotyczy instalacji Comarch BPM we współpracy z Comarch ERP Optima lub Comarch ERP XL)
W ramach okna „Baza danych Comarch BPM” wybrano bazę, która znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” wprowadzono:
1 klucz licencji, który znajduje się na serwerze 2
oraz
1 klucz licencji, który znajduje się na serwerze 3
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” zostają wyświetlone okna logowania do obydwóch serwerów – do serwera 2 i do serwera 3. Następnie jeśli:
Nawiązano połączenie z obydwoma serwerami – 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 obydwóch serwerach kluczy 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 lub serwerach kluczy 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 z żadnym z serwerów lub tylko z jednym z serwerów– 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 aplikacji web Comarch DMS we współpracy z Comarch ERP XL
Po uzupełnieniu kluczy licencji i kliknięciu [Instaluj] następuje przejście do okna instalacji aplikacji web Comarch DMS.
Okno „Instalacja” , gdy trwa instalacja Comarch BPM
Koniec pracy instalatora
Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji web Comarch BPM. 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, zgodnie z nazwą aplikacji, którą podano w instalatorze.
Okno końcowe instalatora Comarch BPM
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
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?
Aktualizacja aplikacji serwerowej, aplikacji WEB i aplikacji Comarch BPM (dawniej DMS) Repozytorium za pomocą instalatora
Instalator Comarch BPM (dawniej DMS) umożliwia również aktualizację aplikacji serwerowej i aktualizację aplikacji WEB Comarch BPM oraz aktualizację aplikacji Comarch BPM Repozytorium.
Uwaga
Podczas aktualizacji za pomocą Instalatora (Instalator Comarch BPM (dawniej DMS).exe) potrzebny jest dostęp do Internetu.
Uwaga
Przed rozpoczęciem aktualizacji Comarch BPM (dawniej DMS) Repozytorium konieczne jest, aby wykonać backup bazy MongoDB – zob. Backup bazy danych MongoDB
W ramach okna początkowego dostępne jest pole Język instalatora – w ramach tego pola użytkownik wybiera język, w którym będą wyświetlane kolejne kroki instalatora.
Po wyborze odpowiedniej wartości w polu należy kliknąć [Dalej], aby przejść do kolejnego kroku aktualizacji.
Jeżeli użytkownik chce zrezygnować z aktualizacji, powinien wybrać przycisk [Anuluj] albo spróbować zamknąć okno za pomocą znaku x. Wówczas zostanie wyświetlony następujący komunikat:
Komunikat, który zostanie wyświetlony po naciśnięciu przycisku „Anuluj” lub przy próbie zamknięcia okna instalatora
Jeśli użytkownik wybierze przycisk:
Tak – instalator zostanie zamknięty
Nie – użytkownik pozostanie w tym samym oknie, a komunikat będzie zamknięty:
Ekran początkowy aktualizacji aplikacji web Comarch BPM (dawniej DMS)
W kolejnym oknie instalatora (po oknie przygotowywania komponentów) należy wybrać przycisk [Dalej], aby kontynuować aktualizację.
Drugie okno aktualizacji Comarch BPM (dawniej DMS) – ekran powitalny
Wybór aplikacji
Następnie aby zaktualizować aplikację Comarch BPM (dawniej DMS), należy w ramach okna „Wybór aplikacji” wybrać opcję „Aktualizacja aplikacji Comarch BPM (dawniej DMS) oraz Comarch BPM (dawniej DMS) Repozytorium” (od wersji 2024.2.0) i kliknąć [Dalej].
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 (dawniej DMS). W ramach pola dostępnego w prawej części okna dostępne są następujące kolumny:
Name – zawiera nazwę danego dodatku
Required – zawiera numer wymaganej wersji danego dodatku
Found – zawiera numer wersji danego dodatku zainstalowanej już na komputerze
Action – zawiera nieaktywny przycisk Pomiń – jeśli na komputerze jest już odpowiednia wersja i dany dodatek nie wymaga instalacji, wówczas jego instalacja zostanie automatycznie pominięta
Okno „Wymagane dodatki”
Aby zainstalować wymagane dodatki i przejść do następnego okna należy nacisnąć przycisk [Dalej].
Aktualizacja aplikacji serwerowej
Uwaga
W przypadku aktualizacji aplikacji Comarch BPM w wersji 2024.3.1 lub niższej za pomocą instalatora wydanego w ramach wersji 2025.0.0 pula aplikacji, na której do tej pory pracowały aplikacje: serwerowa i web Comarch BPM (dawniej DMS) zostanie dedykowana dla aplikacji serwerowej (Api) Comarch BPM.
Następnie zostaje otwarte okno Aktualizacja aplikacji serwerowej. W ramach tego okna dostępne są następujące pola:
Wybierz witrynę web – w tym polu użytkownik z listy dostępnych witryn wybiera witrynę, na której znajduje się aplikacja serwerowa (dawna web), która ma zostać zaktualizowana – domyślnie wyświetlana jest witryna Default Web Site;
Port – nieedytowalne pole numeru portu, widoczne jako wyszarzone;
Wybierz aplikację serwerową – w tym polu użytkownik z listy aplikacji dostępnych na danej witrynie wybiera tę aplikację serwerową (dawna web), która ma zostać zaktualizowana
Od wersji 2023.0.1 możliwa jest aktualizacja aplikacji web Comarch BPM (dawniej DMS) za pomocą instalatora w przypadku, jeśli dotychczasowa instalacja była wykonywana ręcznie i aplikacja web została zainstalowana bezpośrednio w witrynie.
Przykład aplikacji web zainstalowanej bezpośrednio w witrynie
W tym celu w ramach okna Aktualizacja aplikacji serwerowej w polu Wybierz aplikację serwerową dostępna jest opcja Aplikacja zainstalowana w witrynie.
Wybór aplikacji serwerowej zainstalowanej w witrynie do aktualizacji
Jeżeli użytkownik wybrał opcję Aplikacja zainstalowana w witrynie, wówczas aktualizacja plików aplikacji serwerowej (dawnej web) będzie się odbywać w folderze źródłowym witryny sieci web, który został wskazany w ustawieniach zaawansowanych witryny (Ogólne -> Ścieżka fizyczna).
Po wybraniu odpowiednich wartości w polach należy nacisnąć przycisk [Dalej], aby przejść do kolejnego okna.
Jeśli użytkownik wybrał w polu „Nazwa aplikacji” aplikację, która nie jest aplikacją serwerową Comarch BPM (dawniej DMS), wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch BPM. Wybierz odpowiednią aplikację.”.
Okno „Aktualizacja aplikacji serwerowej” po wyborze aplikacji do zaktualizowania (gdy aplikacja nie jest zainstalowana w witrynie)
Kiedy wybrano aplikację do aktualizacji, wówczas weryfikowany jest plik web.config. Od wersji 2023.0.1 jeśli w kluczu „MultiCompany” value= true, wówczas aktualizacja bazy Comarch BPM (dawniej DMS) zostaje przeprowadzona i zostaje wyświetlony następujący komunikat:
Komunikat wyświetlany podczas aktualizacji aplikacji Comarch BPM (dawniej DMS), która pracuje w trybie wielofirmowym
W przypadku, jeśli użytkownik naciśnie przycisk:
Anuluj – praca instalatora zostanie zakończona, zaś aktualizacja – przerwana
Ok – zostanie wykonana aktualizacja bazy BPM, a w kluczu MultiCompany zostaje zachowana wartość True
Następnie użytkownik przechodzi do okna „Pula dla aplikacji WEB”.
Wybór puli aplikacji webowej
Od wersji 2025.0.0 dla aplikacji serwerowej i dla aplikacji WEB wymagane jest skonfigurowanie osobnych pul aplikacji. Z tego powodu na kolejnym kroku, w oknie Pula dla aplikacji WEB należy określić, na jakiej puli aplikacji ma pracować aplikacja web Comarch BPM (dawniej DMS) – w tym celu należy, podobnie jak w przypadku aplikacji serwerowej:
wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią
lub
dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji web BPM (dawniej DMS).
Uwaga
Pula aplikacji, na której ma pracować aplikacja WEB Comarch BPM (dawniej DMS) nie może być tą samą pulą, na której ma pracować aplikacja serwerowa Comarch BPM (dawniej DMS).
Okno „Pula dla aplikacji WEB”, w którym dodano i wybrano pulę
Kiedy operator wybrał pulę aplikacji z listy albo dodał nową pulę i ją zaznaczył, wówczas następuje sprawdzenie, czy pula spełnia konieczne wymagania. Jeśli pod listą pul aplikacji zostanie wyświetlony komunikat:
Wybrana pula spełnia wymagania instalowanej aplikacji – można przejść do dalszego kroku instalacji Comarch BPM (dawniej DMS);
Wybrana pula nie spełnia wymagań instalowanej aplikacji – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy wybrać inną pulę spełniającą wymagania lub dodać nową;
Wybrana pula jest zatrzymana. Przed uruchomieniem aplikacji należy uruchomić pulę w Menedżerze IIS. – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy uruchomić pulę aplikacji;
Wybrana pula została wskazana we wcześniejszym kroku instalacji, na tę na której ma pracować aplikacja serwerowa. Aplikacja webowa wymaga wskazania innej puli. – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy wybrać inna pulę, która spełnia wymagania albo dodać nową pulę;
Pula o tej nazwie już istnieje. – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy wybrać inną pulę spełniającą wymagania lub dodać nową o innej nazwie.
Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji, klikając przycisk [Dalej].
Jeśli:
użytkownik utworzył już wcześniej aplikację WEB powiązaną z daną aplikacją serwerową, wówczas przechodzi do okna „Aktualizacja aplikacji WEB”
użytkownik nie utworzył jeszcze aplikacji WEB powiązanej z daną aplikacją serwerową, wówczas przechodzi do okna „Kreowanie aplikacji WEB”
Aktualizacja aplikacji WEB
Opcja aktualizacji aplikacji WEB za pomocą instalatora jest dostępna od wersji 2024.0.1. W ramach okna „Aktualizacja aplikacji WEB” należy:
w polu „Wybierz witrynę web” wybrać witrynę, na której znajduje się aplikacja WEB, która ma zostać zaktualizowana – domyślnie wyświetlana jest witryna Default Web Site;
w polu „Wybierz aplikację WEB” wybrać z listy aplikacji dostępnych na danej witrynie tę aplikację WEB (nowy web), która ma zostać zaktualizowana
a następnie kliknąć przycisk [Dalej], aby przejść do okna „Opcje aktualizacji”.
Okno „Aktualizacja aplikacji WEB” przed wyborem aplikacji WEB
Okno „Aktualizacja aplikacji WEB” po wyborze aplikacji WEB
Jeśli użytkownik wybrał w polu „Wybierz aplikację WEB” aplikację, która nie jest aplikacją serwerową Comarch BPM (dawniej DMS) , wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch BPM (dawniej DMS) . Wybierz odpowiednią aplikację.”.
Okno „Aktualizacja aplikacji WEB” po wyborze do zaktualizowania aplikacji, która nie jest aplikacją WEB
Kreowanie aplikacji WEB
Uwaga
Konieczne jest, aby aplikacje: serwerowa i web znajdowały się na tej samej witrynie.
W ramach tego okna dostępne są pola, w ramach których użytkownik:
w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
w polu „Wprowadź nazwę aplikacji WEB” – wpisuje nadaną przez siebie nazwę aplikacji, np. BPMweb.
Uwaga
W wersji 2025.2.0 wprowadzono walidację dodawanych nazw aplikacji: serwerowej i web 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.”.
Komunikat informujący o niepoprawnej nazwie aplikacji
W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Wprowadź nazwę aplikacji WEB” 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.
Okno „Kreowanie aplikacji WEB” po tym, jak aplikacja została utworzona
Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Wybierz lub utwórz witrynę web” i ponownie kliknąć [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.
Operator ma także opcję dodania nowej witryny, na której utworzy aplikację WEB. W tym celu powinien:
W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;
W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny
Okno „Kreowanie aplikacji WEB” podczas dodawania nowej witryny
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.
Okno „Kreowanie aplikacji WEB” po pomyślnym dodaniu nowej witryny
Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].
Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę o takiej samej nazwie jak już istniejąca
Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].
Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę na porcie, który jest już wykorzystywany
Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.
Po wybraniu odpowiednich wartości w polach należy nacisnąć przycisk [Dalej], aby przejść do okna „Opcje aktualizacji”.
Jeśli użytkownik wybrał w polu „Nazwa aplikacji” aplikację, która nie jest nową aplikacją web Comarch BPM (dawniej DMS), wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch BPM (dawniej DMS). Wybierz odpowiednią aplikację.”.
Opcje aktualizacji
W następnym oknie „ Opcje aktualizacji” w ramach pola „Domyślny język aktualizowanej aplikacji” wybierany jest język, w którym wyświetlana będzie domyślnie aplikacja Comarch BPM (dawniej DMS).
Okno „Opcje aktualizacji” w przypadku aktualizacji Comarch BPM (dawniej DMS) Standalone
Dostępne są również trzy parametry:
Opcja zmiany języka na ekranie logowania Comarch BPM (dawniej DMS) – jeżeli parametr zostanie zaznaczony, wówczas na ekranie logowania dostępny będzie link [aplikacja desktop] lub opcja [aplikacja webowa], po kliknięciu w które możliwy jest wybór z listy jednego z czterech języków aplikacji: polskiego, angielskiego, niemieckiego lub francuskiego. W przypadku zaznaczenia parametru dostępna jest również sekcja „Język aplikacji” na zakładce „Preferencje” w ramach zakładki „Ustawienia” w aplikacji web – w sekcji można wybrać język, w którym ma być wyświetlana aplikacja (dostępne są powyżej wymienione).
Wymagaj przestrzegania polityki mocnych haseł – domyślnie zaznaczony parametr; sprawia, że hasła ustawiane w aplikacji muszą spełniać określone warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Wersja Premium – opcja domyślnie zaznaczona; funkcjonalność modelowania procesów za pomocą kodu C# (w tym również dostęp do automatycznego trybu pracy – robotyzacji procesów) oraz dostęp do obsługi pobierania i wysyłki wiadomości z usługi e-Doręczenia.
Uwaga
Domyślnie opcje aktualizacji są zaznaczone tak, jak zaznaczono je podczas poprzedniej instalacji lub aktualizacji.
Po ustawieniu parametrów należy kliknąć na przycisk [Dalej], aby kontynuować aktualizację.
Baza danych Comarch BPM (dawniej DMS)
Po przejściu do okna „Baza danych Comarch BPM (dawniej DMS)” należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:
Logowanie zintegrowane
lub
Logowanie SQL – jeśli wybrano tę opcję, należy podać:
W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
W polu „Hasło” – hasło użytkownika logującego się do serwera SQL
Uwaga
Hasło wprowadzane w polu „Hasło” nie może zawierać znaku ”
Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.
Okno „Baza danych Comarch BPM”
Jeśli nawiązano połączenie z serwerem, w ramach pola „Lista baz danych” powinna być wybrana baza Comarch BPM (dawniej DMS), która jest właściwa dla danej aplikacji – domyślnie podpowiada się właściwa baza. W wersji 2025.0.0 dodano następujące elementy:
Pole „Użytkownik SQL dla Comarch BPM” – w ramach tego pola operator może wskazać utworzonego wcześniej użytkownika, który aktualnie komunikuje się z bazą danych. Po wyborze użytkownika przycisk [Zmień hasło] staje się aktywny. Zmiana hasła przy aktualizacji nie jest obowiązkowa, jeśli jednak operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL (zob. Zmiana hasła użytkownika SQL);
Przycisk [Dodaj użytkownika] – operator powinien nacisnąć ten przycisk, jeśli nie chce zmieniać hasła istniejącego użytkownika SQL, chce natomiast dodać nowego użytkownika SQL, za pośrednictwem którego aplikacja Comarch BPM (dawniej DMS) komunikuje się z bazą danych (zob. Dodawanie nowego użytkownika SQL).
Zmiana hasła użytkownika SQL
Jeśli operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL. W tym celu należy:
W polu „Hasło” wprowadzić nowe hasło dla wybranego użytkownika SQL
W polu „Powtórz hasło” wpisać ponownie nowe hasło dla wybranego użytkownika SQL, takie samo, jak w polu „Hasło”
Następnie operator powinien kliknąć przycisk [Zapisz].
Hasło powinno być silne – tzn. spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Hasło nie może zawierać następujących znaków:
;
‘
”
Okno zmiany hasła dla wybranego użytkownika SQL
Jeżeli wpisano hasło, które nie spełnia któregoś z warunków dla silnego hasła, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zmienione i wyświetlany jest odpowiedni komunikat, analogicznie jak w przypadku dodawania nowego użytkownika SQL.
Po poprawnym uzupełnieniu pól oraz po kliknięciu przycisku [Zapisz] hasło dla wybranego użytkownika SQL zostaje zmienione, okno zamyka się, a w ramach okna „Baza danych Comarch BPM (dawniej DMS)” wyświetlony zostaje napis „Hasło użytkownika bazy zostało zmienione”.
Okno „Baza danych Comarch BPM” po zmianie hasła dla wybranego użytkownika SQL
Uwaga
Jeżeli zmieniono hasło dla wybranego użytkownika SQL, wówczas w ramach danej aktualizacji nie można dodać nowego użytkownika serwera SQL – przycisk „Dodaj użytkownika” jest wyszarzony.
Dodawanie nowego użytkownika SQL
Po kliknięciu w przycisk [Dodaj użytkownika] zostaje otwarte okno, w którym należy uzupełnić następujące pola:
Login – w tym polu operator powinien wpisać login nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server;
Hasło – w tym polu operator powinien wpisać hasło nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server;
Powtórz hasło – w ramach tego pola operator powinien powtórnie wprowadzić hasło nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server.
Uwaga
Zaleca się, aby login był unikalny dla każdej instalacji Comarch BPM (dawniej DMS).
Hasło powinno być silne – tzn. spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Hasło nie może zawierać następujących znaków:
;
‘
”
Jeżeli wpisano hasło, które nie spełnia któregoś z warunków dla silnego hasła, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane, użytkownik nie zostaje utworzony i wyświetlany jest odpowiedni komunikat, analogicznie jak podczas instalacji aplikacji Comarch BPM (dawniej DMS).
Okno ustawienia loginu i hasła dla nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server
W przypadku, gdy operator wprowadził login i hasło użytkownika, którego login był już wykorzystywany dla innej instalacji na tym samym serwerze , a następnie kliknął w przycisk [Zapisz], wówczas w dolnej części zostanie wyświetlony komunikat ostrzegawczy „Wpisany login jest już wykorzystany do komunikacji z bazą danych na tym serwerze. Zalecamy zmianę loginu dla nowej instalacji”. Komunikat nie blokuje następnych kroków instalacji – po ponownym kliknięciu w przycisk [Zapisz] użytkownik z podanym loginem oraz hasłem zostanie utworzony.
Uwaga
W ramach aktualizacji operator może albo zmienić hasło, albo dodać nowego użytkownika SQL – nie może wykonać obydwóch tych akcji.
Operator może także nie podejmować żadnej z tych akcji i od razu po przejściu do okna oraz nawiązaniu połączenia z serwerem wybrać bazę w ramach pola „Lista baz danych”, a następnie kliknąć przycisk „Uruchom skrypty”
Jeżeli dodawanie nowego użytkownika SQL zakończy się sukcesem, wówczas pole „Użytkownik SQL dla Comarch BPM” zostanie zablokowane – operator nie będzie mógł zmienić hasła.
Okno „Baza danych Comarch BPM” – widok po utworzeniu nowego użytkownika SQL
Uruchamianie skryptów
Po wyborze bazy i (opcjonalnie) zmianie hasła dla istniejącego użytkownika SQL lub dodaniu nowego użytkownika SQL operator powinien nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch BPM (dawniej DMS). Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji:
Jeżeli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „false” – aplikacja Comarch DMS nie współpracuje z modułem Comarch DMS – następuje przejście do okna „Klucze licencji”
Jeżeli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „true” – następuje przejście do okna „Aktualizacja aplikacji Repozytorium”
Aktualizacja aplikacji 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 (dawniej DMS) Repozytorium.
Plik appsettings.json z zaszyfrowanymi connection strings
W ramach okna „Aktualizacja aplikacji Repozytorium” znajdują się następujące pola:
Wybierz witrynę web – w ramach tego pola operator powinien wybrać witrynę, na której znajduje się aplikacja Repozytorium do zaktualizowania (domyślnie wyświetlana jest witryna Default Web Site);
Port – pole numeru portu, wyszarzone i nieedytowalne;
Wybierz aplikację Repozytorium – w ramach tego pola operator powinien wybrać aplikację Repozytorium do zaktualizowania.
Następnie należy kliknąć [Dalej], aby przejść do kolejnego okna.
Okno „Aktualizacja aplikacji Repozytorium” przed wypełnieniem pól
Okno „Aktualizacja aplikacji Repozytorium” po wypełnieniu pól
Baza danych Comarch BPM Repozytorium
Następnie w ramach okna „Baza danych Comarch BPM (dawniej DMS) Repozytorium” operator powinien uzupełnić:
W ramach pola „Nazwa serwera” – nazwę serwera, na którym znajduje się serwer MongoDB;
Uwaga
Istnieje możliwość wprowadzenia w ramach pola „Nazwa serwera” IP serwera MongoDB.
W sekcji „Logowanie do serwera MongoDB”:
W ramach pola „Login” – login administratora MongoDB
W ramach pola „Hasło” – hasło administratora MongoDB
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”.
Okno „Baza danych Comarch BPM Repozytorium” przed uzupełnieniem pól
Okno „Baza danych Comarch BPM Repozytorium” po uzupełnieniu pól i kliknięciu w przycisk „Połącz”
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.
Okno „Baza danych Comarch BPM Repozytorium” z komunikatem „Wprowadzono nieprawidłowy adres serwera”
„Wprowadzono nieprawidłowe dane logowania” – komunikat wyświetlany, jeśli w polu „Login” i/lub „Hasło” wprowadzono niewłaściwe dane
Okno „Baza danych Comarch BPM Repozytorium” z komunikatem „Wprowadzono nieprawidłowe dane logowania”
Jeśli nawiązano połączenie z serwerem MongoDB, wówczas w ramach pola „Lista baz danych” powinna być wybrana baza Comarch BPM (dawniej DMS) Repozytorium odpowiednia dla danej aplikacji.
Nastepnie, opcjonalnie, operator może zmienić hasło dla użytkownika MongoUser, klikając przycisk [Zmień hasło].
W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser, dodanego do serwera MongoDB podczas pierwszej instalacji danej aplikacji Comarch DMs Repozytorium. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.
Okno zmiany hasła dla użytkownika MongoUser
Hasło powinno spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Login ani hasło nie mogą zawierać następujących znaków:
:
/
?
#
[
]
@
!
Od wersji 2024.2.2 można używać powyższych znaków w ramach loginu i/lub hasła.
Nie należy natomiast używać spacji w loginie ani w haśle.
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].
Okno „Baza danych Comarch BPM Repozytorium” po zmianie hasła dla użytkownika MongoUser
Po kliknięciu w przycisk [Dalej] następuje przejście do okna „Klucze licencji”.
Klucze licencji
W ramach okna „Klucze licencji” w polu „Serwer klucza licencji Comarch BPM (dawniej DMS)” zostaje automatycznie wpisany klucz licencji, pobrany z pliku web.config. W razie potrzeby użytkownik może wpisać ręcznie inne klucze licencji Comarch DMS zgodnie ze wzorem nazwa_serwera_klucza::numer_klucza.
Jeżeli operator aktualizuje również moduł Repozytorium, wówczas w ramach okna „Klucze licencji” dostępne jest także pole „Adres e-mail administratora”, w którym znajduje się adres email, który będzie widoczny w Comarch BPM (dawniej DMS) w komunikatach, w których wymagany jest kontakt z administratorem – automatycznie uzupełniony, ale dostępny do edycji.
Uwaga
W wersji 2025.2.0 podczas aktualizacji aplikacji Comarch BPM współpracującej z Comarch BPM Repozytorium pole „Adres e-mail administratora” jest niedostępne.
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 podczas aktualizacji aplikacji Comarch BPM..
W instalatorze po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” następuje sprawdzenie, czy podany klucz licencji jest na tym samym serwerze, gdzie znajduje się baza danych Comarch BPM.
Poniżej opisano możliwe warianty dalszego postępowania, w zależności od tego, czy baza danych Comarch BPM i klucze licencji znajdują się na tym samym, czy na różnych serwerach:
Wariant 1
Baza danych Comarch BPM znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” dokonano zmiany serwera klucza/kluczy licencji, które również znajdują się na serwerze 1
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” nastąpi próba zalogowania użytkownika CDNHASPDMS[numer]. Jeśli:
Logowanie zakończy się powodzeniem – wówczas możliwa jest dalsza aktualizacja aplikacji, po kliknięciu w przycisk „Instaluj”
Logowanie zakończy się niepowodzeniem – wówczas w przypadku, jeżeli:
Użytkownik istnieje na serwerze – zostanie dla niego wygenerowane nowe hasło, które zostanie zaktualizowane
Użytkownik nie istnieje na serwerze – 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ć aktualizację 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.
Wariant 2 (dla Comarch BPM Standalone)
Baza danych Comarch BPM znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” dokonano zmiany serwera klucza licencji, który znajduje się na serwerze 2
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” 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 – informacja o rezultacie próby połączenia z serwerem będzie widoczna w oknie logowania do serwera. 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ć aktualizację 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.
Okno logowania do serwera, gdy pomyślnie nawiązano połączenie
Po kliknięciu w przycisk [Instaluj], aby przejść do kolejnego kroku.
Okno „Klucze licencji” (gdy aplikacja nie współpracuje z Comarch BPM Repozytorium)
Okno „Klucze licencji” (gdy aplikacja współpracuje z Comarch BPM Repozytorium)
Uwaga
W ramach instalatora nie następuje weryfikacja klucza – jeśli wprowadzono niepoprawny klucz licencji, wystąpi błąd przy próbie logowania do aplikacji web Comarch BPM (dawniej DMS).
Aktualizowanie
Po uzupełnieniu klucza licencji i kliknięciu [Instaluj] następuje przejście do kolejnego okna „Aktualizowanie” i rozpoczyna się aktualizacja aplikacji web Comarch BPM (dawniej DMS).
Okno „Aktualizowanie”
Koniec pracy instalatora
Po dokonaniu aktualizacji wyświetlone zostanie końcowe okno instalatora. Kiedy 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ą podano w instalatorze.
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?
Aktualizacja aplikacji serwerowej, aplikacji WEB i aplikacji Comarch BPM (dawniej DMS) Repozytorium za pomocą instalatora
Instalator Comarch BPM (dawniej DMS) umożliwia również aktualizację aplikacji serwerowej i aktualizację aplikacji WEB Comarch BPM (dawniej DMS) oraz aktualizację aplikacji Comarch BPM (dawniej DMS) Repozytorium.
Uwaga
Przed rozpoczęciem aktualizacji Comarch BPM (dawniej DMS) Repozytorium konieczne jest, aby wykonać backup bazy MongoDB – zob. Backup bazy danych MongoDB
Uwaga
Podczas aktualizacji za pomocą Instalatora (Instalator Comarch BPM (dawniej DMS).exe) potrzebny jest dostęp do Internetu.
W ramach okna początkowego dostępne jest pole Język instalatora – w ramach tego pola użytkownik wybiera język, w którym będą wyświetlane kolejne kroki instalatora.
Po wyborze odpowiedniej wartości w polu należy kliknąć [Dalej], aby przejść do kolejnego kroku aktualizacji.
Jeżeli użytkownik chce zrezygnować z aktualizacji, powinien wybrać przycisk [Anuluj] albo spróbować zamknąć okno za pomocą znaku x. Wówczas zostanie wyświetlony następujący komunikat:
Komunikat, który zostanie wyświetlony po naciśnięciu przycisku „Anuluj” lub przy próbie zamknięcia okna instalatora
Jeśli użytkownik wybierze przycisk:
Tak – instalator zostanie zamknięty
Nie – użytkownik pozostanie w tym samym oknie, a komunikat będzie zamknięty
Ekran początkowy aktualizacji aplikacji web Comarch BPM (dawniej DMS)
W kolejnym oknie instalatora należy wybrać przycisk [Dalej], aby kontynuować aktualizację.
Drugie okno aktualizacji Comarch BPM (dawniej DMS) – ekran powitalny
Wybór aplikacji
Następnie aby zaktualizować aplikację Comarch BPM (dawniej DMS), należy w ramach okna „Wybór aplikacji” wybrać opcję „Aktualizacja aplikacji Comarch BPM oraz Comarch BPM Repozytorium” (od wersji 2024.2.0) i kliknąć [Dalej].
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 (dawniej DMS). W ramach pola dostępnego w prawej części okna dostępne są następujące kolumny:
Name – zawiera nazwę danego dodatku
Required – zawiera numer wymaganej wersji danego dodatku
Found – zawiera numer wersji danego dodatku zainstalowanej już na komputerze
Action – zawiera nieaktywny przycisk Pomiń – jeśli na komputerze jest już odpowiednia wersja i dany dodatek nie wymaga instalacji, wówczas jego instalacja zostanie automatycznie pominięta
Okno „Wymagane dodatki”
Aby zainstalować wymagane dodatki i przejść do następnego okna należy nacisnąć przycisk [Dalej].
Aktualizacja aplikacji serwerowej
Uwaga
W przypadku aktualizacji aplikacji Comarch BPM (dawniej DMS) w wersji 2024.3.1 lub niższej za pomocą instalatora wydanego w ramach wersji 2025.0.0 pula aplikacji, na której do tej pory pracowały aplikacje: serwerowa i web Comarch BPM (dawniej DMS) zostanie dedykowana dla aplikacji serwerowej (Api) Comarch BPM (dawniej DMS).
Następnie zostaje otwarte okno Aktualizacja aplikacji serwerowej. W ramach tego okna dostępne są następujące pola:
Wybierz witrynę web – w tym polu użytkownik z listy dostępnych witryn wybiera witrynę, na której znajduje się aplikacja serwerowa (dawna web), która ma zostać zaktualizowana – domyślnie wyświetlana jest witryna Default Web Site;
Port – nieedytowalne pole numeru portu, widoczne jako wyszarzone;
Wybierz aplikację serwerową – w tym polu użytkownik z listy aplikacji dostępnych na danej witrynie wybiera tę aplikację serwerową (dawna web), która ma zostać zaktualizowana
Od wersji 2023.0.1 możliwa jest aktualizacja aplikacji web Comarch BPM (dawniej DMS) za pomocą instalatora w przypadku, jeśli dotychczasowa instalacja była wykonywana ręcznie i aplikacja web została zainstalowana bezpośrednio w witrynie.
Przykład aplikacji web zainstalowanej bezpośrednio w witrynie
W tym celu w ramach okna Aktualizacja aplikacji serwerowej w polu Wybierz aplikację serwerową dostępna jest opcja Aplikacja zainstalowana w witrynie.
Wybór aplikacji serwerowej zainstalowanej w witrynie do aktualizacji
Jeżeli użytkownik wybrał opcję Aplikacja zainstalowana w witrynie, wówczas aktualizacja plików aplikacji serwerowej (dawnej web) będzie się odbywać w folderze źródłowym witryny sieci web, który został wskazany w ustawieniach zaawansowanych witryny (Ogólne -> Ścieżka fizyczna).
Po wybraniu odpowiednich wartości w polach należy nacisnąć przycisk [Dalej], aby przejść do kolejnego okna.
Jeśli użytkownik wybrał w polu „Nazwa aplikacji” aplikację, która nie jest aplikacją serwerową Comarch BPM (dawniej DMS), wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch BPM. Wybierz odpowiednią aplikację.”.
Okno „Aktualizacja aplikacji serwerowej” po wyborze aplikacji do zaktualizowania (gdy aplikacja nie jest zainstalowana w witrynie)
Kiedy wybrano aplikację do aktualizacji, wówczas weryfikowany jest plik web.config. Od wersji 2023.0.1 jeśli w kluczu „MultiCompany” value= true, wówczas aktualizacja bazy Comarch BPM (dawniej DMS) zostaje przeprowadzona i zostaje wyświetlony następujący komunikat:
Komunikat wyświetlany podczas aktualizacji aplikacji Comarch BPM (dawniej DMS), która pracuje w trybie wielofirmowym
W przypadku, jeśli użytkownik naciśnie przycisk:
Anuluj – praca instalatora zostanie zakończona, zaś aktualizacja – przerwana
Ok – zostanie wykonana aktualizacja bazy BPM (dawniej DMS), a w kluczu MultiCompany zostaje zachowana wartość True
Następnie użytkownik przechodzi do okna „Pula dla aplikacji WEB”.
Wybór puli aplikacji webowej
Od wersji 2025.0.0 dla aplikacji serwerowej i dla aplikacji WEB wymagane jest skonfigurowanie osobnych pul aplikacji. Z tego powodu na kolejnym kroku, w oknie Pula dla aplikacji WEB należy określić, na jakiej puli aplikacji ma pracować aplikacja web Comarch BPM (dawniej DMS) – w tym celu należy, podobnie jak w przypadku aplikacji serwerowej:
wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią
lub
dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji web BPM (dawniej DMS).
Uwaga
Pula aplikacji, na której ma pracować aplikacja WEB Comarch BPM (dawniej DMS) nie może być tą samą pulą, na której ma pracować aplikacja serwerowa Comarch BPM (dawniej DMS).
Okno „Pula dla aplikacji WEB”, w którym dodano i wybrano pulę
Kiedy operator wybrał pulę aplikacji z listy albo dodał nową pulę i ją zaznaczył, wówczas następuje sprawdzenie, czy pula spełnia konieczne wymagania. Jeśli pod listą pul aplikacji zostanie wyświetlony komunikat:
Wybrana pula spełnia wymagania instalowanej aplikacji – można przejść do dalszego kroku instalacji Comarch BPM (dawniej DMS);
Wybrana pula nie spełnia wymagań instalowanej aplikacji – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy wybrać inną pulę spełniającą wymagania lub dodać nową;
Wybrana pula jest zatrzymana. Przed uruchomieniem aplikacji należy uruchomić pulę w Menedżerze IIS. – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy uruchomić pulę aplikacji;
Wybrana pula została wskazana we wcześniejszym kroku instalacji, na tę na której ma pracować aplikacja serwerowa. Aplikacja webowa wymaga wskazania innej puli. – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy wybrać inną pulę, która spełnia wymagania albo dodać nową pulę;
Pula o tej nazwie już istnieje. – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy wybrać inną pulę spełniającą wymagania lub dodać nową o innej nazwie.
Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji, klikając przycisk [Dalej].
Jeśli:
użytkownik utworzył już wcześniej aplikację WEB powiązaną z daną aplikacją serwerową, wówczas przechodzi do okna „Aktualizacja aplikacji WEB”
użytkownik nie utworzył jeszcze aplikacji WEB powiązanej z daną aplikacją serwerową, wówczas przechodzi do okna „Kreowanie aplikacji WEB”
Aktualizacja aplikacji WEB
Opcja aktualizacji aplikacji WEB za pomocą instalatora jest dostępna od wersji 2024.0.1. W ramach okna „Aktualizacja aplikacji WEB” należy:
w polu „Wybierz witrynę web” wybrać witrynę, na której znajduje się aplikacja WEB, która ma zostać zaktualizowana – domyślnie wyświetlana jest witryna Default Web Site;
w polu „Wybierz aplikację WEB” wybrać z listy aplikacji dostępnych na danej witrynie tę aplikację WEB (nowy web), która ma zostać zaktualizowana
a następnie kliknąć przycisk [Dalej], aby przejść do okna „Opcje aktualizacji”.
Okno „Aktualizacja aplikacji WEB” przed wyborem aplikacji WEB
Okno „Aktualizacja aplikacji WEB” po wyborze aplikacji WEB
Jeśli użytkownik wybrał w polu „Wybierz aplikację WEB” aplikację, która nie jest aplikacją serwerową Comarch BPM (dawniej DMS), wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch BPM. Wybierz odpowiednią aplikację.”.
Okno „Aktualizacja aplikacji WEB” po wyborze do zaktualizowania aplikacji, która nie jest aplikacją WEB
Kreowanie aplikacji WEB
Uwaga
Konieczne jest, aby aplikacje: serwerowa i web znajdowały się na tej samej witrynie.
W ramach tego okna dostępne są pola, w ramach których użytkownik:
w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
w polu „Wprowadź nazwę aplikacji WEB” – wpisuje nadaną przez siebie nazwę aplikacji, np. BPMweb.
Uwaga
W wersji 2025.2.0 wprowadzono walidację dodawanych nazw aplikacji: serwerowej i web 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.”.
Komunikat informujący o niepoprawnej nazwie aplikacji
W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Wprowadź nazwę aplikacji WEB” 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.
Okno „Kreowanie aplikacji WEB” po tym, jak aplikacja została utworzona
Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Wybierz lub utwórz witrynę web” i ponownie kliknąć [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.
Operator ma także opcję dodania nowej witryny, na której utworzy aplikację WEB. W tym celu powinien:
W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;
W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny
Okno „Kreowanie aplikacji WEB” podczas dodawania nowej witryny
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.
Okno „Kreowanie aplikacji WEB” po pomyślnym dodaniu nowej witryny
Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].
Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę o takiej samej nazwie jak już istniejąca
Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].
Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę na porcie, który jest już wykorzystywany
Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.
Po wybraniu odpowiednich wartości w polach należy nacisnąć przycisk [Dalej], aby przejść do okna „Opcje aktualizacji”.
Jeśli użytkownik wybrał w polu „Nazwa aplikacji” aplikację, która nie jest nową aplikacją WEB Comarch BPM (dawniej DMS), wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch BPM (dawniej DMS). Wybierz odpowiednią aplikację.”.
Opcje aktualizacji
W następnym oknie „ Opcje aktualizacji” w ramach pola „Domyślny język aktualizowanej aplikacji” wybierany jest język, w którym wyświetlana będzie domyślnie aplikacja Comarch BPM (dawniej DMS).
Okno „Opcje aktualizacji” w przypadku aktualizacji Comarch BPM (dawniej DMS) we współpracy z Comarch ERP Optima
Dostępne są również trzy parametry:
Opcja zmiany języka na ekranie logowania do Comarch BPM – jeżeli parametr zostanie zaznaczony, wówczas na ekranie logowania dostępny będzie link [aplikacja desktop] lub opcja [aplikacja webowa], po kliknięciu w które możliwy jest wybór z listy jednego z czterech języków aplikacji: polskiego, angielskiego, niemieckiego lub francuskiego. W przypadku zaznaczenia parametru dostępna jest również sekcja „Język aplikacji” na zakładce „Preferencje” w ramach zakładki „Ustawienia” w aplikacji web – w sekcji można wybrać język, w którym ma być wyświetlana aplikacja (dostępne są powyżej wymienione);
Wymagaj przestrzegania polityki mocnych haseł – domyślnie zaznaczony parametr; sprawia, że hasła ustawiane w aplikacji muszą spełniać określone warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Wersja Premium – opcja domyślnie zaznaczona; funkcjonalność modelowania procesów za pomocą kodu C# (w tym również dostęp do automatycznego trybu pracy – robotyzacji procesów) oraz dostęp do obsługi pobierania i wysyłki wiadomości z usługi e-Doręczenia.
Uwaga
Domyślnie opcje aktualizacji są zaznaczone tak, jak zaznaczono je podczas poprzedniej instalacji lub aktualizacji.
Po ustawieniu parametrów należy kliknąć na przycisk [Dalej], aby kontynuować aktualizację.
Baza danych Comarch BPM
Jeśli podczas instalacji utworzono osobną bazę danych dla Comarch BPM (dawniej DMS), wówczas następuje przejście do okna „Baza danych Comarch BPM”, gdzie należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:
Logowanie zintegrowane
lub
Logowanie SQL – jeśli wybrano tę opcję, należy podać:
W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
W polu „Hasło” – hasło użytkownika logującego się do serwera SQL
Uwaga
Hasło wprowadzane w polu „Hasło” nie może zawierać znaku ”
Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.
Okno „Baza danych Comarch BPM”
Jeśli nawiązano połączenie z serwerem, w ramach pola „Lista baz danych” powinna być wybrana baza Comarch BPM (dawniej DMS), która jest właściwa dla danej aplikacji – domyślnie podpowiada się właściwa baza. W wersji 2025.0.0 dodano następujące elementy:
Pole „Użytkownik SQL dla Comarch BPM” – w ramach tego pola operator może wskazać utworzonego wcześniej użytkownika, który aktualnie komunikuje się z bazą danych. Po wyborze użytkownika przycisk [Zmień hasło] staje się aktywny. Zmiana hasła przy aktualizacji nie jest obowiązkowa, jeśli jednak operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL (zob. Zmiana hasła użytkownika SQL);
Przycisk [Dodaj użytkownika] – operator powinien nacisnąć ten przycisk, jeśli nie chce zmieniać hasła istniejącego użytkownika SQL, chce natomiast dodać nowego użytkownika SQL, za pośrednictwem którego aplikacja Comarch BPM (dawniej DMS) komunikuje się z bazą danych (zob. Dodawanie nowego użytkownika SQL).
Zmiana hasła użytkownika SQL
Jeśli operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL. W tym celu należy:
W polu „Hasło” wprowadzić nowe hasło dla wybranego użytkownika SQL
W polu „Powtórz hasło” wpisać ponownie nowe hasło dla wybranego użytkownika SQL, takie samo, jak w polu „Hasło”
Następnie operator powinien kliknąć przycisk [Zapisz].
Hasło powinno być silne – tzn. spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Hasło nie może zawierać następujących znaków:
;
‘
”
Okno zmiany hasła dla wybranego użytkownika SQL
Jeżeli wpisano hasło, które nie spełnia któregoś z warunków dla silnego hasła, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zmienione i wyświetlany jest odpowiedni komunikat, analogicznie jak w przypadku dodawania nowego użytkownika SQL.
Po poprawnym uzupełnieniu pól oraz po kliknięciu przycisku [Zapisz] hasło dla wybranego użytkownika SQL zostaje zmienione, okno zamyka się, a w ramach okna „Baza danych Comarch BPM” wyświetlony zostaje napis „Hasło użytkownika bazy zostało zmienione”.
Okno „Baza danych Comarch BPM” po zmianie hasła dla wybranego użytkownika SQL
Uwaga
Jeżeli zmieniono hasło dla wybranego użytkownika SQL, wówczas w ramach danej aktualizacji nie można dodać nowego użytkownika serwera SQL – przycisk „Dodaj użytkownika” jest wyszarzony.
Dodawanie nowego użytkownika SQL
Po kliknięciu w przycisk [Dodaj użytkownika] zostaje otwarte okno, w którym należy uzupełnić następujące pola:
Login – w tym polu operator powinien wpisać login nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server;
Hasło – w tym polu operator powinien wpisać hasło nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server;
Powtórz hasło – w ramach tego pola operator powinien powtórnie wprowadzić hasło nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server.
Uwaga
Zaleca się, aby login był unikalny dla każdej instalacji Comarch BPM (dawniej DMS).
Hasło powinno być silne – tzn. spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Hasło nie może zawierać następujących znaków:
;
‘
”
Jeżeli wpisano hasło, które nie spełnia któregoś z warunków dla silnego hasła, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane, użytkownik nie zostaje utworzony i wyświetlany jest odpowiedni komunikat, analogicznie jak podczas instalacji aplikacji Comarch BPM (dawniej DMS).
Okno ustawienia loginu i hasła dla nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server
W przypadku, gdy operator wprowadził login i hasło użytkownika, którego login był już wykorzystywany dla innej instalacji na tym samym serwerze , a następnie kliknął w przycisk [Zapisz], wówczas w dolnej części zostanie wyświetlony komunikat ostrzegawczy „Wpisany login jest już wykorzystany do komunikacji z bazą danych na tym serwerze. Zalecamy zmianę loginu dla nowej instalacji”. Komunikat nie blokuje następnych kroków instalacji – po ponownym kliknięciu w przycisk [Zapisz] użytkownik z podanym loginem oraz hasłem zostanie utworzony.
Uwaga
W ramach aktualizacji operator może albo zmienić hasło, albo dodać nowego użytkownika SQL – nie może wykonać obydwóch tych akcji.
Operator może także nie podejmować żadnej z tych akcji i od razu po przejściu do okna oraz nawiązaniu połączenia z serwerem wybrać bazę w ramach pola „Lista baz danych”, a następnie kliknąć przycisk „Uruchom skrypty”
Jeżeli dodawanie nowego użytkownika SQL zakończy się sukcesem, wówczas pole „Użytkownik SQL dla Comarch BPM” zostanie zablokowane – operator nie będzie mógł zmienić hasła.
Okno „Baza danych Comarch BPM” – widok po utworzeniu nowego użytkownika SQL
Uruchamianie skryptów
Po wyborze bazy i (opcjonalnie) zmianie hasła dla istniejącego użytkownika SQL lub dodaniu nowego użytkownika SQL operator powinien nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch BPM (dawniej DMS). Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji – do okna „Konfiguracyjna baza danych Comarch ERP Optima”.
Uwaga
Jeśli Comarch BPM (dawniej DMS) pracuje w trybie wielofirmowym (w pliku web.config klucz <add key=”MultiCompany” value=”true” />), wówczas po etapie „Baza danych Comarch BPM” następuje przejście bezpośrednio do okna „Klucze licencji” – na bazach: konfiguracyjnej i firmowej Comarch ERP Optima należy uruchomić skrypty ręcznie, zgodnie z rozdziałem Aktualizacja aplikacji web w trybie ręcznym.
Konfiguracyjna baza danych Comarch ERP Optima
W ramach okna „Konfiguracyjna baza danych Comarch ERP Optima” należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:
Logowanie zintegrowane
lub
Logowanie SQL – jeśli wybrano tę opcję, należy podać:
W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
W polu „Hasło” – hasło użytkownika logującego się do serwera SQL
Uwaga
Hasło wprowadzane w polu „Hasło” nie może zawierać znaku ”
Okno „Konfiguracyjna baza danych Comarch ERP Optima”
Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.
Od wersji 2025.0.0 w przypadku jeśli:
baza Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch BPM (dawniej DMS) albo w oknie „Opcje instalacji” zaznaczono opcję „Utwórz osobną bazę danych dla Comarch BPM”, po połaczeniu z serwerem użytkownik powinien w ramach pola „Lista baz danych” wybrać bazę konfiguracyjną Comarch ERP Optima, która ma zostać zaktualizowana, a później nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch ERP Optima.
Okno „Konfiguracyjna baza danych Comarch ERP Optima” po nawiązaniu połączenia z serwerem i wyborze bazy konfiguracyjnej (gdy baza konfiguracyjna Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch BPM (dawniej DMS) albo w oknie „Opcje instalacji” zaznaczono opcję „Utwórz osobną bazę danych dla Comarch BPM”)
baza Comarch ERP Optima znajduje się na innym serwerze niż baza Comarch BPM (dawniej DMS) albo w oknie „Opcje instalacji” nie zaznaczono opcji „Utwórz osobną bazę danych dla Comarch BPM”, wówczas po połączeniu z serwerem w ramach okna „Konfiguracyjna baza danych Comarch ERP Optima” dostępne są:
Pole „Użytkownik SQL dla Comarch BPM” – w ramach tego pola operator może wskazać utworzonego wcześniej użytkownika, który aktualnie komunikuje się z bazą danych. Po wyborze użytkownika przycisk [Zmień hasło] staje się aktywny. Zmiana hasła przy aktualizacji nie jest obowiązkowa, jeśli jednak operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL (zob. Zmiana hasła użytkownika SQL);
Przycisk [Dodaj użytkownika] – operator powinien nacisnąć ten przycisk, jeśli nie chce zmieniać hasła istniejącego użytkownika SQL, chce natomiast dodać nowego użytkownika SQL, za pośrednictwem którego aplikacja Comarch BPM (dawniej DMS) komunikuje się z bazą danych (zob. Dodawanie nowego użytkownika SQL).
.
Uwaga
W ramach aktualizacji operator może albo zmienić hasło, albo dodać nowego użytkownika SQL – nie może wykonać obydwóch tych akcji.
Operator może także nie podejmować żadnej z tych akcji i od razu po przejściu do okna oraz nawiązaniu połączenia z serwerem wybrać bazę w ramach pola „Lista baz danych”, a następnie kliknąć przycisk „Uruchom skrypty”
Jeżeli dodawanie nowego użytkownika SQL zakończy się sukcesem, wówczas pole „Użytkownik SQL dla Comarch BPM” zostanie zablokowane – operator nie będzie mógł zmienić hasła.
Okno „Konfiguracyjna baza danych Comarch ERP Optima” po nawiązaniu połączenia z serwerem i wyborze bazy konfiguracyjnej (gdy baza konfiguracyjna Comarch ERP Optima znajduje się na innym serwerze niż baza Comarch BPM (dawniej DMS) albo w oknie „Opcje instalacji” nie zaznaczono opcji „Utwórz osobną bazę danych dla Comarch BPM”)
Uruchamianie skryptów
Po ewentualnym dokonaniu zmian i wyborze bazy konfiguracyjnej nalezy nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy konfiguracyjnej Comarch ERP Optima.
Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji – do okna „Firmowa baza danych Comarch ERP Optima”.
Okno instalatora po pomyślnym wykonaniu skryptów na bazie konfiguracyjnej Comarch ERP Optima (gdy baza konfiguracyjna Comarch ERP Optima znajduje się na tym samym serwerze co baza ComarchBPM (dawniej DMS) albo w oknie „Opcje instalacji” zaznaczono opcję „Utwórz osobną bazę danych dla Comarch BPM”)
Firmowa baza danych Comarch ERP Optima
W ramach okna „Firmowa baza danych Comarch ERP Optima” należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:
Logowanie zintegrowane
lub
Logowanie SQL – jeśli wybrano tę opcję, należy podać:
W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
W polu „Hasło” – hasło użytkownika logującego się do serwera SQL
Uwaga
Hasło wprowadzane w polu „Hasło” nie może zawierać znaku ”
Okno „Firmowa baza danych Comarch ERP Optima”
Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.
Od wersji 2025.0.0 w przypadku jeśli:
baza firmowa Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch BPM (dawniej DMS) lub baza konfiguracyjna Comarch ERP Optima, po połaczeniu z serwerem użytkownik powinien w ramach pola „Lista baz danych” wybrać bazę firmową Comarch ERP Optima, która ma zostać zaktualizowana, a później nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch ERP Optima.
Okno „Firmowa baza danych Comarch ERP Optima” po nawiązaniu połączenia z serwerem i wyborze bazy firmowej ( gdy baza firmowa Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch BPM (dawniej DMS) lub baza konfiguracyjna Comarch ERP Optima)
baza Comarch ERP Optima znajduje się na innym serwerze niż baza Comarch BPM (dawniej DMS) lub baza konfiguracyjna Comarch ERP Optima, wówczas po połączeniu z serwerem w ramach okna Firmowa baza danych Comarch ERP Optima” dostępne są:
Pole „Użytkownik SQL dla Comarch BPM” – w ramach tego pola operator może wskazać utworzonego wcześniej użytkownika, który aktualnie komunikuje się z bazą danych. Po wyborze użytkownika przycisk [Zmień hasło] staje się aktywny. Zmiana hasła przy aktualizacji nie jest obowiązkowa, jeśli jednak operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL (zob. Zmiana hasła użytkownika SQL);
Przycisk [Dodaj użytkownika] – operator powinien nacisnąć ten przycisk, jeśli nie chce zmieniać hasła istniejącego użytkownika SQL, chce natomiast dodać nowego użytkownika SQL, za pośrednictwem którego aplikacja Comarch BPM (dawniej DMS) komunikuje się z bazą danych (zob. Dodawanie nowego użytkownika SQL).
Uwaga
W ramach aktualizacji operator może albo zmienić hasło, albo dodać nowego użytkownika SQL – nie może wykonać obydwóch tych akcji.
Operator może także nie podejmować żadnej z tych akcji i od razu po przejściu do okna oraz nawiązaniu połączenia z serwerem wybrać bazę w ramach pola „Lista baz danych”, a następnie kliknąć przycisk „Uruchom skrypty”
Jeżeli dodawanie nowego użytkownika SQL zakończy się sukcesem, wówczas pole „Użytkownik SQL dla Comarch BPM” zostanie zablokowane – operator nie będzie mógł zmienić hasła.
Okno „Firmowa baza danych Comarch ERP Optima” po nawiązaniu połączenia z serwerem i wyborze bazy konfiguracyjnej ( gdy baza firmowa Comarch ERP Optima znajduje się na innym serwerze niż baza Comarch BPM (dawniej DMS) lub baza konfiguracyjna Comarch ERP Optima)
Uruchamianie skryptów
Po ewentualnym dokonaniu zmian i wyborze bazy firmowej nalezy nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy firmowej Comarch ERP Optima.
Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej],
aby przejść do kolejnego kroku instalacji:
Jeżeli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „false” – aplikacja ComarchBPM (dawniej DMS) nie współpracuje z modułem Comarch BPM (dawniej DMS) – następuje przejście do okna „Klucze licencji”
Jeżeli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „true” – następuje przejście do okna „Aktualizacja aplikacji Repozytorium”
Okno instalatora po pomyślnym wykonaniu skryptów na bazie firmowej Comarch ERP Optima (gdy baza firmowa Comarch ERP Optima znajduje się na tym samym serwerze co baza Comarch BPM (dawniej DMS) lub baza konfiguracyjna Comarch ERP Optima)
Aktualizacja aplikacji 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 (dawniej DMS) Repozytorium.
Plik appsettings.json z zaszyfrowanymi connection strings
W ramach okna „Aktualizacja aplikacji Repozytorium” znajdują się następujące pola:
Wybierz witrynę web – w ramach tego pola operator powinien wybrać witrynę, na której znajduje się aplikacja Repozytorium do zaktualizowania (domyślnie wyświetlana jest witryna Default Web Site);
Port – pole numeru portu, wyszarzone i nieedytowalne;
Wybierz aplikację Repozytorium – w ramach tego pola operator powinien wybrać aplikację Repozytorium do zaktualizowania.
Następnie należy kliknąć [Dalej], aby przejść do kolejnego okna.
Okno „Aktualizacja aplikacji Repozytorium” przed wypełnieniem pól
Okno „Aktualizacja aplikacji Repozytorium” po wypełnieniu pól
Baza danych Comarch BPM Repozytorium
Następnie w ramach okna „Baza danych Comarch BPM Repozytorium” operator powinien uzupełnić:
W ramach pola „Nazwa serwera” – nazwę serwera, na którym znajduje się serwer MongoDB;
Uwaga
Istnieje możliwość wprowadzenia w ramach pola „Nazwa serwera” IP serwera MongoDB.
W sekcji „Logowanie do serwera MongoDB”:
W ramach pola „Login” – login administratora MongoDB
W ramach pola „Hasło” – hasło administratora MongoDB
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”.
Okno „Baza danych Comarch BPM Repozytorium” przed uzupełnieniem pól
Okno „Baza danych Comarch BPM Repozytorium” po uzupełnieniu pól i kliknięciu w przycisk „Połącz”
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.
Okno „Baza danych Comarch BPM Repozytorium” z komunikatem „Wprowadzono nieprawidłowy adres serwera”
„Wprowadzono nieprawidłowe dane logowania” – komunikat wyświetlany, jeśli w polu „Login” i/lub „Hasło” wprowadzono niewłaściwe dane
Okno „Baza danych Comarch BPM Repozytorium” z komunikatem „Wprowadzono nieprawidłowe dane logowania”
Jeśli nawiązano połączenie z serwerem MongoDB, wówczas w ramach pola „Lista baz danych” powinna być wybrana baza Comarch BPM (dawniej DMS) Repozytorium odpowiednia dla danej aplikacji.
Nastepnie, opcjonalnie, operator może zmienić hasło dla użytkownika MongoUser, klikając przycisk [Zmień hasło].
W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser, dodanego do serwera MongoDB podczas pierwszej instalacji danej aplikacji Comarch BPM (dawniej DMS) Repozytorium. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.
Okno zmiany hasła dla użytkownika MongoUser
Hasło powinno spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Login ani hasło nie mogą zawierać następujących znaków:
:
/
?
#
[
]
@
!
Od wersji 2024.2.2 można używać powyższych znaków w ramach loginu i/lub hasła.
Nie należy natomiast używać spacji w loginie ani w haśle.
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].
Okno „Baza danych Comarch BPM Repozytorium” po zmianie hasła dla użytkownika MongoUser
Po kliknięciu w przycisk [Dalej] następuje przejście do okna „Klucze licencji”.
Klucze licencji
W ramach okna „Klucze licencji” w polach: „Serwer klucza licencji Comarch BPM” i „Serwer klucza licencji Comarch ERP Optima” zostają automatycznie wpisane klucze licencji, pobrane z pliku Web.config. W razie potrzeby użytkownik może wpisać ręcznie inne klucze licencji Comarch BPM (dawniej DMS) zgodnie ze wzorem nazwa_serwera_klucza::numer_klucza.
Jeżeli operator aktualizuje również moduł Repozytorium, wówczas w ramach okna „Klucze licencji” dostępne jest także pole „Adres e-mail administratora”, w którym znajduje się adres email, który będzie widoczny w Comarch BPM (dawniej DMS) w komunikatach, w których wymagany jest kontakt z administratorem – automatycznie uzupełniony, ale dostępny do edycji.
Uwaga
W wersji 2025.2.0 podczas aktualizacji aplikacji Comarch BPM współpracującej z Comarch BPM Repozytorium pole „Adres e-mail administratora” jest niedostępne.
Uwaga
W wersji 2025.2.0 podczas aktualizacji aplikacji Comarch BPM współpracującej z Comarch BPM Repozytorium pole „Adres e-mail administratora” jest niedostępne.
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 podczas aktualizacji aplikacji Comarch BPM..
W instalatorze po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” następuje sprawdzenie, czy podany klucz licencji jest na tym samym serwerze, gdzie znajduje się baza danych Comarch BPM.
Poniżej opisano możliwe warianty dalszego postępowania, w zależności od tego, czy baza danych Comarch BPM i klucze licencji znajdują się na tym samym, czy na różnych serwerach:
Wariant 1
Baza danych Comarch BPM znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” dokonano zmiany serwera klucza/kluczy licencji, które również znajdują się na serwerze 1
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” nastąpi próba zalogowania użytkownika CDNHASPDMS[numer]. Jeśli:
Logowanie zakończy się powodzeniem – wówczas możliwa jest dalsza aktualizacja aplikacji, po kliknięciu w przycisk „Instaluj”
Logowanie zakończy się niepowodzeniem – wówczas w przypadku, jeżeli:
Użytkownik istnieje na serwerze – zostanie dla niego wygenerowane nowe hasło, które zostanie zaktualizowane
Użytkownik nie istnieje na serwerze – 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ć aktualizację 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.
Wariant 2 (dotyczy instalacji Comarch BPM we współpracy z Comarch ERP Optima lub Comarch ERP XL)
Baza danych Comarch BPM znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” dokonano zmiany serwera klucza licencji, tak, że:
1 klucz licencji znajduje się na serwerze 1
oraz
1 klucz licencji znajduje się na serwerze 2
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” nastąpi próba zalogowania użytkownika CDNHASPDMS[numer], który jest zapisany dla serwera 1, który nie uległ zmianie. Jeśli:
Logowanie zakończy się niepowodzeniem – wówczas w przypadku, jeżeli:
Użytkownik istnieje na serwerze 1 – zostanie dla niego wygenerowane nowe hasło, które zostanie zaktualizowane;
Użytkownik nie istnieje na serwerze 1 – zostanie utworzony nowy login CDNHASPDMS[numer] – dla loginu zostaje nadane nowo wygenerowane hasło i uprawnienia HASP;
Logowanie zakończy się powodzeniem – wówczas możliwa jest aktualizacja aplikacji
Dla serwera 2 zostanie wyświetlone okno, które pozwoli na podanie loginu i hasła użytkownika z uprawnieniami administratora do serwera oraz na sprawdzenie połączenia – informacja o rezultacie próby połączenia z serwerem będzie widoczna w oknie logowania do serwera. 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ć aktualizację 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
Okno logowania do serwera, gdy pomyślnie nawiązano połączenie
Wariant 3 (dotyczy instalacji Comarch BPM we współpracy z Comarch ERP Optima lub Comarch ERP XL)
Baza danych Comarch BPM znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” dokonano zmiany serwera klucza licencji, tak, że obydwa klucze licencji znajdują się na serwerze 2
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” zostanie wyświetlone okno, które pozwoli na podanie loginu i hasła użytkownika z uprawnieniami administratora do serwera 2 oraz na sprawdzenie połączenia – informacja o rezultacie próby połączenia z serwerem będzie widoczna w oknie logowania do serwera. Następnie jeśli:
Nawiązano połączenie – w przypadku, gdy użytkownik istnieje już na serwerze 2, 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ć aktualizację 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.
Wariant 4 (dotyczy instalacji Comarch BPM we współpracy z Comarch ERP Optima lub Comarch ERP XL)
Baza danych Comarch BPM znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” dokonano zmiany serwerów kluczy licencji, tak, że:
1 klucz licencji znajduje się na serwerze 2
oraz
1 klucz licencji znajduje się na serwerze 3
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” zostają wyświetlone okna logowania do obydwóch serwerów – 2 i 3 – które pozwolą na podanie loginu i hasła użytkownika z uprawnieniami administratora do danego serwera oraz na sprawdzenie połączenia – informacja o rezultacie próby połączenia z danym serwerem będzie widoczna w oknie logowania do danego serwera. Następnie jeśli:
Nawiązano połączenie z obydwoma serwerami – w przypadku, gdy użytkownik istnieje już na danym 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ć aktualizację 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 z żadnym z serwerów lub tylko z jednym z serwerów– 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.
Okno „Klucze licencji” (gdy aplikacja nie współpracuje z Comarch BPM Repozytorium)
Uwaga
W ramach instalatora nie następuje weryfikacja kluczy – jeśli wprowadzono niepoprawne klucze licencji, wystąpi błąd przy próbie logowania do aplikacji web Comarch BPM (dawniej DMS).
Po kliknięciu [Instaluj] następuje przejście do kolejnego okna "Aktualizowanie" i rozpoczyna się aktualizacja aplikacji web Comarch BPM (dawniej DMS).
Okno "Aktualizowanie"
Po dokonaniu aktualizacji wyświetlone zostanie końcowe okno instalatora. Kiedy 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ą podano w instalatorze.
Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o ComarchBPM (dawniej DMS) i chcesz dowiedzieć się więcej?
Aktualizacja aplikacji serwerowej, aplikacji WEB i aplikacji Comarch BPM (dawniej DMS) Repozytorium za pomocą instalatora
Instalator Comarch BPM (dawniej DMS) umożliwia również aktualizację aplikacji serwerowej i aktualizację aplikacji WEB Comarch BPM (dawniej DMS) oraz aktualizację aplikacji Comarch BPM (dawniej DMS) Repozytorium.
Uwaga
Przed rozpoczęciem aktualizacji Comarch BPM (dawniej DMS) Repozytorium konieczne jest, aby wykonać backup bazy MongoDB – zob. Backup bazy danych MongoDB
Uwaga
Podczas aktualizacji za pomocą Instalatora (Instalator Comarch BPM.exe) potrzebny jest dostęp do Internetu.
W ramach okna początkowego dostępne jest pole Język instalatora – w ramach tego pola użytkownik wybiera język, w którym będą wyświetlane kolejne kroki instalatora.
Po wyborze odpowiedniej wartości w polu należy kliknąć [Dalej], aby przejść do kolejnego kroku aktualizacji.
Jeżeli użytkownik chce zrezygnować z aktualizacji, powinien wybrać przycisk [Anuluj] albo spróbować zamknąć okno za pomocą znaku x. Wówczas zostanie wyświetlony następujący komunikat:
Komunikat, który zostanie wyświetlony po naciśnięciu przycisku „Anuluj” lub przy próbie zamknięcia okna instalatora
Jeśli użytkownik wybierze przycisk:
Tak – instalator zostanie zamknięty
Nie – użytkownik pozostanie w tym samym oknie, a komunikat będzie zamknięty
Ekran początkowy aktualizacji aplikacji web Comarch BPM (dawniej DMS)
W kolejnym oknie instalatora należy wybrać przycisk [Dalej], aby kontynuować aktualizację.
Drugie okno aktualizacji Comarch BPM (dawniej DMS) – ekran powitalny
Wybór aplikacji
Następnie aby zaktualizować aplikację Comarch BPM (dawniej DMS), należy w ramach okna „Wybór aplikacji” wybrać opcję „Aktualizacja aplikacji Comarch BPM oraz Comarch BPM Repozytorium” i kliknąć [Dalej].
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 (dawniej DMS). W ramach pola dostępnego w prawej części okna dostępne są następujące kolumny:
Name – zawiera nazwę danego dodatku
Required – zawiera numer wymaganej wersji danego dodatku
Found – zawiera numer wersji danego dodatku zainstalowanej już na komputerze
Action – zawiera nieaktywny przycisk Pomiń – jeśli na komputerze jest już odpowiednia wersja i dany dodatek nie wymaga instalacji, wówczas jego instalacja zostanie automatycznie pominięta
Okno „Wymagane dodatki”
Aby zainstalować wymagane dodatki i przejść do następnego okna należy nacisnąć przycisk [Dalej].
Aktualizacja aplikacji serwerowej
Uwaga
W przypadku aktualizacji aplikacji Comarch BPM (dawniej DMS) w wersji 2024.3.1 lub niższej za pomocą instalatora wydanego w ramach wersji 2025.0.0 pula aplikacji, na której do tej pory pracowały aplikacje: serwerowa i web Comarch BPM (dawniej DMS) zostanie dedykowana dla aplikacji serwerowej (Api) Comarch BPM (dawniej DMS).
Następnie zostaje otwarte okno Aktualizacja aplikacji serwerowej. W ramach tego okna dostępne są następujące pola:
Wybierz witrynę web – w tym polu użytkownik z listy dostępnych witryn wybiera witrynę, na której znajduje się aplikacja serwerowa (dawna web), która ma zostać zaktualizowana – domyślnie wyświetlana jest witryna Default Web Site;
Port – nieedytowalne pole numeru portu, widoczne jako wyszarzone;
Wybierz aplikację serwerową – w tym polu użytkownik z listy aplikacji dostępnych na danej witrynie wybiera tę aplikację serwerową (dawna web), która ma zostać zaktualizowana
Od wersji 2023.0.1 możliwa jest aktualizacja aplikacji web Comarch BPM (dawniej DMS) za pomocą instalatora w przypadku, jeśli dotychczasowa instalacja była wykonywana ręcznie i aplikacja web została zainstalowana bezpośrednio w witrynie.
Przykład aplikacji web zainstalowanej bezpośrednio w witrynie
W tym celu w ramach okna Aktualizacja aplikacji serwerowej w polu Wybierz aplikację serwerową dostępna jest opcja Aplikacja zainstalowana w witrynie.
Wybór aplikacji serwerowej zainstalowanej w witrynie do aktualizacji
Jeżeli użytkownik wybrał opcję Aplikacja zainstalowana w witrynie, wówczas aktualizacja plików aplikacji serwerowej (dawnej web) będzie się odbywać w folderze źródłowym witryny sieci web, który został wskazany w ustawieniach zaawansowanych witryny (Ogólne -> Ścieżka fizyczna).
Po wybraniu odpowiednich wartości w polach należy nacisnąć przycisk [Dalej], aby przejść do kolejnego okna.
Jeśli użytkownik wybrał w polu „Nazwa aplikacji” aplikację, która nie jest aplikacją serwerową Comarch BPM (dawniej DMS), wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch BPM Web. Wybierz odpowiednią aplikację.”.
Okno „Aktualizacja aplikacji serwerowej” po wyborze aplikacji do zaktualizowania (gdy aplikacja nie jest zainstalowana w witrynie)
Kiedy wybrano aplikację do aktualizacji, wówczas weryfikowany jest plik web.config. Od wersji 2023.0.1 jeśli w kluczu „MultiCompany” value= true, wówczas aktualizacja bazy Comarch BPM (dawniej DMS) zostaje przeprowadzona i zostaje wyświetlony następujący komunikat:
Komunikat wyświetlany podczas aktualizacji aplikacji Comarch BPM (dawniej DMS), która pracuje w trybie wielofirmowym
W przypadku, jeśli użytkownik naciśnie przycisk:
Anuluj – praca instalatora zostanie zakończona, zaś aktualizacja – przerwana
Ok – zostanie wykonana aktualizacja bazy BPM (dawniej DMS), a w kluczu MultiCompany zostaje zachowana wartość True
Następnie użytkownik przechodzi do okna „Pula dla aplikacji WEB”.
Wybór puli aplikacji webowej
Od wersji 2025.0.0 dla aplikacji serwerowej i dla aplikacji WEB wymagane jest skonfigurowanie osobnych pul aplikacji. Z tego powodu na kolejnym kroku, w oknie Pula dla aplikacji WEB należy określić, na jakiej puli aplikacji ma pracować aplikacja web Comarch BPM (dawniej DMS) – w tym celu należy, podobnie jak w przypadku aplikacji serwerowej:
wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią
lub
dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji web BPM (dawniej DMS).
Uwaga
Pula aplikacji, na której ma pracować aplikacja WEB Comarch BPM (dawniej DMS) nie może być tą samą pulą, na której ma pracować aplikacja serwerowa Comarch BPM (dawniej DMS).
Okno „Pula dla aplikacji WEB”, w którym dodano i wybrano pulę
Kiedy operator wybrał pulę aplikacji z listy albo dodał nową pulę i ją zaznaczył, wówczas następuje sprawdzenie, czy pula spełnia konieczne wymagania. Jeśli pod listą pul aplikacji zostanie wyświetlony komunikat:
Wybrana pula spełnia wymagania instalowanej aplikacji – można przejść do dalszego kroku instalacji Comarch BPM (dawniej DMS);
Wybrana pula nie spełnia wymagań instalowanej aplikacji – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy wybrać inną pulę spełniającą wymagania lub dodać nową;
Wybrana pula jest zatrzymana. Przed uruchomieniem aplikacji należy uruchomić pulę w Menedżerze IIS. – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy uruchomić pulę aplikacji;
Wybrana pula została wskazana we wcześniejszym kroku instalacji, na tę na której ma pracować aplikacja serwerowa. Aplikacja webowa wymaga wskazania innej puli. – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy wybrać inna pulę, która spełnia wymagania albo dodać nową pulę;
Pula o tej nazwie już istnieje. – przed kontynuacją instalacji Comarch BPM (dawniej DMS) należy wybrać inną pulę spełniającą wymagania lub dodać nową o innej nazwie.
Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji, klikając przycisk [Dalej].
Jeśli:
użytkownik utworzył już wcześniej aplikację WEB powiązaną z daną aplikacją serwerową, wówczas przechodzi do okna „Aktualizacja aplikacji WEB”
użytkownik nie utworzył jeszcze aplikacji WEB powiązanej z daną aplikacją serwerową, wówczas przechodzi do okna „Kreowanie aplikacji WEB”
Aktualizacja aplikacji WEB
Opcja aktualizacji aplikacji WEB za pomocą instalatora jest dostępna od wersji 2024.0.1. W ramach okna „Aktualizacja aplikacji WEB” należy:
w polu „Wybierz witrynę web” wybrać witrynę, na której znajduje się aplikacja WEB, która ma zostać zaktualizowana – domyślnie wyświetlana jest witryna Default Web Site;
w polu „Wybierz aplikację WEB” wybrać z listy aplikacji dostępnych na danej witrynie tę aplikację WEB (nowy web), która ma zostać zaktualizowana
a następnie kliknąć przycisk [Dalej], aby przejść do okna „Opcje aktualizacji”.
Okno „Aktualizacja aplikacji WEB” przed wyborem aplikacji WEB
Okno „Aktualizacja aplikacji WEB” po wyborze aplikacji WEB
Jeśli użytkownik wybrał w polu „Wybierz aplikację WEB” aplikację, która nie jest aplikacją serwerową Comarch BPM (dawniej DMS), wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch BPM. Wybierz odpowiednią aplikację.”.
Okno „Aktualizacja aplikacji WEB” po wyborze do zaktualizowania aplikacji, która nie jest aplikacją WEB
Kreowanie aplikacji WEB
Uwaga
Konieczne jest, aby aplikacje: serwerowa i web znajdowały się na tej samej witrynie.
W ramach tego okna dostępne są pola, w ramach których użytkownik:
w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
w polu „Wprowadź nazwę aplikacji WEB” – wpisuje nadaną przez siebie nazwę aplikacji, np. BPMweb.
Uwaga
W wersji 2025.2.0 wprowadzono walidację dodawanych nazw aplikacji: serwerowej i web 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.”.
Komunikat informujący o niepoprawnej nazwie aplikacji
W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Wprowadź nazwę aplikacji WEB” 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.
Okno „Kreowanie aplikacji WEB” po tym, jak aplikacja została utworzona
Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Wybierz lub utwórz witrynę web” i ponownie kliknąć [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.
Operator ma także opcję dodania nowej witryny, na której utworzy aplikację WEB. W tym celu powinien:
W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;
W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny
Okno „Kreowanie aplikacji WEB” podczas dodawania nowej witryny
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.
Okno „Kreowanie aplikacji WEB” po pomyślnym dodaniu nowej witryny
Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].
Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę o takiej samej nazwie jak już istniejąca
Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].
Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę na porcie, który jest już wykorzystywany
Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.
Po wybraniu odpowiednich wartości w polach należy nacisnąć przycisk [Dalej], aby przejść do okna „Opcje aktualizacji”.
Jeśli użytkownik wybrał w polu „Nazwa aplikacji” aplikację, która nie jest nową aplikacją WEB Comarch BPM (dawniej DMS), wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch BPM. Wybierz odpowiednią aplikację.”.
Opcje aktualizacji
W następnym oknie „ Opcje aktualizacji” w ramach pola „Domyślny język aktualizowanej aplikacji” wybierany jest język, w którym wyświetlana będzie domyślnie aplikacja Comarch BPM (dawniej DMS).
Okno „Opcje aktualizacji” w przypadku aktualizacji Comarch BPM (dawniej DMS) we współpracy z Comarch ERP XL
Dostępne są również trzy parametry:
Opcja zmiany języka na ekranie logowania do Comarch BPM – jeżeli parametr zostanie zaznaczony, wówczas na ekranie logowania dostępny będzie link [aplikacja desktop] lub opcja [aplikacja webowa], po kliknięciu w które możliwy jest wybór z listy jednego z czterech języków aplikacji: polskiego, angielskiego, niemieckiego lub francuskiego. W przypadku zaznaczenia parametru dostępna jest również sekcja „Język aplikacji” na zakładce „Preferencje” w ramach zakładki „Ustawienia” w aplikacji web – w sekcji można wybrać język, w którym ma być wyświetlana aplikacja (dostępne są powyżej wymienione)
.Wymagaj przestrzegania polityki mocnych haseł – domyślnie zaznaczony parametr; sprawia, że hasła ustawiane w aplikacji muszą spełniać określone warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Wersja Premium – opcja domyślnie zaznaczona; funkcjonalność modelowania procesów za pomocą kodu C# (w tym również dostęp do automatycznego trybu pracy – robotyzacji procesów) oraz dostęp do obsługi pobierania i wysyłki wiadomości z usługi e-Doręczenia.
Po ustawieniu parametrów należy kliknąć na przycisk [Dalej], aby kontynuować instalację.
Baza danych Comarch BPM
Jeśli podczas instalacji utworzono osobną bazę danych dla Comarch BPM (dawniej DMS), wówczas następuje przejście do okna „Baza danych Comarch BPM”, gdzie należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:
Logowanie zintegrowane
lub
Logowanie SQL – jeśli wybrano tę opcję, należy podać:
W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
W polu „Hasło” – hasło użytkownika logującego się do serwera SQL
Uwaga
Hasło wprowadzane w polu „Hasło” nie może zawierać znaku ”
Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.
Okno „Baza danych Comarch BPM”
Jeśli nawiązano połączenie z serwerem, w ramach pola „Lista baz danych” powinna być wybrana baza Comarch BPM (dawniej DMS), która jest właściwa dla danej aplikacji – domyślnie podpowiada się właściwa baza. W wersji 2025.0.0 dodano następujące elementy:
Pole „Użytkownik SQL dla Comarch BPM” – w ramach tego pola operator może wskazać utworzonego wcześniej użytkownika, który aktualnie komunikuje się z bazą danych. Po wyborze użytkownika przycisk [Zmień hasło] staje się aktywny. Zmiana hasła przy aktualizacji nie jest obowiązkowa, jeśli jednak operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL (zob. Zmiana hasła użytkownika SQL);
Przycisk [Dodaj użytkownika] – operator powinien nacisnąć ten przycisk, jeśli nie chce zmieniać hasła istniejącego użytkownika SQL, chce natomiast dodać nowego użytkownika SQL, za pośrednictwem którego aplikacja Comarch BPM (dawniej DMS) komunikuje się z bazą danych (zob. Dodawanie nowego użytkownika SQL).
Zmiana hasła użytkownika SQL
Jeśli operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL. W tym celu należy:
W polu „Hasło” wprowadzić nowe hasło dla wybranego użytkownika SQL
W polu „Powtórz hasło” wpisać ponownie nowe hasło dla wybranego użytkownika SQL, takie samo, jak w polu „Hasło”
Następnie operator powinien kliknąć przycisk [Zapisz].
Hasło powinno być silne – tzn. spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Hasło nie może zawierać następujących znaków:
;
‘
”
Okno zmiany hasła dla wybranego użytkownika SQL
Jeżeli wpisano hasło, które nie spełnia któregoś z warunków dla silnego hasła, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zmienione i wyświetlany jest odpowiedni komunikat, analogicznie jak w przypadku dodawania nowego użytkownika SQL.
Po poprawnym uzupełnieniu pól oraz po kliknięciu przycisku [Zapisz] hasło dla wybranego użytkownika SQL zostaje zmienione, okno zamyka się, a w ramach okna „Baza danych Comarch BPM” wyświetlony zostaje napis „Hasło użytkownika bazy zostało zmienione”.
Okno „Baza danych Comarch BPM” po zmianie hasła dla wybranego użytkownika SQL
Uwaga
Jeżeli zmieniono hasło dla wybranego użytkownika SQL, wówczas w ramach danej aktualizacji nie można dodać nowego użytkownika serwera SQL – przycisk „Dodaj użytkownika” jest wyszarzony.
Dodawanie nowego użytkownika SQL
Po kliknięciu w przycisk [Dodaj użytkownika] zostaje otwarte okno, w którym należy uzupełnić następujące pola:
Login – w tym polu operator powinien wpisać login nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server;
Hasło – w tym polu operator powinien wpisać hasło nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server;
Powtórz hasło – w ramach tego pola operator powinien powtórnie wprowadzić hasło nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server.
Uwaga
Zaleca się, aby login był unikalny dla każdej instalacji Comarch BPM (dawniej DMS).
Hasło powinno być silne – tzn. spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Hasło nie może zawierać następujących znaków:
;
‘
”
Jeżeli wpisano hasło, które nie spełnia któregoś z warunków dla silnego hasła, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane, użytkownik nie zostaje utworzony i wyświetlany jest odpowiedni komunikat, analogicznie jak podczas instalacji aplikacji Comarch BPM (dawniej DMS).
Okno ustawienia loginu i hasła dla nowego użytkownika, za pomocą którego aplikacja Comarch BPM (dawniej DMS) będzie komunikować się z bazą danych na serwerze MS SQL Server
W przypadku, gdy operator wprowadził login i hasło użytkownika, którego login był już wykorzystywany dla innej instalacji na tym samym serwerze , a następnie kliknął w przycisk [Zapisz], wówczas w dolnej części zostanie wyświetlony komunikat ostrzegawczy „Wpisany login jest już wykorzystany do komunikacji z bazą danych na tym serwerze. Zalecamy zmianę loginu dla nowej instalacji”. Komunikat nie blokuje następnych kroków instalacji – po ponownym kliknięciu w przycisk [Zapisz] użytkownik z podanym loginem oraz hasłem zostanie utworzony.
Uwaga
W ramach aktualizacji operator może albo zmienić hasło, albo dodać nowego użytkownika SQL – nie może wykonać obydwóch tych akcji.
Operator może także nie podejmować żadnej z tych akcji i od razu po przejściu do okna oraz nawiązaniu połączenia z serwerem wybrać bazę w ramach pola „Lista baz danych”, a następnie kliknąć przycisk „Uruchom skrypty”
Jeżeli dodawanie nowego użytkownika SQL zakończy się sukcesem, wówczas pole „Użytkownik SQL dla Comarch BPM” zostanie zablokowane – operator nie będzie mógł zmienić hasła.
Okno „Baza danych Comarch BPM” – widok po utworzeniu nowego użytkownika SQL
Uruchamianie skryptów
Po wyborze bazy i (opcjonalnie) zmianie hasła dla istniejącego użytkownika SQL lub dodaniu nowego użytkownika SQL operator powinien nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch BPM (dawniej DMS). Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku aktualizacji – do okna „Baza danych Comarch ERP XL”.
Baza danych Comarch ERP XL
W ramach okna „Firmowa baza danych Comarch ERP XL” należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:
Logowanie zintegrowane
lub
Logowanie SQL – jeśli wybrano tę opcję, należy podać:
W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
W polu „Hasło” – hasło użytkownika logującego się do serwera SQL
Uwaga
Hasło wprowadzane w polu „Hasło” nie może zawierać znaku ”
Okno „Baza danych Comarch ERP XL”
Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.
Od wersji 2025.0.0 w przypadku jeśli:
baza Comarch ERP XL znajduje się na tym samym serwerze albo w oknie „Opcje instalacji” zaznaczono opcję „Utwórz osobną bazę danych dla Comarch BPM”, po połaczeniu z serwerem użytkownik powinien w ramach pola „Lista baz danych” wybrać bazę konfiguracyjną Comarch ERP XL, która ma zostać zaktualizowana, a później nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch ERP XL.
Okno „Baza danych Comarch ERP XL” po nawiązaniu połączenia z serwerem i wyborze bazy danych (gdy baza Comarch ERP XL znajduje się na tym samym serwerze co baza Comarch BPM (dawniej DMS) albo w oknie „Opcje instalacji” zaznaczono opcję „Utwórz osobną bazę danych dla Comarch BPM”)
baza Comarch ERP XL znajduje się na innym serwerze niż baza Comarch BPM (dawniej DMS) albo w oknie „Opcje instalacji” nie zaznaczono opcji „Utwórz osobną bazę danych dla Comarch BPM”, wówczas po połączeniu z serwerem w ramach okna „Baza danych Comarch ERP XL” dostępne są:
Pole „Użytkownik SQL dla Comarch BPM” – w ramach tego pola operator może wskazać utworzonego wcześniej użytkownika, który aktualnie komunikuje się z bazą danych. Po wyborze użytkownika przycisk [Zmień hasło] staje się aktywny. Zmiana hasła przy aktualizacji nie jest obowiązkowa, jeśli jednak operator kliknie w przycisk [Zmień hasło], wówczas zostanie otwarte okno, w ramach którego może dokonać zmiany hasła dla wybranego użytkownika SQL (zob. Zmiana hasła użytkownika SQL);
Przycisk [Dodaj użytkownika] – operator powinien nacisnąć ten przycisk, jeśli nie chce zmieniać hasła istniejącego użytkownika SQL, chce natomiast dodać nowego użytkownika SQL, za pośrednictwem którego aplikacja Comarch BPM (dawniej DMS) komunikuje się z bazą danych (zob. Dodawanie nowego użytkownika SQL).
.
Uwaga
W ramach aktualizacji operator może albo zmienić hasło, albo dodać nowego użytkownika SQL – nie może wykonać obydwóch tych akcji.
Operator może także nie podejmować żadnej z tych akcji i od razu po przejściu do okna oraz nawiązaniu połączenia z serwerem wybrać bazę w ramach pola „Lista baz danych”, a następnie kliknąć przycisk „Uruchom skrypty”
Jeżeli dodawanie nowego użytkownika SQL zakończy się sukcesem, wówczas pole „Użytkownik SQL dla Comarch BPM” zostanie zablokowane – operator nie będzie mógł zmienić hasła.
Okno „Baza danych Comarch ERP XL” po nawiązaniu połączenia z serwerem i wyborze bazy Comarch ERP XL (gdy baza Comarch ERP XL znajduje się na innym serwerze niż baza Comarch BPM (dawniej DMS) albo w oknie „Opcje instalacji” nie zaznaczono opcji „Utwórz osobną bazę danych dla Comarch BPM”)
Uruchamianie skryptów
Po wyborze bazy i (opcjonalnie) zmianie hasła dla istniejącego użytkownika SQL lub dodaniu nowego użytkownika SQL operator powinien nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch ERP XL.
Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji:
Jeżeli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „false” – aplikacja Comarch BPM (dawniej DMS) nie współpracuje z modułem Comarch BPM (dawniej DMS) Repozytorium– następuje przejście do okna „Klucze licencji”
Jeżeli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „true” – następuje przejście do okna „Aktualizacja aplikacji Repozytorium”
Okno instalatora po pomyślnym wykonaniu skryptów na bazie Comarch ERP XL (gdy baza Comarch ERP XL znajduje się na tym samym serwerze co baza Comarch BPM (dawniej DMS) albo w oknie „Opcje instalacji” zaznaczono opcję „Utwórz osobną bazę danych dla Comarch BPM”)
Aktualizacja aplikacji 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 (dawniej DMS) Repozytorium.
Plik appsettings.json z zaszyfrowanymi connection strings
W ramach okna „Aktualizacja aplikacji Repozytorium” znajdują się następujące pola:
Wybierz witrynę web – w ramach tego pola operator powinien wybrać witrynę, na której znajduje się aplikacja Repozytorium do zaktualizowania (domyślnie wyświetlana jest witryna Default Web Site);
Port – pole numeru portu, wyszarzone i nieedytowalne;
Wybierz aplikację Repozytorium – w ramach tego pola operator powinien wybrać aplikację Repozytorium do zaktualizowania.
Następnie należy kliknąć [Dalej], aby przejść do kolejnego okna.
Okno „Aktualizacja aplikacji Repozytorium” przed wypełnieniem pól
Okno „Aktualizacja aplikacji Repozytorium” po wypełnieniu pól
Baza danych Comarch BPM Repozytorium
Następnie w ramach okna „Baza danych Comarch BPM Repozytorium” operator powinien uzupełnić:
W ramach pola „Nazwa serwera” – nazwę serwera, na którym znajduje się serwer MongoDB;
Uwaga
Istnieje możliwość wprowadzenia w ramach pola „Nazwa serwera” IP serwera MongoDB.
W sekcji „Logowanie do serwera MongoDB”:
W ramach pola „Login” – login administratora MongoDB
W ramach pola „Hasło” – hasło administratora MongoDB
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”.
Okno „Baza danych Comarch BPM Repozytorium” przed uzupełnieniem pól
Okno „Baza danych Comarch BPM Repozytorium” po uzupełnieniu pól i kliknięciu w przycisk „Połącz”
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.
Okno „Baza danych Comarch BPM Repozytorium” z komunikatem „Wprowadzono nieprawidłowy adres serwera”
„Wprowadzono nieprawidłowe dane logowania” – komunikat wyświetlany, jeśli w polu „Login” i/lub „Hasło” wprowadzono niewłaściwe dane
Okno „Baza danych Comarch BPM Repozytorium” z komunikatem „Wprowadzono nieprawidłowe dane logowania”
Jeśli nawiązano połączenie z serwerem MongoDB, wówczas w ramach pola „Lista baz danych” powinna być wybrana baza Comarch BPM (dawniej DMS) Repozytorium odpowiednia dla danej aplikacji.
Nastepnie, opcjonalnie, operator może zmienić hasło dla użytkownika MongoUser, klikając przycisk [Zmień hasło].
W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser, dodanego do serwera MongoDB podczas pierwszej instalacji danej aplikacji Comarch BPM (dawniej DMS) Repozytorium. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.
Okno zmiany hasła dla użytkownika MongoUser
Hasło powinno spełniać następujące warunki:
Składać się z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
Uwaga
Login ani hasło nie mogą zawierać następujących znaków:
:
/
?
#
[
]
@
!
Od wersji 2024.2.2 można używać powyższych znaków w ramach loginu i/lub hasła.
Nie należy natomiast używać spacji w loginie ani w haśle.
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].
Okno „Baza danych Comarch BPM Repozytorium” po zmianie hasła dla użytkownika MongoUser
Po kliknięciu w przycisk [Dalej] następuje przejście do okna „Klucze licencji”.
Klucze licencji
W ramach okna „Klucze licencji” w polach: „Serwer klucza licencji Comarch BPM” i „Serwer klucza licencji Comarch ERP XL” zostają automatycznie wpisane klucze licencji, pobrane z pliku Web.config. W razie potrzeby użytkownik może wpisać ręcznie inne klucze licencji Comarch BPM (dawniej DMS) zgodnie ze wzorem nazwa_serwera_klucza::numer_klucza.
Jeżeli operator aktualizuje również moduł Repozytorium, wówczas w ramach okna „Klucze licencji” dostępne jest także pole „Adres e-mail administratora”, w którym znajduje się adres email, który będzie widoczny w Comarch BPM (dawniej DMS) w komunikatach, w których wymagany jest kontakt z administratorem – automatycznie uzupełniony, ale dostępny do edycji.
Uwaga
W wersji 2025.2.0 podczas aktualizacji aplikacji Comarch BPM współpracującej z Comarch BPM Repozytorium pole „Adres e-mail administratora” jest niedostępne.
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 podczas aktualizacji aplikacji Comarch BPM..
W instalatorze po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” następuje sprawdzenie, czy podany klucz licencji jest na tym samym serwerze, gdzie znajduje się baza danych Comarch BPM.
Poniżej opisano możliwe warianty dalszego postępowania, w zależności od tego, czy baza danych Comarch BPM i klucze licencji znajdują się na tym samym, czy na różnych serwerach:
Wariant 1
Baza danych Comarch BPM znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” dokonano zmiany serwera klucza/kluczy licencji, które również znajdują się na serwerze 1
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” nastąpi próba zalogowania użytkownika CDNHASPDMS[numer]. Jeśli:
Logowanie zakończy się powodzeniem – wówczas możliwa jest dalsza aktualizacja aplikacji, po kliknięciu w przycisk „Instaluj”
Logowanie zakończy się niepowodzeniem – wówczas w przypadku, jeżeli:
Użytkownik istnieje na serwerze – zostanie dla niego wygenerowane nowe hasło, które zostanie zaktualizowane
Użytkownik nie istnieje na serwerze – 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ć aktualizację 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.
Wariant 2 (dotyczy instalacji Comarch BPM we współpracy z Comarch ERP Optima lub Comarch ERP XL)
Baza danych Comarch BPM znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” dokonano zmiany serwera klucza licencji, tak, że:
1 klucz licencji znajduje się na serwerze 1
oraz
1 klucz licencji znajduje się na serwerze 2
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” nastąpi próba zalogowania użytkownika CDNHASPDMS[numer], który jest zapisany dla serwera 1, który nie uległ zmianie. Jeśli:
Logowanie zakończy się niepowodzeniem – wówczas w przypadku, jeżeli:
Użytkownik istnieje na serwerze 1 – zostanie dla niego wygenerowane nowe hasło, które zostanie zaktualizowane;
Użytkownik nie istnieje na serwerze 1 – zostanie utworzony nowy login CDNHASPDMS[numer] – dla loginu zostaje nadane nowo wygenerowane hasło i uprawnienia HASP;
Logowanie zakończy się powodzeniem – wówczas możliwa jest aktualizacja aplikacji
Dla serwera 2 zostanie wyświetlone okno, które pozwoli na podanie loginu i hasła użytkownika z uprawnieniami administratora do serwera oraz na sprawdzenie połączenia – informacja o rezultacie próby połączenia z serwerem będzie widoczna w oknie logowania do serwera. 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ć aktualizację 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
Okno logowania do serwera, gdy pomyślnie nawiązano połączenie
Wariant 3 (dotyczy instalacji Comarch BPM we współpracy z Comarch ERP Optima lub Comarch ERP XL)
Baza danych Comarch BPM znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” dokonano zmiany serwera klucza licencji, tak, że obydwa klucze licencji znajdują się na serwerze 2
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” zostanie wyświetlone okno, które pozwoli na podanie loginu i hasła użytkownika z uprawnieniami administratora do serwera 2 oraz na sprawdzenie połączenia – informacja o rezultacie próby połączenia z serwerem będzie widoczna w oknie logowania do serwera. Następnie jeśli:
Nawiązano połączenie – w przypadku, gdy użytkownik istnieje już na serwerze 2, 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ć aktualizację 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.
Wariant 4 (dotyczy instalacji Comarch BPM we współpracy z Comarch ERP Optima lub Comarch ERP XL)
Baza danych Comarch BPM znajduje się na serwerze 1, a w oknie „Klucze licencji i hasło Administratora” dokonano zmiany serwerów kluczy licencji, tak, że:
1 klucz licencji znajduje się na serwerze 2
oraz
1 klucz licencji znajduje się na serwerze 3
Po kliknięciu w przycisk „Weryfikuj” w ramach okna „Klucze licencji i hasło Administratora” zostają wyświetlone okna logowania do obydwóch serwerów – 2 i 3 – które pozwolą na podanie loginu i hasła użytkownika z uprawnieniami administratora do danego serwera oraz na sprawdzenie połączenia – informacja o rezultacie próby połączenia z danym serwerem będzie widoczna w oknie logowania do danego serwera. Następnie jeśli:
Nawiązano połączenie z obydwoma serwerami – w przypadku, gdy użytkownik istnieje już na danym 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ć aktualizację 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 z żadnym z serwerów lub tylko z jednym z serwerów– 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.
Następnie należy kliknąć na przycisk [Dalej], aby przejść do kolejnego kroku.
Okno „Klucze licencji” (gdy aplikacja nie współpracuje z Comarch BPM Repozytorium)
Uwaga
W ramach instalatora nie następuje weryfikacja klucza – jeśli wprowadzono niepoprawne klucze licencji, wystąpi błąd przy próbie logowania do aplikacji web Comarch BPM (dawniej DMS).
Po kliknięciu [Instaluj] następuje przejście do kolejnego okna i rozpoczyna się aktualizacja aplikacji web Comarch BPM (dawniej DMS).
Okno "Aktualizowanie"
Po dokonaniu aktualizacji wyświetlone zostanie końcowe okno instalatora. Kiedy 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ą podano w instalatorze.
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?