Logi z pracy systemu

Spis treści artykułu

Informacje ogólne

Zakładka dodana w wersji 2024.2.1, widoczna zarówno dla administratora, jak i dla użytkownika bez takich uprawnień.

W wersji 2025.0.0 dodano opisy na zakładkach dotyczących zarządzania logami systemowymi.

W zakładce możliwe jest zarządzanie logami systemowymi z obszaru pracy w aplikacji desktop Comarch BPM.

W ramach zakładki „Logi z pracy systemu” dostępne są 1 lub 2 sekcje, w zależności od uprawnień operatora:

- - Logi ogólne – sekcja, w ramach której operator może zarządzać logami systemowymi z obszaru pracy w aplikacji desktop Comarch BPM;
  - Logi z obszaru robotyzacji – sekcja widoczna tylko w przypadku, gdy na karcie danego operatora na zakładce [Struktura organizacyjna] przyznano uprawnienie „Konfiguracja automatycznego trybu pracy”; w ramach sekcji operator może zarządzać logami z zakresu Automatycznego trybu pracy (z wykonywania skryptów w języku C# z konfiguracji automatycznego trybu pracy).

Od wersji 2025.0.0 w ramach widoku ogólnego zakładki „Logi z pracy systemu”, dostępnego po kliknięciu w nazwę zakładki, widoczny jest następujący opis: W zakładce możliwe jest zarządzanie logami systemowymi z obszaru pracy w aplikacji desktop Comarch BPM zapisywanymi lokalnie. W ramach zakładki „Logi systemowe” w Ustawienia możliwe jest zarządzanie logami zapisywanymi na serwerze IIS.

W wersji 2025.2.0 w pliku Web.config w folderze z aplikacją serwerową dodano klucz SaveLogsInDatebase, który umożliwia dokonanie wyboru, gdzie powinny być zapisywane logi. Jeżeli wartość klucza to:

- - False – wartość domyślna; w takim przypadku logi będą zapisywane w postaci plików (jeśli klucz „OptimaCloudMode” ma wartość „False”). Maksymalny rozmiar pliku to 1 MB -jeśli plik z logami przekroczy ten rozmiar, tworzony jest następny w tej samej lokalizacji z dodatkowymi znakami (np. „ _1”). Lokalizacja pliku jest zależna od obszaru pracy aplikacji (zob. opisy poszczególnych sekcji dotyczących logów w Comarch BPM);
  - True – wówczas logi będą zapisywane wyłącznie w bazie danych Comarch BPM w tabeli do.DF_WorkLogEntries (jeśli klucz „OptimaCloudMode” ma wartość „False”).

Uwaga

Jeżeli klucz „SaveLogsInDatebase” ma wartość „True”, a klucz „OptimaCloudMode” – „False”, wówczas wszystkie logi są zapisywane tylko w tabeli do. DF_WorkLogEntries. Pliki z logami zapisywane lokalnie albo na serwerze IIS nie są tworzone.

Od wersji 2025.2.0 jeśli w ramach sekcji na zakładce „Logi z pracy systemu” w ramach zakładki [Panel użytkownika] dokonano zmian, ale nie kliknięto w ikonę zapisz32 [Zapisz] w tej sekcji/ tych sekcjach, wówczas przy próbie przejścia do innej zakładki wyświetlony zostanie komunikat:

- - „W sekcji [Nazwa_Sekcji] nie zapisano zmiany ustawień. Czy zapisać zmiany?” (gdy zmian nie zapisano w jednej sekcji)

lub

- - „W sekcjach: [Nazwa_Sekcji1], [Nazwa_Sekcji2] nie zapisano zmiany ustawień. Czy zapisać zmiany?” (gdy zmian nie zapisano w więcej niż jednej sekcji).

W ramach komunikatu dostępne są następujące opcje:

- - Tak – jeśli operator wybierze tę opcję, wówczas zmiany dokonane w ustawieniach zostaną zapisane, komunikat zostanie zamknięty, a użytkownik wyjdzie z zakładki „Logi z pracy systemu”;
  - Nie – jeżeli operator wybierze tę opcję, zmiany ustawień nie będą zapisane, komunikat zostanie zamknięty, a użytkownik wyjdzie z zakładki „Logi z pracy systemu”;
  - Anuluj lub znak x – w przypadku, gdy operator wybierze jedną z tych opcji, zmiany ustawień nie będą zapisane, komunikat zostanie zamknięty, a użytkownik pozostanie na zakładce „Logi z pracy systemu”.

Komunikat wyświetlony po wprowadzeniu zmian w jednej sekcji i próbie przejścia do innej zakładki bez zapisu

Komunikat wyświetlony po wprowadzeniu zmian w obydwóch sekcjach i próbie przejścia do innej zakładki bez zapisu

Od wersji 2025.2.0 jeśli Comarch BPM pracuje w chmurze, wówczas:

wszystkie logi będą zapisywane jedynie w ramach tabeli do.DF_WorkLogEntries w bazie danych Comarch BPM – dlatego w tym przypadku zmieniono również opis dostępny w zakładce [Panel użytkownika], na zakładce „Logi z pracy systemu” na „;W zakładce możliwe jest zarządzanie logami systemowymi w kontekście zalogowanego operatora z obszaru Comarch BPM zapisywanymi w tabeli DF_WorkLogEntries w bazie danych”;
w tabeli do.DF_WorkLogEntries dodano kolumnę z Id operatora, który był zalogowany, gdy zapisywano logi z danego obszaru pracy Comarch BPM.

Widok zakładki „Logi z pracy systemu” dla operatora, któremu nie przyznano uprawnienia „Konfiguracja automatycznego trybu pracy” (gdy Comarch BPM pracuje lokalnie)

Widok zakładki „Logi z pracy systemu” dla operatora, któremu przyznano uprawnienie „Konfiguracja automatycznego trybu pracy” (gdy Comarch BPM pracuje lokalnie)

Sekcja Logi ogólne

Od wersji 2025.0.0 w ramach widoku sekcji „Logi ogólne” widoczny jest następujący opis: W tej sekcji możliwe jest zarządzanie logami związanymi z pracą aplikacji desktop Comarch BPM (BPM.exe) oraz z pracy generatora dokumentów do Optima ERP, jeżeli została skonfigurowana taka funkcjonalność.

Sekcja Logi ogólne, gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”

Sekcja „Logi ogólne” w zakładce „Logi z pracy systemu” – po włączeniu logów, z rozwiniętym polem „Pliki z logami” (gdy gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False)

W ramach pierwszego pola od lewej strony sekcji należy wybrać jedną z dwóch opcji:

- - Zarządzanie logami z poziomu aplikacji – wartość domyślna; jeśli operator wybierze tę opcję, wówczas będzie mógł:
    - wybrać opcję w polu „Włącz zapisywanie logów”,
    - zobaczyć zapisane logi w polu „Podgląd logów” i odświeżyć to pole,
    - zapisać plik z logami,
  - Zarządzanie poprzez konfigurację pliku NLog.config – jeśli operator wybierze tę opcję, wówczas zostanie wyłączona opcja edycji wszystkich innych pól w sekcji, ikony również będą nieaktywne. Po wyborze tej opcji operator:
    - nie może wybrać opcji w polu „Włącz zapisywanie logów”,
    - nie może zobaczyć zapisanych logów w polu „Podgląd logów” i odświeżać tego pola,
    - nie może zapisać pliku z logami z poziomu aplikacji.

Uwaga

Lokalizacja plików Nlog.config, jeśli wybrano opcję „Zarządzanie poprzez konfigurację pliku Nlog.config”: C:\[folder z aplikacją desktop].

Widok sekcji „Logi ogólne” po wyborze opcji „Zarządzanie poprzez konfigurację pliku NLog.config”

Jeżeli operator wybrał opcję „Zarządzanie logami z poziomu aplikacji”, wówczas powinien kliknąć w pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:

- - Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
  - Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

Włączanie zapisywania logów w sekcji „Logi ogólne”

W wersji 2025.2.0 usunięto komunikat „Włączono zapisywanie logów”, wyświetlany po wyborze opcji „Tak” w ramach pola „Włącz zapisywanie logów” oraz komunikat „Wyłączono zapisywanie logów”, wyświetlany po wyborze opcji „Nie” w ramach pola „Włącz zapisywanie logów”.

W wersji 2025.2.0 zamiast pola „Rozmiar pliku z logami” wprowadzono pole Pliki z logami – w tym polu dostępna jest lista utworzonych plików z logami z obszaru pracy systemu dla sekcji „Logi ogólne”. Dane są pobierane do pola przy przejściu do zakładki albo po kliknięciu w ikonę [Odśwież] – wówczas w polu Pliki z logami wybrany zostanie najnowszy plik z logami, a jego zawartość wyświetli się w polu „Podgląd logów”. W ramach listy wyświetlana jest data utworzenia i nazwa pliku – domyślnie to plik BPM-general.log.txt w katalogu AppData użytkownika/bieżącej puli, np. C:\Users\Jan.Kowalski\AppData\Roaming\.ComarchDMS.

Pliki na liście są posegregowane w kolejności od utworzonego najpóźniej (wartość domyślna). Jeśli żaden plik z logami dla danego obszaru pracy aplikacji nie został utworzony, wówczas lista jest pusta.

Po wyborze pliku jego zawartość zostanie wyświetlona w polu „Podgląd logów”.

W centralnym miejscu sekcji znajduje się pole „Podgląd logów” – w ramach tego pola operator może zobaczyć zawartość pliku z logami, jeżeli spełniono poniższe warunki:

- - W polu „Włącz zapisywanie logów” wybrano wartość „Tak”
  - Wybrano plik z logami
  - Plik z logami ma zarejestrowane logi

Oprócz podglądu logów operator może zaznaczyć część lub całość zawartości pola, a następnie skopiować ją albo usunąć.

Uwaga

Edycja lub usunięcie zawartości pola „Podgląd logów” nie wpływa na zawartość pliku z logami.

Nad polem „Podgląd logów” dostępne są następujące ikony:

[Chat ERP] – przycisk dodany w wersji 2024.3.0; otwiera okno ChatERP (zob. Korzystanie z ChatERP w aplikacji desktop Comarch BPM).

zapisz32 [Zapisz] – ikona dodana w wersji 2025.2.0; po kliknięciu w ikonę zmiany w ustawieniach dotyczących pola zarządzania logami (Zarządzanie logami z poziomu aplikacji/Zarządzanie poprzez konfigurację pliku NLog.config) i pola „Włącz zapisywanie logów” zostaną zapisane. Po kliknięciu w ikonę wyświetlana będzie animacja pięciu niebieskich kropek poniżej belki z nazwą sekcji. Czas animacji jest zależny od czasu wykonywania zapisu, nie blokuje działań operatora.

[Odśwież] – kliknięcie w tę ikonę powoduje ponowne pobranie danych z pliku z logami, a następnie wyświetlenie ich w polu „Podgląd logów”

[Eksportuj] – po kliknięciu w tę ikonę zostaje otwarte okno systemowe, w którym operator może wybrać lokalizację, w której zapisze skopiowany plik z logami wyświetlony w polu „Pliki z logami”. Po wyborze miejsca zapisu i po wprowadzeniu nazwy pliku należy kliknąć przycisk [Zapisz]. Plik jest domyślnie zapisywany w formacie txt. Przycisk [Wyeksportuj logi do pliku] nie jest aktywny, jeśli pole „Pliki z logami” jest puste.

Wybór miejsca zapisu kopii pliku z logami ogólnymi

Jeżeli kopiowanie pliku zakończy się sukcesem, wówczas wyświetlony zostanie komunikat „Plik został pomyślnie wyeksportowany”.

Uwaga

Wprowadzenie zmian w podglądzie logów tj. edycja czy usunięcie części lub całości loga nie będzie miało wpływu na zawartość wyeksportowanego pliku z logami.

Komunikat wyświetlany, jeśli z powodzeniem skopiowano plik do innej lokalizacji

W wersji 2025.2.0 usunięto ikonę [Usuń] – aby usunąć plik z logiem, należy usunąć go bezpośrednio w lokalizacji, w której się znajduje.

Sekcja Logi ogólne, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze

Widok sekcji „Logi ogólne”, w ramach zakładki „Logi z pracy systemu” na zakładce „Panel użytkownika” – przed włączeniem logów i odświeżeniem (gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze)

Od wersji 2025.2.0 (w przypadku, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze) w ramach sekcji „Logi ogólne” dostępne są następujące pola i przyciski:

- - „Pokaż logi zapisane od do” – w ramach tych pól operator może wskazać zakres dat, dla których wyświetlone zostaną logi z tabeli do. DF_WorkLogEntries. Po wskazaniu przez operatora dat w polach albo pozostawieniu wartości domyślnych, a następnie po kliknięciu w ikonę „Odśwież”, dane zostaną wyświetlone w tabelce z logami, dostępnej pod polami „Pokaż logi zapisane od do”, zgodnie ze wskazanymi datami i z obszarem pracy aplikacji, do którego odnosi się dana sekcja- w tym przypadku sekcja „Logi ogólne”. Domyślne wartości dla pól „Pokaż logi zapisane od do” to:
    - W polu „od” – bieżąca data z godziną 00:00:00;
    - W polu „do” – bieżąca data z godziną 23:59:59;
  - pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:
    - Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
    - Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

Uwaga

Opcja włączenia lub wyłączenia zapisywania logów w tabeli do.DF_WorkLogEnteries dotyczy jedynie logów z obszaru pracy danej sekcji – w tym przypadku sekcji „Logi ogólne”.

- - [Zapisz] – po kliknięciu w ikonę zmiany w ustawieniach dotyczących pola „Włącz zapisywanie logów” zostaną zapisane. Po kliknięciu w ikonę wyświetlana będzie animacja pięciu niebieskich kropek poniżej belki z nazwą sekcji. Czas animacji jest zależny od czasu wykonywania zapisu, nie blokuje działań operatora.
  - [Odśwież] – kliknięcie w tę ikonę powoduje pobranie danych dotyczących obszaru pracy sekcji „Logi ogólne” z tabeli do.DF_WorkLogEntries, zgodnie z zakresem dat wybranym w polach „Pokaż logi zapisane od do” oraz loginem operatora, a następnie wyświetlenie ich w tabelce z logami”.

- - – tabela, w której znajdują się dane dotyczące obszaru pracy sekcji „Logi ogólne” pobrane z tabeli do.DF_WorkLogEntries, zgodnie z zakresem dat wybranym w polach „Pokaż logi zapisane od do” oraz loginem operatora. W ramach tabeli dostępne są następujące kolumny:
    - Data utworzenia – dane pobrane z kolumny LE_TimeStamp z tabeli do.DF_WorkLogEntries;
    - Poziom logowania – dane pobrane z kolumny LE_Level z tabeli do.DF_WorkLogEntries;
    - Komunikat – dane pobrane z kolumny LE_Logger z tabeli do.DF_WorkLogEntries

W tabeli wyświetlane jest na raz maksymalnie 5 wierszy, jeśli jest ich więcej, obok tabelki dostępny jest suwak

Istnieje możliwość zmiany szerokości kolumn – w tym celu należy przesunąć kursor tak, aby znajdował się pomiędzy kolumnami, a gdy pojawi się ikona , kliknąć w nią i przeciągnąć w lewo lub w prawo.

Operator może posortować listę, klikając w nazwę danej kolumny – wówczas zostanie wyświetlona ikona – lista będzie posortowana rosnąco. Natomiast po kolejnym kliknięciu w nazwę danej kolumny widoczna będzie ikona- wówczas lista jest posortowana malejąco. Sortowanie odbywa się według wartości w danej kolumnie, w następującej kolejności:

Dla sortowania rosnąco:

- - - - Alfabetycznie,
      - Według wartości numerycznej (0-9),
      - Według znaków specjalnych,

Dla sortowania malejąco:

- - - - Według znaków specjalnych,
      - Według wartości numerycznej (0-9),
      - Alfabetycznie.

W ramach znajdującego się poniżej pola „Szczegóły komunikatu” operator może zobaczyć zawartość kolumn LE_TimeStamp, LE_Level, LE_Logger i LE_Message z tabeli do.DF_WorkLogEntries dla wybranego z tabeli wiersza. Operator może:

- - Zaznaczyć zawartość pola „Szczegóły komunikatu”;
  - Skopiować zawartość pola „Szczegóły komunikatu”;
  - Usunąć zawartość pola „Szczegóły komunikatu”.

Uwaga

Edycja albo usunięcie zawartości pola „Szczegóły komunikatu” przez operatora nie ma wpływu na zawartość danych, które znajdują się w tabeli do.DF_WorkLogEntries

Widok sekcji „Logi ogólne”, w ramach zakładki „Logi z pracy systemu” na zakładce „Panel użytkownika” – po włączeniu logów i odświeżeniu

Sekcja Logi z obszaru robotyzacji

Od wersji 2025.0.0 w ramach widoku sekcji „Logi z obszaru robotyzacji” widoczny jest następujący opis: W tej sekcji możliwe jest zarządzanie logami związanymi z pracą skryptów C# utworzonymi w ramach konfiguracji automatycznego trybu pracy.

Sekcja Logi z obszaru robotyzacji, gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”

Sekcja „Logi z obszaru robotyzacji” w zakładce „Logi z pracy systemu” – przed włączeniem logów (gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”)

W ramach pierwszego pola od lewej strony sekcji należy wybrać jedną z dwóch opcji:

- - Zarządzanie logami z poziomu aplikacji – wartość domyślna; jeśli operator wybierze tę opcję, wówczas będzie mógł:
    - wybrać opcję w polu „Włącz zapisywanie logów”,
    - zobaczyć zapisane logi w polu „Podgląd logów” i odświeżyć to pole,
    - zapisać plik z logami,
  - Zarządzanie poprzez konfigurację pliku NLog.config – jeśli operator wybierze tę opcję, wówczas zostanie wyłączona opcja edycji wszystkich innych pól w sekcji, ikony również będą nieaktywne. Po wyborze tej opcji operator:
    - nie może wybrać opcji w polu „Włącz zapisywanie logów”,
    - nie może zobaczyć zapisanych logów w polu „Podgląd logów” i odświeżać tego pola,
    - nie może zapisać pliku z logami z poziomu aplikacji.

Uwaga

Lokalizacja plików Nlog.config, jeśli wybrano opcję „Zarządzanie poprzez konfigurację pliku Nlog.config”: C:\[folder z aplikacją desktop]\Scriptcs_worker.

Widok sekcji „Logi z obszaru robotyzacji” po wyborze opcji „Zarządzanie poprzez konfigurację pliku NLog.config”

Jeżeli operator wybrał opcję „Zarządzanie logami z poziomu aplikacji”, wówczas powinien kliknąć w pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:

- - Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
  - Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

W wersji 2025.2.0 zamiast pola „Rozmiar pliku z logami” wprowadzono pole Pliki z logami – w tym polu dostępna jest lista utworzonych plików z logami z obszaru pracy systemu dla sekcji „Logi z obszaru robotyzacji”. Dane są pobierane do pola przy przejściu do zakładki albo po kliknięciu w ikonę [Odśwież] – wówczas w polu Pliki z logami wybrany zostanie najnowszy plik z logami, a jego zawartość wyświetli się w polu „Podgląd logów”. W ramach listy wyświetlana jest data utworzenia i nazwa pliku – domyślnie to plik BPM-desktop-robotization.log w katalogu AppData użytkownika/bieżącej puli, np. C:\Users\Jan.Kowalski\AppData\Roaming\.ComarchDMS.

Po wyborze pliku jego zawartość zostanie wyświetlona w polu „Podgląd logów”.

W centralnym miejscu sekcji znajduje się pole „Podgląd logów” – w ramach tego pola operator może zobaczyć zawartość pliku z logami, jeżeli spełniono poniższe warunki:

- - W polu „Włącz zapisywanie logów” wybrano wartość „Tak”
  - Wybrano plik z logami
  - Plik z logami ma zarejestrowane logi

Oprócz podglądu logów operator może zaznaczyć część lub całość zawartości pola, a następnie skopiować ją albo usunąć.

Uwaga

Edycja lub usunięcie zawartości pola „Podgląd logów” nie wpływa na zawartość pliku z logami.

Nad polem „Podgląd logów” dostępne są następujące ikony:

[Chat ERP] – przycisk dodany w wersji 2024.3.0; otwiera okno ChatERP (zob. Korzystanie z ChatERP w aplikacji desktop Comarch BPM)

[Odśwież] – kliknięcie w tę ikonę powoduje ponowne pobranie danych z pliku z logami, a następnie wyświetlenie ich w polu „Podgląd logów”

Wybór miejsca zapisu kopii pliku z logami z obszaru robotyzacji

Jeżeli kopiowanie pliku zakończy się sukcesem, wówczas wyświetlony zostanie komunikat „Plik został pomyślnie wyeksportowany”.

Uwaga

Wprowadzenie zmian w podglądzie logów tj. edycja czy usunięcie części lub całości logu nie będzie miało wpływu na zawartość wyeksportowanego pliku z logami.

Uwaga

W wersji 2025.2.0 usunięto ikonę

[Usuń] – aby usunąć plik z logiem, należy usunąć go bezpośrednio w lokalizacji, w której się znajduje

Sekcja Logi z obszaru robotyzacji, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze

Uwaga

Od wersji 2025.2.0 (w przypadku, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurz) w ramach sekcji „Logi z obszaru robotyzacji” dostępne są następujące pola i przyciski:

- - „Pokaż logi zapisane od do” – w ramach tych pól operator może wskazać zakres dat, dla których wyświetlone zostaną logi z tabeli do. DF_WorkLogEntries. Po wskazaniu przez operatora dat w polach albo pozostawieniu wartości domyślnych, a następnie po kliknięciu w ikonę „Odśwież”, dane zostaną wyświetlone w tabelce z logami, dostępnej pod polami „Pokaż logi zapisane od do”, zgodnie ze wskazanymi datami i z obszarem pracy aplikacji, do którego odnosi się dana sekcja- w tym przypadku sekcja „Logi ogólne”. Domyślne wartości dla pól „Pokaż logi zapisane od do” to:
    - W polu „od” – bieżąca data z godziną 00:00:00;
    - W polu „do” – bieżąca data z godziną 23:59:59;
  - pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:
    - Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
    - Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

Włączanie zapisywania logów w sekcji „Logi z obszaru robotyzacji”

Uwaga

Opcja włączenia lub wyłączenia zapisywania logów w tabeli do.DF_WorkLogEnteries dotyczy jedynie logów z obszaru pracy danej sekcji – w tym przypadku sekcji „Logi z obszaru robotyzacji”.

- - [Zapisz] – po kliknięciu w ikonę zmiany w ustawieniach dotyczących pola „Włącz zapisywanie logów” zostaną zapisane. Po kliknięciu w ikonę wyświetlana będzie animacja pięciu niebieskich kropek poniżej belki z nazwą sekcji. Czas animacji jest zależny od czasu wykonywania zapisu, nie blokuje działań operatora.
  - [Odśwież] – kliknięcie w tę ikonę powoduje pobranie danych z tabeli do.DF_WorkLogEntries zgodnie z wybranym zakresem dat, a następnie wyświetlenie ich poniżej w tabelce,

- - – tabela, w której znajdują się wpisy z tabeli do.DF_WorkLogEntries pobrane zgodnie z wybranym zakresem dat. W ramach tabeli dostępne są następujące kolumny:
  - Data utworzenia – dane pobrane z kolumny LE_TimeStamp z tabeli do.DF_WorkLogEntries;
  - Poziom logowania – dane pobrane z kolumny LE_Level z tabeli do.DF_WorkLogEntries;
  - Komunikat – dane pobrane z kolumny LE_Logger z tabeli do.DF_WorkLogEntries

W tabeli wyświetlane jest na raz maksymalnie 5 wierszy, jeśli jest ich więcej, obok tabelki dostępny jest suwak

Dla sortowania rosnąco:

- - - - Alfabetycznie,
      - Według wartości numerycznej (0-9),
      - Według znaków specjalnych,

Dla sortowania malejąco:

- - - - Według znaków specjalnych,
      - Według wartości numerycznej (0-9),
      - Alfabetycznie.

- - Zaznaczyć zawartość pola „Szczegóły komunikatu”;
  - Skopiować zawartość pola „Szczegóły komunikatu”;
  - Usunąć zawartość pola „Szczegóły komunikatu”.

Uwaga

Edycja albo usunięcie zawartości pola „Szczegóły komunikatu” przez operatora nie ma wpływu na zawartość danych, które znajdują się w tabeli do.DF_WorkLogEntries.

Sekcja „Logi z obszaru robotyzacji” na zakładce „Logi z pracy systemu” (przed włączeniem logów; gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze)

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

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu

Logi systemowe

Spis treści artykułu

Logi ogólne
- Sekcja „Logi ogólne”, gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”
- Sekcja „Logi ogólne z tabeli DF_WorkLogEntries” (połączone sekcje „Logi ogólne” i „Logi ogólne z tabeli DF_WorkLogEntries”), gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze
Logi z generowania dokumentu do ERP XL
- Sekcja „Logi z generowania dokumentu do ERP XL”, gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”
- Sekcja „Logi z generowania dokumentu do ERP XL”, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze
Logi z obszaru exe
- Sekcja „Logi z obszaru exe”, gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”
- Sekcja „Logi z obszaru exe”, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze
Logi z wykonywania skryptów C#
- Sekcja „Logi z wykonywania skryptów C#”, gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”
- Sekcja „Logi z wykonywania skryptów C#”, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze
Logi z tabeli DF_WorkLogEntries

W wersji 2024.2.1 w aplikacji desktop Comarch BPM (dawniej DMS) w ramach zakładki [Ustawienia] została dodana zakładka „Logi systemowe”. W zakładce możliwe jest zarządzanie logami zapisywanymi na serwerze IIS.

W wersji 2025.0.0 dodano opisy na zakładkach dotyczących zarządzania logami systemowymi.

W wersji 2025.2.0 w pliku Web.config w folderze z aplikacją serwerową dodano klucz SaveLogsInDatebase, który umożliwia dokonanie wyboru, gdzie powinny być zapisywane logi dla Comarch BPM pracującego lokalnie. Jeżeli wartość klucza to:

False – wartość domyślna; w takim przypadku logi będą zapisywane w postaci plików (jeśli klucz „OptimaCloudMode” ma wartość „False”). Maksymalny rozmiar pliku to 1 MB -jeśli plik z logami przekroczy ten rozmiar, tworzony jest następny w tej samej lokalizacji z dodatkowymi znakami (np. „ _1”). Lokalizacja pliku jest zależna od obszaru pracy aplikacji (zob. opisy poszczególnych sekcji dotyczących logów w Comarch BPM);
True – wówczas logi będą zapisywane wyłącznie w bazie danych Comarch BPM w tabeli do.DF_WorkLogEntries (jeśli klucz „OptimaCloudMode” ma wartość „False”).

Nowy klucz SaveLogsInDatebase w pliku Web.config

Od wersji 2025.2.0 jeśli Comarch BPM pracuje w chmurze, wówczas:

wszystkie logi będą zapisywane jedynie w ramach tabeli do.DF_WorkLogEntries w bazie danych Comarch BPM;
w tabeli do.DF_WorkLogEntries dodano kolumnę z Id operatora, który był zalogowany, gdy zapisywano logi z danego obszaru pracy Comarch BPM.

W ramach zakładki „Logi z pracy systemu” dostępne są następujące sekcje:

Logi ogólne – sekcja, w ramach której operator może zarządzać logami zapisywanymi na serwerze IIS z obszaru pracy aplikacji Comarch BPM (dawniej DMS);
Logi z generowania dokumentu do ERP XL – sekcja, w ramach której operator może zarządzać logami z generowania dokumentów z Comarch BPM (dawniej DMS) do systemu Comarch ERP XL; sekcja widoczna, jeśli spełnione zostały następujące warunki:
- w pliku Web.config w folderze z aplikacją serwerową w kluczu „WorkMode” wprowadzono wartość „XL” (w przypadku pracy w trybie jednofirmowym) lub skonfigurowano współpracę z Comarch ERP XL w ramach zakładki „Połączenia z ERP” na zakładce [Ustawienia] (w przypadku pracy w trybie wielofirmowym);
- Operator jest przypisany do spółki współpracującej z Comarch ERP XL
Logi z obszaru exe – sekcja, w ramach której operator może zarządzać logami z obszaru exe;
Logi z wykonywania skryptów C# – sekcja, w ramach której operator może zarządzać logami z wykonywania skryptów C#; sekcja widoczna, jeśli w pliku Web.config w folderze z aplikacja serwerową w kluczu „PremiumFunctionality” wprowadzono wartość „true”;
Logi z tabeli DF_WorkLogEntries – sekcja, w ramach której operator może zarządzać logami z tabeli do.DF_WorkLogEntries z bazy BPM (dawniej DMS)

Uwaga

Od wersji 2025.2.0 w przypadku, jeśli Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatebase” ma wartość „True” lub jeśli Comarch BPM pracuje w chmurze, wówczas dotychczasowe sekcje „Logi ogólne” i „Logi z tabeli DF_WorkLogEntries” zostają połączone w jedną sekcję o nazwie „Logi ogólne z tabeli DF_WorkLogEntries”

Od wersji 2025.0.0 w ramach widoku ogólnego zakładki „Logi systemowe”, dostępnego po kliknięciu w nazwę zakładki, widoczny jest następujący opis : W zakładce możliwe jest zarządzanie logami systemowymi z obszaru pracy aplikacji Comarch BPM zapisywanymi na serwerze IIS. W Panelu użytkownika w ramach zakładki „Logi z pracy systemu” możliwe jest zarządzanie logami z pracy aplikacji desktop Comarch BPM zapisywanymi na dysku lokalnym.

Widok zakładki „Logi systemowe” z wszystkimi dostępnymi sekcjami (w przypadku wersji 2025.2.0 i późniejszych – gdy program nie pracuje w chmurze i gdy w kluczu „SaveLogsInDatabase” wprowadzono wartość „False”)

Przed wersją 2025.2.0 po dokonaniu zmian w ramach zakładki przy próbie przejścia do innej zakładki wyświetlany jest następujący komunikat:

Komunikat wyświetlany po dokonaniu zmian przy próbie opuszczenia zakładki

Aby wprowadzone zmiany zostały zapisane, należy wybrać przycisk „Tak”.

Od wersji 2025.2.0 jeśli w ramach sekcji dokonano zmian, ale nie kliknięto w ikonę [Zapisz] w tej sekcji/ tych sekcjach, wówczas przy próbie przejścia do innej zakładki wyświetlony zostanie komunikat:

„W sekcji [Nazwa_Sekcji] nie zapisano zmiany ustawień. Czy zapisać zmiany?” (gdy zmian nie zapisano w jednej sekcji)

lub

„W sekcjach: [Nazwa_Sekcji1], [Nazwa_Sekcji2] nie zapisano zmiany ustawień. Czy zapisać zmiany?” (gdy zmian nie zapisano w więcej niż jednej sekcji).

W ramach komunikatu dostępne są następujące opcje:

Tak – jeśli operator wybierz tę opcję, wówczas zmiany dokonane w ustawieniach zostaną zapisane, komunikat zostanie zamknięty, a użytkownik wyjdzie z zakładki „Logi systemowe”;
Nie – jeżeli operator wybierze tę opcję, zmiany ustawień nie będą zapisane, komunikat zostanie zamknięty, a użytkownik wyjdzie z zakładki „Logi systemowe”;
Anuluj lub znak x – w przypadku, gdy operator wybierze jedną z tych opcji, zmiany ustawień nie będą zapisane, komunikat zostanie zamknięty, a użytkownik pozostanie na zakładce „Logi systemowe”.

Komunikat wyświetlony po wprowadzeniu zmian w wielu sekcjach i próbie przejścia do innej zakładki bez zapisu

Logi ogólne

Sekcja, w ramach której operator może zarządzać logami zapisywanymi na serwerze IIS z obszaru pracy aplikacji Comarch BPM (dawniej DMS).

Od wersji 2025.0.0 w ramach widoku sekcji „Logi ogólne” widoczny jest następujący opis: W tej sekcji możliwe jest zarządzanie logami ogólnymi z obszaru pracy aplikacji Comarch BPM zapisywanymi na serwerze IIS.

Sekcja „Logi ogólne”, gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”

Sekcja „Logi ogólne” w zakładce „Logi z pracy systemu” – po włączeniu logów i odświeżeniu

W ramach pierwszego pola od lewej strony sekcji należy wybrać jedną z dwóch opcji:

Zarządzanie logami z poziomu aplikacji – wartość domyślna; jeśli operator wybierze tę opcję, wówczas będzie mógł:
- wybrać opcję w polu „Włącz zapisywanie logów”,
- zobaczyć zapisane logi w polu „Podgląd logów” i odświeżyć to pole,
- zapisać plik z logami,
Zarządzanie poprzez konfigurację pliku NLog.config – jeśli operator wybierze tę opcję, wówczas zostanie wyłączona opcja edycji wszystkich innych pól w sekcji, ikony również będą nieaktywne. Po wyborze tej opcji operator:
- nie może wybrać opcji w polu „Włącz zapisywanie logów”,
- nie może zobaczyć zapisanych logów w polu „Podgląd logów” i odświeżać tego pola,
- nie może zapisać pliku z logami z poziomu aplikacji,
- nie może usunąć pliku z logami z poziomu aplikacji

Uwaga

Lokalizacja plików Nlog.config, jeśli wybrano opcję „Zarządzanie poprzez konfigurację pliku Nlog.config”: C:\inetpub\wwwroot\[folder z aplikacją serwerową]\bin

Jeżeli operator wybrał opcję „Zarządzanie logami z poziomu aplikacji”, wówczas powinien kliknąć w pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:

Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

W centralnym miejscu sekcji znajduje się pole „Podgląd logów” – w ramach tego pola operator może zobaczyć zawartość pliku z logami, jeżeli spełniono poniższe warunki:

W polu „Włącz zapisywanie logów” wybrano wartość „Tak”
Utworzono plik z logami
Plik z logami ma zarejestrowane logi

Oprócz podglądu logów operator może zaznaczyć część lub całość zawartości pola, a następnie skopiować ją albo usunąć.

Uwaga

Edycja lub usunięcie zawartości pola „Podgląd logów” nie wpływa na zawartość pliku z logamii.

Sekcja „Logi ogólne” z zawartością pliku z logami widoczną w polu „Podgląd logów”

Nad polem „Podgląd logów” dostępne są następujące ikony:

[Odśwież] – kliknięcie w tę ikonę powoduje ponowne pobranie danych z pliku z logami, a następnie wyświetlenie ich w polu „Podgląd logów”

[Eksportuj] – po kliknięciu w tę ikonę zostaje otwarte okno systemowe, w ramach którego należy wybrać miejsce, w którym zostanie zapisany skopiowany utworzony przedtem plik z logami, a następnie kliknąć w przycisk [Zapisz].

Jeżeli kopiowanie pliku zakończy się sukcesem, wówczas wyświetlony zostanie komunikat „Plik został pomyślnie wyeksportowany”.

Uwaga

Wprowadzenie zmian w podglądzie logów tj, edycja czy usunięcie części lub całości loga nie będzie miało wpływu na zawartość wyeksportowanego pliku z logami.

[Usuń] – po kliknięciu w ikonę zostanie wyświetlony komunikat „Czy na pewno chcesz usunąć plik z logami?”, w ramach którego dostępne są następujące opcje:

[Usuń] – jeśli operator kliknie w ten przycisk, wówczas plik z logami z określonej lokalizacji zostanie usunięty, a komunikat zostanie zamknięty;
[Anuluj] lub znak X – jeśli operator kliknie w ten przycisk, wówczas plik z logami z określonej lokalizacji nie zostanie usunięty, a komunikat zostanie zamknięty.

Komunikat wyświetlany po kliknięciu w przycisk „Usuń”

Logi z generowania dokumentu do ERP XL

Sekcja, w ramach której operator może zarządzać logami z generowania dokumentów z Comarch BPM (dawniej DMS) do systemu Comarch ERP XL; sekcja widoczna, jeśli w pliku Web.config w folderze z aplikacja serwerową w kluczu „WorkMode” wprowadzono wartość „XL” (w przypadku pracy w trybie jednofirmowym) lub skonfigurowano współpracę z Comarch ERP XL w ramach zakładki „Połączenia z ERP” na zakładce [Ustawienia] (w przypadku pracy w trybie wielofirmowym) oraz gdy operator jest przypisany do spółki współpracującej z Comarch ERP XL.

Od wersji 2025.0.0 w ramach widoku sekcji „Logi z generowania dokumentu do ERP XL” widoczny jest następujący opis: W tej sekcji możliwe jest zarządzanie logami związanymi z generowaniem dokumentów z Comarch BPM do systemu Comarch ERP XL.

Widok sekcji „Logi z generowania dokumentów do ERP XL” przed dokonaniem zmian

W ramach pierwszego pola od lewej strony sekcji należy wybrać jedną z dwóch opcji:

Zarządzanie logami z poziomu aplikacji – wartość domyślna; jeśli operator wybierze tę opcję, wówczas będzie mógł:
- wybrać opcję w polu „Włącz zapisywanie logów”,
- zobaczyć zapisane logi w polu „Podgląd logów” i odświeżyć to pole,
- zapisać plik z logami,
- usunąć plik z logami;
Zarządzanie poprzez konfigurację pliku NLog.config – jeśli operator wybierze tę opcję, wówczas zostanie wyłączona opcja edycji wszystkich innych pól w sekcji, ikony również będą nieaktywne. Po wyborze tej opcji operator:
- nie może wybrać opcji w polu „Włącz zapisywanie logów”,
- nie może zobaczyć zapisanych logów w polu „Podgląd logów” i odświeżać tego pola,
- nie może zapisać pliku z logami z poziomu aplikacji,
- nie może usunąć pliku z logami z poziomu aplikacji

Uwaga

Lokalizacja plików Nlog.config, jeśli wybrano opcję „Zarządzanie poprzez konfigurację pliku Nlog.config”: C:\inetpub\wwwroot\[nazwa aplikacji serwerowej] \bin\gen.

Uwaga

Dla Comarch BPM (dawniej DMS), który pracuje w chmurze, dostępne jest wyłącznie zarządzanie logami z poziomu aplikacji.

Jeżeli operator wybrał opcję „Zarządzanie logami z poziomu aplikacji”, wówczas powinien kliknąć w pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:

Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

W wersji 2025.2.0 zamiast pola „Rozmiar pliku z logami” wprowadzono pole Pliki z logami – w tym polu dostępna jest lista utworzonych plików z logami z obszaru pracy systemu dla sekcji „Logi ogólne”. Dane są pobierane do pola przy przejściu do zakładki albo po kliknięciu w ikonę [Odśwież] – wówczas w polu Pliki z logami wybrany zostanie najnowszy plik z logami, a jego zawartość wyświetli się w polu „Podgląd logów”. W ramach listy wyświetlana jest data utworzenia i nazwa pliku – domyślnie to plik BPM-iis-general.log.txt w katalogu AppData użytkownika/bieżącej puli, np. C:\Users\Jan.Kowalski\AppData\Roaming\.ComarchDMS.

Po wyborze pliku jego zawartość zostanie wyświetlona w polu „Podgląd logów”.

W centralnym miejscu sekcji znajduje się pole „Podgląd logów” – w ramach tego pola operator może zobaczyć zawartość pliku z logami, jeżeli spełniono poniższe warunki:

W polu „Włącz zapisywanie logów” wybrano wartość „Tak”
Wybrano plik z logami
Plik z logami ma zarejestrowane logi

Oprócz podglądu logów operator może zaznaczyć część lub całość zawartości pola, a następnie skopiować ją albo usunąć.

Uwaga

Edycja lub usunięcie zawartości pola „Podgląd logów” nie wpływa na zawartość pliku z logami.

Nad polem „Podgląd logów” dostępne są następujące ikony:

[Zapisz] – ikona dodana w wersji 2025.2.0; po kliknięciu w ikonę zmiany w ustawieniach dotyczących pola zarządzania logami (Zarządzanie logami z poziomu aplikacji/Zarządzanie poprzez konfigurację pliku NLog.config) i pola „Włącz zapisywanie logów” zostaną zapisane. Po kliknięciu w ikonę wyświetlana będzie animacja pięciu niebieskich kropek poniżej belki z nazwą sekcji. Czas animacji jest zależny od czasu wykonywania zapisu, nie blokuje działań operatora.

[Odśwież] – kliknięcie w tę ikonę powoduje ponowne pobranie danych z pliku z logami, a następnie wyświetlenie ich w polu „Podgląd logów”

Jeżeli kopiowanie pliku zakończy się sukcesem, wówczas wyświetlony zostanie komunikat „Plik został pomyślnie wyeksportowany”.

Uwaga

Wprowadzenie zmian w podglądzie logów tj, edycja czy usunięcie części lub całości loga nie będzie miało wpływu na zawartość wyeksportowanego pliku z logami.

Uwaga

W wersji 2025.2.0 usunięto ikonę

[Usuń] – aby usunąć plik z logiem, należy usunąć go bezpośrednio w lokalizacji, w której się znajduje .

Sekcja „Logi ogólne z tabeli DF_WorkLogEntries” (połączone sekcje „Logi ogólne” i „Logi ogólne z tabeli DF_WorkLogEntries”), gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze

Od wersji 2025.2.0 w przypadku, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze wówczas dotychczasowe sekcje „Logi ogólne” i „Logi z tabeli DF_WorkLogEntries” zostają połączone w jedną sekcję o nazwie „Logi ogólne z tabeli DF_WorkLogEntries”. W ramach sekcji widoczny jest następujący opis: „W tej sekcji możliwe jest zarządzanie logami ogólnymi z obszaru pracy aplikacji Comarch BPM zapisywanymi w tabeli DF_WorkLogEntries w bazie danych”.

W ramach sekcji „Logi ogólne z tabeli DF_WorkLogEntries” dostępne są następujące pola i przyciski:

„Pokaż logi zapisane od do” – w ramach tych pól operator może wskazać zakres dat, dla których wyświetlone zostaną logi z tabeli do. DF_WorkLogEntries. Po wskazaniu przez operatora dat w polach albo pozostawieniu wartości domyślnych, a następnie po kliknięciu w ikonę „Odśwież”, dane zostaną wyświetlone w tabelce z logami, dostępnej pod polami „Pokaż logi zapisane od do”, zgodnie ze wskazanymi datami i z obszarem pracy aplikacji, do którego odnosi się dana sekcja- w tym przypadku sekcja „Logi ogólne”. Domyślne wartości dla pól „Pokaż logi zapisane od do” to:
- W polu „od” – bieżąca data z godziną 00:00:00;
- W polu „do” – bieżąca data z godziną 23:59:59;
pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:
- Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
- Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

W wersji 2025.2.0 usunięto komunikat „Włączono zapisywanie logów”, wyświetlany po wyborze opcji „Tak” w ramach pola „Włącz zapisywanie logów” oraz komunikat „Wyłączono zapisywanie logów”, wyświetlany po wyborze opcji „Nie” w ramach pola „Włącz zapisywanie logów”.
[Zapisz] – po kliknięciu w ikonę zmiany w ustawieniach dotyczących pola „Włącz zapisywanie logów” zostaną zapisane. Po kliknięciu w ikonę wyświetlana będzie animacja pięciu niebieskich kropek poniżej belki z nazwą sekcji. Czas animacji jest zależny od czasu wykonywania zapisu, nie blokuje działań operatora.
[Odśwież] – kliknięcie w tę ikonę powoduje pobranie danych z tabeli do.DF_WorkLogEntries zgodnie z wybranym zakresem dat, a następnie wyświetlenie ich poniżej w tabelce.

– tabela, w której znajdują się wpisy z tabeli do.DF_WorkLogEntries pobrane zgodnie z wybranym zakresem dat. W ramach tabeli dostępne są następujące kolumny:

Data utworzenia – dane pobrane z kolumny LE_TimeStamp z tabeli do.DF_WorkLogEntries;
Poziom logowania – dane pobrane z kolumny LE_Level z tabeli do.DF_WorkLogEntries;
Komunikat – dane pobrane z kolumny LE_Logger z tabeli do.DF_WorkLogEntries

W tabeli wyświetlane jest na raz maksymalnie 5 wierszy, jeśli jest ich więcej, obok tabelki dostępny jest suwak

Zaznaczyć zawartość pola „Szczegóły komunikatu”;
Skopiować zawartość pola „Szczegóły komunikatu”;
Usunąć zawartość pola „Szczegóły komunikatu”.

Uwaga

Edycja lub usunięcie zawartości pola „Szczegóły komunikatu” nie wpływa na zawartość kolumny LE_Message w tabeli do.DF_WorkLogEntries

Widok sekcji „Logi ogólne z tabeli DF_WorkLogEntries” na zakładce „Logi systemowe” – po włączeniu logów i odświeżeniu

Logi z generowania dokumentu do ERP XL

Sekcja, w ramach której operator może zarządzać logami z generowania dokumentów z Comarch BPM do systemu Comarch ERP XL; sekcja widoczna, jeśli w pliku Web.config w folderze z aplikacja serwerową w kluczu „WorkMode” wprowadzono wartość „XL” (w przypadku pracy w trybie jednofirmowym) lub skonfigurowano współpracę z Comarch ERP XL w ramach zakładki „Połączenia z ERP” na zakładce [Ustawienia] (w przypadku pracy w trybie wielofirmowym) oraz gdy operator jest przypisany do spółki współpracującej z Comarch ERP XL.

Sekcja „Logi z generowania dokumentu do ERP XL”, gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”

Widok sekcji „Logi z generowania dokumentu do ERP XL” przed dokonaniem zmian

W ramach pierwszego pola od lewej strony sekcji należy wybrać jedną z dwóch opcji:

Zarządzanie logami z poziomu aplikacji – wartość domyślna; jeśli operator wybierze tę opcję, wówczas będzie mógł:
- wybrać opcję w polu „Włącz zapisywanie logów”,
- zobaczyć zapisane logi w polu „Podgląd logów” i odświeżyć to pole,
- zapisać plik z logami,
Zarządzanie poprzez konfigurację pliku NLog.config – jeśli operator wybierze tę opcję, wówczas zostanie wyłączona opcja edycji wszystkich innych pól w sekcji, ikony również będą nieaktywne. Po wyborze tej opcji operator:
- nie może wybrać opcji w polu „Włącz zapisywanie logów”,
- nie może zobaczyć zapisanych logów w polu „Podgląd logów” i odświeżać tego pola,
- nie może zapisać pliku z logami z poziomu aplikacji,

Uwaga

Lokalizacja plików Nlog.config, jeśli wybrano opcję „Zarządzanie poprzez konfigurację pliku Nlog.config”: C:\inetpub\wwwroot\[nazwa aplikacji serwerowej] \bin\gen.

Jeżeli operator wybrał opcję „Zarządzanie logami z poziomu aplikacji”, wówczas powinien kliknąć w pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:

Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

Włączanie zapisywania logów w sekcji „Logi z generowania dokumentu do ERP XL”

W wersji 2025.2.0 zamiast pola „Rozmiar pliku z logami” wprowadzono pole Pliki z logami – w tym polu dostępna jest lista utworzonych plików z logami z obszaru pracy systemu dla sekcji „Logi z generowania dokumentu do ERP XL”. Dane są pobierane do pola przy przejściu do zakładki albo po kliknięciu w ikonę [Odśwież] – wówczas w polu Pliki z logami wybrany zostanie najnowszy plik z logami, a jego zawartość wyświetli się w polu „Podgląd logów”. W ramach listy wyświetlana jest data utworzenia i nazwa pliku – domyślnie to plik BPM-iis-erpxl-generation.log.txt w katalogu AppData użytkownika/bieżącej puli, np. C:\Users\Jan.Kowalski\AppData\Roaming\.ComarchDMS.

Po wyborze pliku jego zawartość zostanie wyświetlona w polu „Podgląd logów”.

W centralnym miejscu sekcji znajduje się pole „Podgląd logów” – w ramach tego pola operator może zobaczyć zawartość pliku z logami, jeżeli spełniono poniższe warunki:

W polu „Włącz zapisywanie logów” wybrano wartość „Tak”
Wybrano plik z logami
Plik z logami ma zarejestrowane logi

Oprócz podglądu logów operator może zaznaczyć część lub całość zawartości pola, a następnie skopiować ją albo usunąć.

Uwaga

Edycja lub usunięcie zawartości pola „Podgląd logów” nie wpływa na zawartość pliku z logami.

Nad polem „Podgląd logów” dostępne są następujące ikony:

[Odśwież] – kliknięcie w tę ikonę powoduje ponowne pobranie danych z pliku z logami, a następnie wyświetlenie ich w polu „Podgląd logów”

Jeżeli kopiowanie pliku zakończy się sukcesem, wówczas wyświetlony zostanie komunikat „Plik został pomyślnie wyeksportowany”.

Uwaga

Wprowadzenie zmian w podglądzie logów tj. edycja czy usunięcie części lub całości loga nie będzie miało wpływu na zawartość wyeksportowanego pliku z logami.

Uwaga

W wersji 2025.2.0 usunięto ikonę

[Usuń] – aby usunąć plik z logiem, należy usunąć go bezpośrednio w lokalizacji, w której się znajduje .

Sekcja „Logi z generowania dokumentu do ERP XL”, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze

W ramach sekcji „Logi z generowania dokumentu do ERP XL” dostępne są następujące pola i przyciski:

„Pokaż logi zapisane od do” – w ramach tych pól operator może wskazać zakres dat, dla których wyświetlone zostaną logi z tabeli do. DF_WorkLogEntries. Po wskazaniu przez operatora dat w polach albo pozostawieniu wartości domyślnych, a następnie po kliknięciu w ikonę „Odśwież”, dane zostaną wyświetlone w tabelce z logami, dostępnej pod polami „Pokaż logi zapisane od do”, zgodnie ze wskazanymi datami i z obszarem pracy aplikacji, do którego odnosi się dana sekcja- w tym przypadku sekcja „Logi ogólne”. Domyślne wartości dla pól „Pokaż logi zapisane od do” to:
- W polu „od” – bieżąca data z godziną 00:00:00;
- W polu „do” – bieżąca data z godziną 23:59:59;
pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:
- Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
- Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

[Zapisz] – po kliknięciu w ikonę zmiany w ustawieniach dotyczących pola „Włącz zapisywanie logów” zostaną zapisane. Po kliknięciu w ikonę wyświetlana będzie animacja pięciu niebieskich kropek poniżej belki z nazwą sekcji. Czas animacji jest zależny od czasu wykonywania zapisu, nie blokuje działań operatora.
[Odśwież] – kliknięcie w tę ikonę powoduje pobranie danych z tabeli do.DF_WorkLogEntries zgodnie z wybranym zakresem dat, a następnie wyświetlenie ich poniżej w tabelce.

– tabela, w której znajdują się wpisy z tabeli do.DF_WorkLogEntries pobrane zgodnie z wybranym zakresem dat. W ramach tabeli dostępne są następujące kolumny:

Data utworzenia – dane pobrane z kolumny LE_TimeStamp z tabeli do.DF_WorkLogEntries;
Poziom logowania – dane pobrane z kolumny LE_Level z tabeli do.DF_WorkLogEntries;
Komunikat – dane pobrane z kolumny LE_Logger z tabeli do.DF_WorkLogEntries

W tabeli wyświetlane jest na raz maksymalnie 5 wierszy, jeśli jest ich więcej, obok tabelki dostępny jest suwak

Zaznaczyć zawartość pola „Szczegóły komunikatu”;
Skopiować zawartość pola „Szczegóły komunikatu”;
Usunąć zawartość pola „Szczegóły komunikatu”.

Uwaga

Edycja lub usunięcie zawartości pola „Szczegóły komunikatu” nie wpływa na zawartość kolumny LE_Message w tabeli do.DF_WorkLogEntries

Widok sekcji „Logi z generowania dokumentu do ERP XL” na zakładce „Logi systemowe” – przed włączeniem logów i odświeżeniem

Logi z obszaru exe

Sekcja, w ramach której operator może zarządzać logami z obszaru exe (dotyczącymi uruchamiania przez IIS dołączonych plików exe – konfigurowanego w polu „IIS” w ramach kontrolki typu Własna akcja).

Od wersji 2025.0.0 w ramach widoku sekcji „Logi z obszaru exe” widoczny jest następujący opis: W tej sekcji możliwe jest zarządzanie logami związanymi z uruchamianiem przez IIS dołączonych plików exe, które zostały skonfigurowane w ramach kontrolki typu Własna akcja.

Sekcja „Logi z obszaru exe”, gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”

Sekcja „Logi z obszaru exe” w zakładce „Logi z pracy systemu” – po włączeniu logów i po odświeżeniu

W ramach pierwszego pola od lewej strony sekcji należy wybrać jedną z dwóch opcji:

Zarządzanie logami z poziomu aplikacji – wartość domyślna; jeśli operator wybierze tę opcję, wówczas będzie mógł:
- wybrać opcję w polu „Włącz zapisywanie logów”,
- zobaczyć zapisane logi w polu „Podgląd logów” i odświeżyć to pole,
- zapisać plik z logami,
Zarządzanie poprzez konfigurację pliku NLog.config – jeśli operator wybierze tę opcję, wówczas zostanie wyłączona opcja edycji wszystkich innych pól w sekcji, ikony również będą nieaktywne. Po wyborze tej opcji operator:
- nie może wybrać opcji w polu „Włącz zapisywanie logów”,
- nie może zobaczyć zapisanych logów w polu „Podgląd logów” i odświeżać tego pola,
- nie może zapisać pliku z logami z poziomu aplikacji,

Uwaga

Lokalizacja plików Nlog.config, jeśli wybrano opcję „Zarządzanie poprzez konfigurację pliku Nlog.config”: C:\inetpub\wwwroot\[nazwa aplikacji serwerowej]\bin\exe.

Jeżeli operator wybrał opcję „Zarządzanie logami z poziomu aplikacji”, wówczas powinien kliknąć w pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:

Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

Włączanie zapisywania logów w sekcji „Logi z obszaru exe”

W wersji 2025.2.0 zamiast pola „Rozmiar pliku z logami” wprowadzono pole Pliki z logami – w tym polu dostępna jest lista utworzonych plików z logami z obszaru pracy systemu dla sekcji „Logi z obszaru exe”. Dane są pobierane do pola przy przejściu do zakładki albo po kliknięciu w ikonę [Odśwież] – wówczas w polu Pliki z logami wybrany zostanie najnowszy plik z logami, a jego zawartość wyświetli się w polu „Podgląd logów”. W ramach listy wyświetlana jest data utworzenia i nazwa pliku – domyślnie to plik BPM-iis-exe.log.txt w katalogu AppData użytkownika/bieżącej puli, np. C:\Users\Jan.Kowalski\AppData\Roaming\.ComarchDMS.

Po wyborze pliku jego zawartość zostanie wyświetlona w polu „Podgląd logów”.

W centralnym miejscu sekcji znajduje się pole „Podgląd logów” – w ramach tego pola operator może zobaczyć zawartość pliku z logami, jeżeli spełniono poniższe warunki:

W polu „Włącz zapisywanie logów” wybrano wartość „Tak”
Wybrano plik z logami
Plik z logami ma zarejestrowane logi

Oprócz podglądu logów operator może zaznaczyć część lub całość zawartości pola, a następnie skopiować ją albo usunąć.[/su_list]

Uwaga

Edycja lub usunięcie zawartości pola „Podgląd logów” nie wpływa na zawartość pliku z logami.

Nad polem „Podgląd logów” dostępne są następujące ikony:

[Odśwież] – kliknięcie w tę ikonę powoduje ponowne pobranie danych z pliku z logami, a następnie wyświetlenie ich w polu „Podgląd logów”

[Eksportuj] – po kliknięciu w tę ikonę zostaje otwarte okno systemowe, , w którym operator może wybrać lokalizację, w której zapisze skopiowany plik z logami wyświetlony w polu „Pliki z logami”. Po wyborze miejsca zapisu i po wprowadzeniu nazwy pliku należy kliknąć przycisk [Zapisz]. Plik jest domyślnie zapisywany w formacie txt. Przycisk [Wyeksportuj logi do pliku] nie jest aktywny, jeśli pole „Pliki z logami” jest puste.

Jeżeli kopiowanie pliku zakończy się sukcesem, wówczas wyświetlony zostanie komunikat „Plik został pomyślnie wyeksportowany”.

Uwaga

Wprowadzenie zmian w podglądzie logów tj. edycja czy usunięcie części lub całości loga nie będzie miało wpływu na zawartość wyeksportowanego pliku z logami.

Uwaga

W wersji 2025.2.0 usunięto ikonę

[Usuń] – aby usunąć plik z logiem, należy usunąć go bezpośrednio w lokalizacji, w której się znajduje .

Sekcja „Logi z obszaru exe”, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze

W ramach sekcji „Logi ogólne z tabeli DF_WorkLogEntries” dostępne są następujące pola i przyciski:

„Pokaż logi zapisane od do” – w ramach tych pól operator może wskazać zakres dat, dla których wyświetlone zostaną logi z tabeli do. DF_WorkLogEntries. Po wskazaniu przez operatora dat w polach albo pozostawieniu wartości domyślnych, a następnie po kliknięciu w ikonę „Odśwież”, dane zostaną wyświetlone w tabelce z logami, dostępnej pod polami „Pokaż logi zapisane od do”, zgodnie ze wskazanymi datami i z obszarem pracy aplikacji, do którego odnosi się dana sekcja- w tym przypadku sekcja „Logi ogólne”. Domyślne wartości dla pól „Pokaż logi zapisane od do” to:
- W polu „od” – bieżąca data z godziną 00:00:00;
- W polu „do” – bieżąca data z godziną 23:59:59;
pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:
- Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
- Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

[Zapisz] – po kliknięciu w ikonę zmiany w ustawieniach dotyczących pola „Włącz zapisywanie logów” zostaną zapisane. Po kliknięciu w ikonę wyświetlana będzie animacja pięciu niebieskich kropek poniżej belki z nazwą sekcji. Czas animacji jest zależny od czasu wykonywania zapisu, nie blokuje działań operatora.
[Odśwież] – kliknięcie w tę ikonę powoduje pobranie danych z tabeli do.DF_WorkLogEntries zgodnie z wybranym zakresem dat, a następnie wyświetlenie ich poniżej w tabelce..

– tabela, w której znajdują się wpisy z tabeli do.DF_WorkLogEntries pobrane zgodnie z wybranym zakresem dat. W ramach tabeli dostępne są następujące kolumny:

Data utworzenia – dane pobrane z kolumny LE_TimeStamp z tabeli do.DF_WorkLogEntries;
Poziom logowania – dane pobrane z kolumny LE_Level z tabeli do.DF_WorkLogEntries;
Komunikat – dane pobrane z kolumny LE_Logger z tabeli do.DF_WorkLogEntries

W tabeli wyświetlane jest na raz maksymalnie 5 wierszy, jeśli jest ich więcej, obok tabelki dostępny jest suwak

Zaznaczyć zawartość pola „Szczegóły komunikatu”;
Skopiować zawartość pola „Szczegóły komunikatu”;
Usunąć zawartość pola „Szczegóły komunikatu”.

Uwaga

Edycja lub usunięcie zawartości pola „Szczegóły komunikatu” nie wpływa na zawartość kolumny LE_Message w tabeli do.DF_WorkLogEntries

Widok sekcji „Logi z obszaru exe” na zakładce „Logi systemowe” – przed włączeniem logów i przed odświeżeniem

Logi z wykonywania skryptów C#

Sekcja, w ramach której operator może zarządzać logami z wykonywania skryptów C#; sekcja widoczna, jeśli w pliku Web.config w folderze z aplikacją serwerową w kluczu „PremiumFunctionality” wprowadzono wartość „true”.

Od wersji 2025.0.0 w ramach widoku sekcji „Logi z wykonywania skryptów C#” widoczny jest następujący opis: W tej sekcji możliwe jest zarządzanie logami zapisywanymi na serwerze IIS z wykonywania skryptów C# w aplikacji Comarch BPM.

Sekcja „Logi z wykonywania skryptów C#”, gdy Comarch BPM nie pracuje w chmurze i klucz „SaveLogsInDatabase” ma wartość „False”

Sekcja „Logi z wykonywania skryptów C#” w zakładce „Logi z pracy systemu” – przed włączeniem logów

W ramach pierwszego pola od lewej strony sekcji należy wybrać jedną z dwóch opcji:

Zarządzanie logami z poziomu aplikacji – wartość domyślna; jeśli operator wybierze tę opcję, wówczas będzie mógł:
- wybrać opcję w polu „Włącz zapisywanie logów”,
- zobaczyć zapisane logi w polu „Podgląd logów” i odświeżyć to pole,
- zapisać plik z logami,
Zarządzanie poprzez konfigurację pliku NLog.config – jeśli operator wybierze tę opcję, wówczas zostanie wyłączona opcja edycji wszystkich innych pól w sekcji, ikony również będą nieaktywne. Po wyborze tej opcji operator:
- nie może wybrać opcji w polu „Włącz zapisywanie logów”,
- nie może zobaczyć zapisanych logów w polu „Podgląd logów” i odświeżać tego pola,
- nie może zapisać pliku z logami z poziomu aplikacji.

Uwaga

Lokalizacja plików Nlog.config, jeśli wybrano opcję „Zarządzanie poprzez konfigurację pliku Nlog.config”: C:\inetpub\wwwroot\[nazwa aplikacji serwerowej]\bin\ Scriptcs_worker.

Jeżeli operator wybrał opcję „Zarządzanie logami z poziomu aplikacji”, wówczas powinien kliknąć w pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:

Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

Włączanie zapisywania logów w sekcji „Logi z wykonywania skryptów C#””

W wersji 2025.2.0 zamiast pola „Rozmiar pliku z logami” wprowadzono pole Pliki z logami – w tym polu dostępna jest lista utworzonych plików z logami z obszaru pracy systemu dla sekcji „Logi z wykonywania skryptów C#””. Dane są pobierane do pola przy przejściu do zakładki albo po kliknięciu w ikonę [Odśwież] – wówczas w polu Pliki z logami wybrany zostanie najnowszy plik z logami, a jego zawartość wyświetli się w polu „Podgląd logów”. W ramach listy wyświetlana jest data utworzenia i nazwa pliku – domyślnie to plik BPM-iis-csScriptsExecution.log.txt w katalogu AppData użytkownika/bieżącej puli, np. C:\Users\Jan.Kowalski\AppData\Roaming\.ComarchDMS.

Po wyborze pliku jego zawartość zostanie wyświetlona w polu „Podgląd logów”.

W centralnym miejscu sekcji znajduje się pole „Podgląd logów” – w ramach tego pola operator może zobaczyć zawartość pliku z logami, jeżeli spełniono poniższe warunki:

W polu „Włącz zapisywanie logów” wybrano wartość „Tak”
Wybrano plik z logami
Plik z logami ma zarejestrowane logi

Oprócz podglądu logów operator może zaznaczyć część lub całość zawartości pola, a następnie skopiować ją albo usunąć.

Uwaga

Edycja lub usunięcie zawartości pola „Podgląd logów” nie wpływa na zawartość pliku z logami.

Nad polem „Podgląd logów” dostępne są następujące ikony:

[Odśwież] – kliknięcie w tę ikonę powoduje ponowne pobranie danych z pliku z logami, a następnie wyświetlenie ich w polu „Podgląd logów”

Jeżeli kopiowanie pliku zakończy się sukcesem, wówczas wyświetlony zostanie komunikat „Plik został pomyślnie wyeksportowany”.

Uwaga

Wprowadzenie zmian w podglądzie logów tj. edycja czy usunięcie części lub całości loga nie będzie miało wpływu na zawartość wyeksportowanego pliku z logami.

Uwaga

W wersji 2025.2.0 usunięto ikonę

[Usuń] – aby usunąć plik z logiem, należy usunąć go bezpośrednio w lokalizacji, w której się znajduje .

Sekcja „Logi z wykonywania skryptów C#”, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze

W wersji 2025.2.0 opis zakładki został zmieniony na W tej sekcji możliwe jest zarządzanie logami z wykonywania skryptów C# w aplikacji Comarch BPM.

W ramach sekcji „Logi ogólne z tabeli DF_WorkLogEntries” dostępne są następujące pola i przyciski:

„Pokaż logi zapisane od do” – w ramach tych pól operator może wskazać zakres dat, dla których wyświetlone zostaną logi z tabeli do. DF_WorkLogEntries. Po wskazaniu przez operatora dat w polach albo pozostawieniu wartości domyślnych, a następnie po kliknięciu w ikonę „Odśwież”, dane zostaną wyświetlone w tabelce z logami, dostępnej pod polami „Pokaż logi zapisane od do”, zgodnie ze wskazanymi datami i z obszarem pracy aplikacji, do którego odnosi się dana sekcja- w tym przypadku sekcja „Logi ogólne”. Domyślne wartości dla pól „Pokaż logi zapisane od do” to:
- W polu „od” – bieżąca data z godziną 00:00:00;
- W polu „do” – bieżąca data z godziną 23:59:59;
pole „Włącz zapisywanie logów”. W ramach tego pola dostępne są 2 opcje:
- Tak – wybranie tej opcji powoduje włączenie zapisywania logów;
- Nie – wartość domyślna; jeśli wybrano tę opcję, wówczas logi nie są rejestrowane.

[Zapisz] – po kliknięciu w ikonę zmiany w ustawieniach dotyczących pola „Włącz zapisywanie logów” zostaną zapisane. Po kliknięciu w ikonę wyświetlana będzie animacja pięciu niebieskich kropek poniżej belki z nazwą sekcji. Czas animacji jest zależny od czasu wykonywania zapisu, nie blokuje działań operatora.
[Odśwież] – kliknięcie w tę ikonę powoduje pobranie danych z tabeli do.DF_WorkLogEntries zgodnie z wybranym zakresem dat, a następnie wyświetlenie ich poniżej w tabelce..

– tabela, w której znajdują się wpisy z tabeli do.DF_WorkLogEntries pobrane zgodnie z wybranym zakresem dat. W ramach tabeli dostępne są następujące kolumny:

Data utworzenia – dane pobrane z kolumny LE_TimeStamp z tabeli do.DF_WorkLogEntries;
Poziom logowania – dane pobrane z kolumny LE_Level z tabeli do.DF_WorkLogEntries;
Komunikat – dane pobrane z kolumny LE_Logger z tabeli do.DF_WorkLogEntries

W tabeli wyświetlane jest na raz maksymalnie 5 wierszy, jeśli jest ich więcej, obok tabelki dostępny jest suwak

Zaznaczyć zawartość pola „Szczegóły komunikatu”;
Skopiować zawartość pola „Szczegóły komunikatu”;
Usunąć zawartość pola „Szczegóły komunikatu”.

Uwaga

Edycja lub usunięcie zawartości pola „Szczegóły komunikatu” nie wpływa na zawartość kolumny LE_Message w tabeli do.DF_WorkLogEntries

Widok sekcji „Logi z wykonywania skryptów C#” na zakładce „Logi systemowe” – przed włączeniem logów i przed odświeżeniem

Logi z tabeli DF_WorkLogEntries

Od wersji 2025.0.0 w ramach widoku sekcji „Logi z tabeli DF_WorkLogEntries” widoczny jest następujący opis: W tej sekcji możliwe jest zarządzanie logami zapisywanymi w tabeli DF_WorkLogEntries w bazie BPM.

Uwaga

Od wersji 2025.2.0 w przypadku, gdy Comarch BPM pracuje lokalnie i klucz „SaveLogsInDatabase” ma wartość „True” lub gdy Comarch BPM pracuje w chmurze, wówczas dotychczasowe sekcje „Logi ogólne” i „Logi z tabeli DF_WorkLogEntries” zostają połączone w jedną sekcję o nazwie „Logi ogólne z tabeli DF_WorkLogEntries”.

Widok sekcji „Logi z tabeli DF_WorkLogEntries” przed dokonaniem zmian

W ramach pól [Pokaż logi zapisane od do] należy wprowadzić zakres dat, według którego będą zawężane wpisy z tabeli do. DF_WorkLogEntries i wyświetlane w tabeli znajdującej się pod tym polem.

Nad polem „Szczegóły komunikatu” dostępne są następujące elementy:

[Odśwież] – kliknięcie w tę ikonę powoduje pobranie danych z tabeli do.DF_WorkLogEntries zgodnie z wybranym zakresem dat, a następnie wyświetlenie ich poniżej w tabelce.

Sekcja „Logi z tabeli DF_WorkLogEntries” z zawartością pliku z logami widoczną w polu „Szczegóły komunikatu” po kliknięciu w przycisk „Odśwież”

[Wyeksportuj logi do pliku .xls] – po kliknięciu w tę ikonę zostaje otwarte okno systemowe, w ramach którego należy wybrać miejsce, w którym zostanie zapisany plik xls z zawartością tabeli do.DF_WorkLogEntries z wybranego zakresu czasowego.

Jeżeli kopiowanie pliku zakończy się sukcesem, wówczas wyświetli się komunikat „Plik został pomyślnie wyeksportowany”, następnie zaś wyeksportowany plik zostanie automatycznie otwarty.

Wybór miejsca zapisu kopii pliku z logami z tabeli DF_WorkLogEntries

Plik xls wyeksportowany do wybranej lokalizacji

[Usuń] – po kliknięciu w ikonę zostanie wyświetlony komunikat „Czy na pewno chcesz usunąć wszystkie wpisy z tabeli do.DF_WorkLogEntries?”, w ramach którego dostępne są następujące opcje:

[Usuń] – jeśli operator kliknie w ten przycisk, wówczas wszystkie wpisy z tabeli do.DF_WorkLogEntries zostaną usunięte, a komunikat zostanie zamknięty;
[Anuluj] lub znak X – jeśli operator kliknie w ten przycisk, wówczas wpisy z tabeli do.DF_WorkLogEntries nie zostaną usunięte, a komunikat zostanie zamknięty.

– tabela, w której znajdują się wpisy z tabeli do.DF_WorkLogEntries pobrane zgodnie z wybranym zakresem dat. W ramach tabeli dostępne są następujące kolumny:

Data utworzenia – dane pobrane z kolumny LE_TimeStamp z tabeli do.DF_WorkLogEntries;
Poziom logowania – dane pobrane z kolumny LE_Level z tabeli do.DF_WorkLogEntries;
Komunikat – dane pobrane z kolumny LE_Logger z tabeli do.DF_WorkLogEntries

W tabeli wyświetlane jest na raz maksymalnie 5 wierszy, jeśli jest ich więcej, obok tabelki dostępny jest suwak

Zaznaczyć zawartość pola „Szczegóły komunikatu”;
Skopiować zawartość pola „Szczegóły komunikatu”;
Usunąć zawartość pola „Szczegóły komunikatu”.

Uwaga

Edycja lub usunięcie zawartości pola „Szczegóły komunikatu” nie wpływa na zawartość kolumny LE_Message w tabeli do.DF_WorkLogEntries

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu

Domena

Zakładka „Domena” jest widoczna w ustawieniach aplikacji Comarch BPM (dawniej DMS) tylko w trybie jednofirmowym – w trybie wielofirmowym pola pełniące analogiczną funkcję znajdują się w definicji danej spółki na zakładce „Połączenia z ERP” (zob. Połączenia z ERP).

Wypełnienie pól na zakładce „Domena” umożliwia wybranym operatorom logowanie się do Comarch BPM (dawniej DMS) poprzez daną domenę.

Zakładka „Domena” w Comarch BPM (dawniej DMS) Standalone

Zakładka „Domena” w Comarch BPM (dawniej DMS) we współpracy z Comarch ERP Optima

Aby możliwe było logowanie się za pomocą domeny, należy zaznaczyć checkbox „Używaj domeny”.

Następnie w ramach pola „Nazwa domeny” należy wybrać nazwę odpowiedniej domeny z rozwijanej listy.

Po wybraniu domeny konieczne jest również dokonanie wyboru grupy, w ramach której ma nastąpić logowanie. Jeżeli administrator nie chce dokonać zawężenia do jednej grupy, może wybrać opcję „Wszystkie”, znajdującą się na szczycie listy.

Wprowadzone zmiany należy zapisać, klikając w ikonę zapisz32 [Zapisz]. Gdy dokonano zapisu, zostanie wyświetlony nastepujący komunikat:

Komunikat wyświetlany po zapisaniu ustawień w zakladce „Domena”

Aby ustawić logowanie domenowe dla wybranego operatora administrator powinien następnie:

1. Przejść na zakładkę „Struktura organizacyjna”

2. Wybrać kartę danego pracownika

3. W sekcji „Ogólne” zaznaczyć checkbox w polu „Logowanie domenowe„.

4. Po zaznaczeniu checkboxa kliknąć w znajdujący się obok link „Ustaw”, a następnie w ramach pola „Lista członków domeny [nazwa członków domeny]” wpisać frazę pochodzącą z nazwy osoby, która należy do danej domeny i której dane domenowe mają zostać powiązane z danym pracownikiem.

Z wyświetlonej listy należy wybrać odpowiednią pozycję i nacisnąć przycisk [Zapisz].

Wybór członka domeny z listy po wpisaniu frazy pochodzącej z nazwy osoby należącej do domeny

Na karcie pracownika na zakładce „Ogólne” automatycznie wprowadzone zostają :

w polu „Login” – wybrany login do domeny
w polu „Imię i nazwisko” – imię i nazwisko przypisane w ramach domeny
w polu „Email” – adres email związany z domeną
w polu „Hasło” (niewidoczne) – hasło do domeny

Powyższe pola nie mogą zostać edytowane do czasu odznaczenia parametru „Logowanie domenowe” na karcie pracownika.

Uwaga

Aby wprowadzone zmiany (zarówno włączenie, jak i wyłączenie logowania domenowego) zostały zachowane, przed opuszczeniem karty pracownika należy zapisać zmiany za pomocą ikony zapisz32

[Zapisz].

Karta pracownika, sekcja „Ogólne” po ustawieniu logowania domenowego

Od tej pory dany operator może logować się do Comarch BPM (dawniej DMS) za pomocą tego samego loginu i hasła, jakiego używa do logowania się do danej domeny.

Uwaga

Jeśli:

operator, którego zaimportowano z Comarch ERP XL, korzysta z logowania domenowego

oraz

na definicji operatora w zakladce Uprawnienia, w sekcji Uprawnienia ogólne, w ramach pola Zastosuj login ERP wybrano opcję Z konfiguracji

w takim przypadku podczas logowania do systemu Comarch ERP XL operator zaloguje się do Comarch ERP XL na konto domenowe (pomimo ustawienia Zastosuj login ERP z konfiguracji).

Logowanie operatora przez domenę – przykład

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu

Załącznik

Kontrolka typu „Załącznik” umożliwia załączanie plików:

z dysku
bezpośrednio z urządzenia typu skaner lub z innych urządzeń
z modułu Repozytorium (od wersji 2023.1.0; jeśli współpraca Comarch BPM (dawniej DMS) z Repozytorium jest włączona; zob. Załącznik dodany z modułu Repozytorium)

Kontrolka posiada możliwość uruchomienia skanera w celu wykonania skanu dokumentu.

Uwaga

Uruchomienie skanera jest możliwe tylko w przypadku aplikacji stacjonarnej.

Uwaga

Dodawanie załącznika z modułu Repozytorium jest aktualnie możliwe zarówno w przypadku aplikacji stacjonarnej, jak i (od wersji 2024.2.0) w nowej aplikacji web (zob. Wybór załącznika z modułu Repozytorium w nowej aplikacji web).

Uwaga

Od wersji 2024.3.0 w przypadku, jeśli na definicji kontrolki typu załącznik zaznaczono opcję „Mobilny podpis”, wówczas dodanie do niej załącznika z poziomu aplikacji desktop lub web nie jest możliwe, zaś z poziomu aplikacji mobilnej możliwe jest jedynie dodanie podpisu.

Od wersji 2024.3.0 w przypadku, jeśli na definicji kontrolki typu załącznik zaznaczono opcję „Zablokuj usuwanie załączników”, wówczas nie jest możliwe usunięcie z danej kontrolki załącznika, który został do niej dodany.

Właściwości kontrolki typu Załącznik są podzielone na dwie sekcje:

Ogólne
Archiwa

W ramach sekcji „Ogólne” dostępne są następujące pola:

Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Podpisy elektroniczne PDF – checkbox dodany w wersji 2023.0.0; po jego zaznaczeniu przy załącznikach formacie PDF dostępny jest przycisk do podpisywania dokumentów (zob. Podpisy elektroniczne dokumentów PDF).
Mobilny podpis – parametr wprowadzony w wersji 2024.3.0; znajduje się na definicji kontrolki typu Załącznik; domyślnie odznaczony. Zaznaczenie parametru powoduje zmianę w działaniu kontrolki typu załącznik – zob. Podpis mobile na kontrolce typu Załącznik
Zablokuj usuwanie załączników – parametr wprowadzony w wersji 2024.3.0; znajduje się na definicji kontrolki typu Załącznik; domyślnie odznaczony. Jeśli parametr zostanie zaznaczony, wówczas żaden operator na żadnym etapie nie będzie mógł usunąć pliku/plików z danej kontrolki typu Załącznik;
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Wersjonowanie pliku – opcja „Tak” umożliwia podpięcie kilku wersji tego samego pliku o takiej samej nazwie pod jedną kontrolkę. Każdy nowo dodany plik zawiera na końcu nazwy kolejny numer wersji podany w nawiasach. Domyślną opcją jest „Nie”.

Zakładka typu Załącznik, sekcja „Ogólne”

W ramach sekcji „Archiwa” dostępne są następujące pola:

Manager dokumentów – umożliwia załączanie plików umieszczonych w managerze dokumentów albo „Współpraca z Repozytorium” – jeśli współpraca z Repozytorium jest włączona.
Nazwa spółki – parametr dostepny w trybie wielospółkowym, w parametrze należy wskazać spółkę, w której będą zapisywane załączniki.
Lokalizacja – pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; lokalizacja w Repozytorium, do której powinny być przesyłane pliki.
Pozwalaj na wybór lokalizacji podczas dodawania załącznika – parametr dostępny od wersji 2025.2.0; jeśli został zaznaczony, podczas dodawania załącznika na dokumencie Comarch BPM zostanie otwarte okno, w ramach którego operator może wybrać lokalizację w Comarch BPM Repozytorium, w której ma zostać zapisany dany załącznik (gdy zaznaczono parametr „Współpraca z Repozytorium”); parametr jest domyślnie odznaczony (zob. Wybór lokalizacji zapisu załącznika w Comarch BPM Repozytorium przez operatora dodającego załącznik w aplikacji desktop).
Podczas zapisu załącznika w Repozytorium stosuj – jedno z dwóch pól dostępnych od 2024.2.0 zamiast pola ‘Zastosuj login operatora Repozytorium’; pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; w tym polu należy wybrać operatora, w którego imieniu załączniki będą zapisywane w Repozytorium.
Podczas pracy z załącznikiem z Repozytorium stosuj – jedno z dwóch pól dostępnych od 2024.2.0 zamiast pola ‘Zastosuj login operatora Repozytorium’; pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; w tym polu należy wybrać operatora, w którego imieniu będzie odbywać się praca z załącznikami w Repozytorium.
przycisk ‘Dodaj’ w sekcji ” Ustawienia typów dokumentów” – pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; pod napisem ‘Typy’ powinny zostać wybrane takie właściwości jak:
- typ dokumentów, który będzie przypisywany do przesłanych plików, a także określony typ domyślny
- po kliknięciu „Dodaj”, a następnie wyborze konkretnych atrybutów i kliknięciu „Ustaw” – kontrolki BPM (dawniej DMS), które zostaną zmapowane do atrybutów
Etap mapowania – pole dostępne, gdy zaznaczono checkbox przy „Współpraca z Repozytorium”; etap obiegu dokumentu, na którym wartości kontrolek zostaną zmapowane do atrybutów, a także typ dokumentu będzie zmapowany na plik przesłany do Repozytorium

Opcje dostępne w sekcji „Archiwa” są szczegółowo omówione w rozdziale Konfiguracja kontrolki typu Załącznik w ramach integracji modułu Repozytorium z modułem Workflow.

Dla parametru „Nazwa spółki” możliwe są opcje:

„Brak spółki – baza OD” – załączniki są zapisywane do bazy Comarch BPM (dawniej DMS),
„Brak spółki – IBARD” – załączniki są zapisywane w usłudze Comarch IBARD.

Wartość “Brak spółki” dla kontrolki typu Załącznik

Kontrolka typu Załącznik, sekcja „Archiwa” – gdy włączona jest współpraca z Managerem dokumentów

Kontrolka typu Załącznik, sekcja „Archiwa”, gdy włączono współpracę z modułem Repozytorium – przykład

Obok nazwy załączonego pliku prezentowana jest:

- w przypadku załącznika dodanego z dysku lub ze skanu:
  - ikona podpisu elektronicznego (jeśli w ustawieniach kontrolki typu załącznik zaznaczono parametr „Podpis elektroniczny PDF i jeśli dodany załącznik jest w formacie PDF)
  - ikona zapisu załącznika (umożliwia zapisanie pliku na dysk lokalny)
  - ikona kosza (umożliwia odpięcie pliku od dokumentu). Ikona kosza jest nieaktywna, gdy na właściwościach kontrolki został oznaczony parametr „Tylko do odczytu”.
- w przypadku załącznika dodanego z modułu Repozytorium:
  - ikona podpisu elektronicznego (po zapisaniu dokumentu w Comarch BPM (dawniej DMS) – jeśli w ustawieniach kontrolki typu załącznik zaznaczono parametr „Podpis elektroniczny PDF i jeśli dodany załącznik jest w formacie PDF)
  - ikona zapisu załącznika (umożliwia zapisanie pliku na dysk lokalny)
  - ikona kosza (umożliwia odpięcie pliku od dokumentu). Ikona kosza jest nieaktywna, gdy na właściwościach kontrolki został oznaczony parametr „Tylko do odczytu”
  - ikona zmiany typu dokumentu (umożliwia zmianę typu dokumentu w Repozytorium na jeden z dostępnych w ustawieniach danej kontrolki typu załącznik. Ikona jest niewidoczna, gdy na właściwościach kontrolki został oznaczony parametr „Tylko do odczytu”.

Dwie kontrolki typu załącznik na nowym dokumencie w Comarch BPM (dawniej DMS) – do kontrolki „Załącznik” dodano plik PDF i graficzny z dysku, a do kontrolki „Załącznik 2” – z Repozytorium

W pliku Web.config znajduje się klucz: <add key=”DestinationAttachmentsWorkflow” value=”” />.
Wartość klucza definiuje bazę, w której będą przechowywane załączniki dodawane do dokumentów.

Klucz <add key=”DestinationAttachmentsWorkflow” value=”” /> przyjmuje wartości:

„DO” – baza danych BPM (dawniej DMS),
„XL” – baza danych ERP XL,
„IBARD” – usługa IBARD.

Załączniki z Managera dokumentów

Załączanie plików przechowywanych w managerze dokumentów dostępne jest dla pracowników posiadających uprawnienie do pracy z modułem Manager dokumentów (zob. Dostęp do modułu Manager dokumentów), w tych typach obiegów, w których na kontrolce typu Załącznik zaznaczono parametr „Manager dokumentów”.

Możliwe jest przesyłanie załączników z managera dokumentów na dysk lokalny. Lokalizację przechowywania plików przesłanych do managera dokumentów określa klucz:
<add key=”DestinationAttachmentsRepository” value=”DO” />. Przyjmuje wartości:

„DO” – baza danych BPM (dawniej DMS)
„IBARD” – usługa IBARD.

Operator posiadający uprawnienia do Managera dokumentów, podczas dodawania plików w kontrolce typu Załącznik będzie miał dostępną do wyboru opcję „Z managera dokumentów”

Menu wyboru źródła, z którego zostanie załączony plik do dokumentu BPM (dawniej DMS), widoczna pozycja „Z managera dokumentów”.

Operator może do kontrolki typu Załącznik dodać wyłącznie te pliki, do których posiada przynajmniej uprawnienie do podglądu.

Okno Managera dokumentów wywołane z kontrolki typu Załącznik

Plik zostanie załączony po podświetleniu w wywołanym oknie managera dokumentów i kliknięciu w ikonę lub po podwójnym kliknięciu w wiersz, w którym wyświetlane są informacje o pliku.

Załączniki w Comarch BPM (dawniej DMS) Repozytorium

W przypadku, gdy spółka korzysta z funkcjonalności Comarch BPM (dawniej DMS) Repozytorium, załączniki przesyłane do Repozytorium mogą być przechowywane w bazie MongoDB lub w usłudze IBARD. Dokumentacja dotycząca funkcjonalności Repozytorium znajduje się na indywidualnych stronach partnerów oraz na stronach pomocowych pod adresem Comarch BPM – Repozytorium – Baza Wiedzy programu Comarch BPM.

Blokada usuwania załączników

W wersji 2024.3.0 udostępniono funkcjonalność zablokowania usuwania załączników z kontrolki typu Załącznik.

W tym celu na definicji kontrolki typu Załącznik w aplikacji desktop dodano parametr „Zablokuj usuwanie załączników” (domyślnie odznaczony). Jeśli parametr zostanie zaznaczony, wówczas żaden operator na żadnym etapie nie będzie mógł usunąć pliku/plików z danej kontrolki typu Załącznik.

Uwaga

Parametr „Zablokuj usuwanie załączników” wpływa na wszystkie pliki, które dołączono do kontrolki typu Załacznik, także te z włączonym parametrem „Mobilny podpis”.

Kontrolka typu Załącznik z zaznaczonym parametrem „Zablokuj usuwanie załączników”

Dokument z dodanym załącznikiem, gdy zaznaczono blokadę usuwania załącznika

Powrót do początku artykułu

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu

Wybór lokalizacji zapisu załącznika w Comarch BPM Repozytorium przez operatora dodającego załącznik w aplikacji desktop

W wersji 2025.2.0 umożliwiono operatorowi, który dodaje załącznik do dokumentu w Comarch BPM, wybranie,do którego folderu w Comarch BPM Repozytorium ma trafić taki załącznik.

W tym celu na definicji kontrolki typu Załącznik, w ramach zakładki „Archiwa” dodano nowy parametr „Pozwalaj na wybór lokalizacji podczas dodawania załącznika”.

Parametr jest domyślnie odznaczony – w takim przypadku załącznik dodawany na dokumencie zostanie zapisany w domyślnej lokalizacji w Comarch BPM Repozytorium, wybranej w polu „Lokalizacja” na zakładce „Archiwa” na definicji kontrolki.

Parametr „Pozwalaj na wybór lokalizacji podczas dodawania załącznika” na definicji kontrolki typu Załącznik

Jeżeli parametr „Pozwalaj na wybór lokalizacji podczas dodawania załącznika” został zaznaczony, wówczas podczas dodawania załącznika na dokumencie Comarch BPM zostanie otwarte okno, w którym operator może wybrać lokalizację w Comarch BPM Repozytorium, w której ma zostać zapisany dany załącznik.

Wybór lokalizacji przy dodawaniu załącznika na nowym dokumencie – domyślna lokalizacja

W ramach listy dostępnych lokalizacji wyświetlana jest lokalizacja domyślna (z pola „Lokalizacja” na definicji danej kontrolki typu Załącznik) oraz te katalogi w Comarch BPM Repozytorium, do których dany operator/operator z konfiguracji ma prawo do dokonania zapisu. W oknie wyświetlanych jest jednocześnie do 10 pozycji; jeśli jest ich więcej, można przejść do nich za pomocą suwaka.

Uwaga

W przypadku, jeśli operator doda jednocześnie do kontrolki typu Załącznik wiele załączników, wówczas lokalizacja wybrana w ramach okna zostanie zastosowana w stosunku do wszystkich aktualnie dodawanych załączników.

Lista lokalizacji do wyboru przy dodawaniu załącznika na nowym dokumencie (gdy użytkownik ma uprawnienia do nie więcej niż 10 lokalizacji w Repozytorium)

Lokalizacja wybrana przy dodawaniu załącznika na nowym dokumencie

Po wyborze lokalizacji należy potwierdzić wybór, klikając w przycisk [OK] – wówczas załącznik zostanie zapisany w wybranej lokalizacji.

W przypadku, jeśli na definicji danej kontrolki typu Załącznik wybrano więcej niż 1 typ dokumentu, wówczas operator przy dodawaniu załącznika najpierw wybiera typ dokumentu, a później lokalizację.

Jeżeli na definicji danej kontrolki typu Załącznik w ramach pola „Podczas zapisu załącznika w Repozytorium stosuj” wybrano „Login własny operatora”, a operator, który dodaje załącznik, nie ma uprawnień do żadnej lokalizacji w Repozytorium, wówczas zostanie wyświetlony komunikat informujący o braku uprawnień do dostępnych lokalizacji.

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu

Ręczna konfiguracja aplikacji WEB (nowej aplikacji web)

Po wykonaniu początkowych kroków instalacji Comarch BPM (dawniej DMS) oraz po instalacji aplikacji serwerowej (zob. artykuł Instalacja początkowa Comarch BPM (dawniej DMS) i instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym 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, Comarch BPM (dawniej DMS) we współpracy z Comarch ERP Enterprise) należy przystąpić do konfiguracji aplikacji WEB

Uwaga

Dla poprawnego działania aplikacji WEB należy zainstalować następujące dodatki do serwera IIS:

Application Request Routing – dodatek można pobrać pod następującym adresem: https://www.microsoft.com/en-us/download/details.aspx?id=47333
URL Rewrite – dodatek można pobrać pod następującym adresem: https://www.iis.net/downloads/microsoft/url-rewrite

Po pobraniu i instalacji Application Request Routing należy kolejno:

1. w ramach Menedżera Internetowych usług Internetowych kliknąć na ikonę „Application Request Routing Cache”

2. w ramach panelu „Akcje” po prawej stronie ekranu nacisnąć link „Otwórz funkcje”.

Wybór ikony „Application Request Routing Cache” i przycisku „Otwórz funkcje”

3. zaznaczyć parametr „Enable proxy” w ramach zakładki „Application Request Routing” i potwierdzić zmianę przyciskiem „Zastosuj”.

Włączanie proxy w ustawieniach „Application Request Routing” na serwerze IIS

Aby skonfigurować aplikację kliencką (WEB), administrator powinien:

1. W ramach katalogu zawierającego aplikację web (nową aplikację webową) otworzyć do edycji plik index.html i uzupełnić nazwę aplikacji web (nowej aplikacji webowej) w ramach klucza „base href”, przykładowo:

a następnie zapisać wprowadzone zmiany;

Uzupełnianie klucza base href w pliku index.html

2. W ramach katalogu zawierającego aplikację web (nową aplikację webową) otworzyć do edycji plik web.config i uzupełnić:

- W ramach „WorkflowApi” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja serwerowa (starsza aplikacja web) i zamiast DocumentWorkflow.Api – nazwę aplikacji serwerowej (starszej aplikacji web)
- W ramach „WorkflowDashboards” (dodane w wersji 2024.1.1) zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja serwerowa (starsza aplikacja web) i zamiast DocumentWorkflow.Api – nazwę aplikacji serwerowej (starszej aplikacji web)
- W ramach „WorkflowWebsockets” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja serwerowa (starsza aplikacja web) i zamiast DocumentWorkflow.Api – nazwę aplikacji serwerowej (starszej aplikacji web)

a następnie zapisać wprowadzone zmiany.

Przyklad

Uzupełnianie pliku web.config w aplikacji web Comarch BPM (dawniej DMS)

Jeśli aplikacja ma współpracować z Comarch BPM (dawniej DMS) Repozytorium, wówczas należy również uzupełnić:

- W ramach „RepositoryApi” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja Repozytorium i zamiast DocumentManager.WebApi – nazwę aplikacji Repozytorium
- W ramach „RepositoryWebsockets” zamiast [applicationHost] nazwę serwera, na którym znajduje się aplikacja Repozytorium i zamiast DocumentManager.WebApi – nazwę aplikacji Repozytorium

a następnie zapisać wprowadzone zmiany.

Przyklad

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu

Definiowanie punktu konfiguracyjnego

Spis treści artykułu

Dodawanie nowego punktu i zakładka „Tryb współpracy”
Zakładka „Ogólne”
Zakładka „Kontrolki”
Przesyłanie skanów z kontrolki załącznik

Dodawanie nowego punktu i zakładka „Tryb współpracy”

Aby utworzyć punkt konfiguracyjny typu ‘Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM)’ należy w oknie „Automatyczne generowanie dokumentów” dodać nowy punkt konfiguracyjny za pomocą ikony . Na liście trybów pracy punktu jako druga dostępna jest opcja „Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM)”.

Punkt konfiguracyjny typu Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM), zakładka Tryb współpracy

Zakładka „Ogólne”

Na zakładce „Ogólne” należy w rubryce:

Nazwa punktu – określić nazwę pod jaką punkt konfiguracyjny będzie widoczny na liście punktów
Typ obiegu – wskazać typ obiegu, w ramach którego można będzie przekazywać skany do usługi Comarch OCR z poziomu kontrolki typu załącznik na szczegółach dokumentu
Kontrolka – wybrać kontrolkę typu załącznik z danego typu obiegu, z której dokumenty będą przekazywane do Comarch OCR
Typ rejestru VAT – określić typ rejestru VAT (zakupu/sprzedaży), pod kątem którego dokumenty będą przetwarzane przez Comarch OCR
Domyślna forma płatności – opcjonalnie wpisać domyślną formę płatności, która zostanie określona dla dokumentu przeprocesowanego w usłudze Comarch OCR, jeśli na przesłanym dokumencie nie rozpoznano formy płatności.
Kraj dokumentu – wskazać kraj dokumentu: Polskę, Niemcy lub Francję
Rozpoznawanie kodów kreskowych – wskazać czy funkcjonalność rozpoznawania kodów kreskowych ma być włączona. Parametr przyjmuje wartości:

Wyłączone – kody kreskowe nie będą rozpoznawane w usłudze Comarch OCR

Włączone – kody kreskowe będą rozpoznawane – jeżeli zaznaczono tę opcję, wówczas poniżej dostępny jest parametr „Kod kreskowy wskazuje pierwszą stronę dokumentu”- zaznaczenie parametru sprawi, że na podstawie rozpoznanych kodów kreskowych nastąpi łączenie stron dokumentów. Łączenie stron dokumentu realizowane jest w ten sposób, że wszystkie strony, które wystąpiły od strony z kodem kreskowym do strony poprzedzającej stronę z kolejnym kodem kreskowym są jednym dokumentem.

Uwaga
Można wskazać ten sam typu obiegu dla dwóch punktów konfiguracyjnych – Współpraca z Comarch OCR oraz Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM). W takiej konfiguracji możliwe jest również wskazanie tej samej kontrolki typu załącznik, do której załączany będzie skan dokumentu przeprocesowanego w usłudze Comarch OCR.

Punkt konfiguracyjny typu Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM), zakładka Ogólne

Zakładka „Kontrolki”

Na zakładce „Kontrolki” za pomocą zapytań SQL należy wskazać wartości, które będą wyświetlane w poszczególnych kontrolkach po przeprocesowaniu dokumentu w usłudze Comarch OCR. Przykłady zapytań SQL zostały przedstawione w artykule Przykłady zapytań SQL w zakładce Kontrolki.

Uwaga

W przypadku tego rodzaju współpracy z Comarch OCR wartości w kontrolce typu załącznik nie są definiowane zapytaniem SQL, ale bezpośrednio w konfiguracji punktu ACD, w zakładce „Ogólne” (rubryka „Kontrolka”).

Widok zakładki Automatyczne generowanie dokumentów po skonfigurowaniu punktu ACD

Przesyłanie skanów z kontrolki załącznik

Po skonfigurowaniu punktu ACD należy przejść do wybranego w punkcie typu obiegu, dodać nowy dokument, a następnie dodać plik za pomocą kontrolki typu załącznik – wówczas skan jest automatycznie przesyłany do usługi Comarch OCR i po chwili kontrolki zostają wypełnione informacjami rozpoznanymi przez Comarch OCR, zgodnie z zapytaniami SQL zapisanymi dla poszczególnych kontrolek w dedykowanym punkcie ACD.

Kontrolki na nowym dokumencie, wypełnione danymi odczytanymi przez Comarch OCR

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu

Comarch BPM – Tworzenie szablonów wydruków w sPrint osadzonym w Comarch BPM na przykładzie szablonu wydruku „Pocztowa książka nadawcza“

<a href=”https://pomoc.comarch.pl/dms/wp-content/uploads/2025/08/Comarch-BPM-Tworzenie-szablonow-wydrukow-w-sPrint-osadzonym-w-Comarch-BPM-na-przykladzie-szablonu-wydruku-Pocztowa-ksiazka-nadawcza.pdf”>Comarch BPM – Tworzenie szablonów wydruków w sPrint osadzonym w Comarch BPM na przykładzie szablonu wydruku „Pocztowa książka nadawcza“</a>

Czy wiesz, że można znacznie uprościć proces przekazywania dokumentu do kolejnego etapu obiegu?

Zamiast ręcznie wybierać uprawnienia z rozbudowanej listy „Uprawnienia do następnego etapu”, można wskazać pracownika bezpośrednio w kontrolce na formularzu dokumentu — z zawężonej i precyzyjnie dobranej listy dostępnych osób.

W momencie kliknięcia przycisku „Przejdź do następnego etapu”,

osoba wskazana w kontrolce typu Lista na karcie obiegu automatycznie zostanie przypisana do uprawnień na kolejny etap. Dzięki temu dokument trafi do właściwego pracownika, który został wybrany, bez konieczności dodatkowej, ręcznej konfiguracji uprawnień.

Warunkiem koniecznym działania tego mechanizmu jest przypisanie w definicji typu obiegu do etapu, do którego automatycznie przypisujemy wskazanego w kontrolce typu Lista pracownika, użytkownika technicznego (można utworzyć pracownika „Techniczny” bez uprawnień administratora).

W przypadku, gdy nie zostanie wybrana osoba w kontrolce typu Lista, w momencie przekazania dokumentu do następnego etapu pojawi się komunikat:

„Nie wybrano dodatkowych uprawnień w kontrolce Pracownik. Wybierz pracownika z Listy, aby można było przekazać dokument do następnego etapu.”

Komunikat wyświetlany, gdy nie zostanie wybrana osoba w kontrolce typu Lista, w momencie przekazania dokumentu do następnego etapu

Konfiguracja przykładu:

1. W ramach typu obiegu należy dodać następujące kontrolki:

kontrolkę typu Lista „Dział” (identyfikator: Dzial) – wypełnianą danymi z bazy danych na podstawie następującego zapytania SQL:

 select dcd_id, DCD_Name1 from do.DF_ConfOSDictionary where dcd_type=1 and DCD_Archival=0

Konfiguracja kontrolki typu Lista „Dział”

kontrolkę typu Lista „Pracownik” (identyfikator: Pracownik) – w ramach pola „Kontrolki powiązane” należy wybrać kontrolkę „Dział (Dzial)”; kontrolka „Pracownik” natomiast powinna zostać wypełniona danymi z bazy danych na podstawie następującego zapytania SQL:

 select t2.dcd_id, t2.dcd_Name1 from do.DF_ConfOSTree as t1
inner join do.DF_ConfOSDictionary as t2 on t1.DCO_DCDId=t2.DCD_ID
inner join do.DF_ConfOSTree as t3 on t1.DCO_DCOId=t3.DCO_ID 
left join do.DF_ConfOSDictionary as t4 on t4.DCD_ID=t3.DCO_DCDId
where t1.DCO_Archival=0 and t2.dcd_type=2 and t4.DCD_Name1=@Dzial_Text@

Definicja kontrolki typu Lista „Pracownik”

2. Następnie należy przypisać użytkownika Technicznego na definicji typu obiegu do etapu, do którego ma zostać przekazany dokument – w przykładzie jest to etap „Akceptacja”

Należy zapisać wprowadzone zmiany.

3. Na bazie BPM należy zmodyfikować procedurę On.DocumentPropagation.

Uwaga

Należy pamiętać, aby w ramach przykładu procedury On.DocumentPropagation zmienić Id typu obiegu dla DFH_Id na id typu obiegu, którego ma dotyczyć.

Jeżeli:

zmieniono identyfikator kontrolki „Pracownik”, wówczas należy wpisać aktualny identyfikator dla DKO_Name
zmieniono nazwę etapu na inną niż „Akceptacja”, wówczas należy wprowadzić nazwę etapu dla DDS_Name

Przykład modyfikacji procedury On.DocumentPropagation:

ALTER PROCEDURE [do].[OnDocumentPropagation]

@WorkflowId as int = NULL, -- DSH_ID z tabeli DF_ConfDSHead

@StageId as int = NULL,-- DDS_ID z tabeli DF_ConfDSDictionary

@DocumentId as int = NULL, -- DWD_ID z tabeli DF_Work

@PropagatedById as int = NULL, -- DCD_ID z tabeli DF_ConfOSDictionary

@DocumentOwnerId as int = NULL, -- DWD_DCDOwnerId z tabeli DF_Work

@IsAutomaticPropagation as bit = NULL

AS

------------------------Początek-----------------------------

BEGIN

DECLARE @ErrorMessage NVARCHAR(MAX);

BEGIN TRY

/* Warunek przekazania dokumentu w określonym typie obiegu i etapie */

IF EXISTS (

SELECT 1

FROM do.RO_StageActive

WHERE DFH_Id = 6 /* Id typu obiegu Dynamiczne uprawnienia Lista */

AND DDS_Name = 'Akceptacja' /* Nazwa etapu, do którego przekazujemy dokument */

AND DWD_ID = @DocumentId

)

BEGIN

/* Sprawdzenie, czy nie zostały wybrane uprawnienia w kontrolce Pracownik */

IF EXISTS (

SELECT 1

FROM do.DF_ConfCFCardDokFlow c

JOIN do.df_workcf w ON c.DKO_ID = w.DWC_DKOId

WHERE c.DKO_Name = 'Pracownik' -- identyfikator kontrolki lista

AND w.DWC_DWDId = @DocumentId

AND w.DWC_ValueListPos IS NULL

)

BEGIN

/* Rzucenie komunikatu, jeśli nie wybrano uprawnień w kontrolce typu Lista o nazwie Pracownik */

SET @ErrorMessage = 'UWAGA!!! ' + CHAR(13) + CHAR(10) +

'Nie wybrano dodatkowych uprawnień w kontrolce Pracownik.' + CHAR(13) + CHAR(10) +

'Wybierz pracownika z Listy, aby można było przekazać dokument do następnego etapu.';

THROW 50001, @ErrorMessage, 1;

END

/* Dodanie dynamicznych uprawnień */

INSERT INTO do.DF_WorkDSAccess ([WSA_DWSId], [WSA_DCDId], [WSA_DCPId], [WSA_TypeAccess], [WSA_Archival])

SELECT DISTINCT

s.DWS_ID,

w.DWC_ValueListPos,

NULL,

0,

0

FROM do.RO_ControlsValue c

JOIN do.DF_WorkCF w ON w.DWC_DKOId = c.DKO_ID

JOIN do.RO_StageActive s ON s.DWD_ID = w.DWC_DWDId

WHERE c.DKO_Name = 'Pracownik' -- identyfikator kontrolki lista

AND w.DWC_DWDId = @DocumentId;

END

END TRY

BEGIN CATCH

/* Obsługa błędów */

DECLARE @CatchErrorMessage NVARCHAR(MAX) = ERROR_MESSAGE();

DECLARE @ErrorSeverity INT = ERROR_SEVERITY();

DECLARE @ErrorState INT = ERROR_STATE();

RAISERROR (@CatchErrorMessage, @ErrorSeverity, @ErrorState);

END CATCH

END

4. Nastepnie należy utworzyć nowy dokument i wybrać pracownika w kontrolce typu Lista o nazwie Pracownik (identyfikator: Pracownik)

Uwaga

Pomimo przypisania użytkownika Technicznego dokumentu nie można przekazać (pojawia się stosowny komunikat), dopóki nie zostanie wybrany pracownik w kontrolce typu Lista o nazwie Pracownik.

Wyświetlanie komunikatu przy próbie rzekazania dokumentu do kolejnego etapu, gdy nie wybrano pracownika w kontrolce typu Lista

5. Po wybraniu pracownika dokument zostaje przekazany do tej osoby.

Widok dokumentu po przekazaniu do nastepnego etapu do wybranego pracownika

Sprawdź Szkolenia Comarch BPM!

Zawartość pakietu

W ramach pakietu Generator FVZ (Rejestr VAT + opis analityczny), pobranego z zakładki „Przykłady”, z sekcji „ERP Optima” na Indywidualnych Stronach Partnerów (zob. Indywidualne Strony Partnerów | ERP Optima (comarch.pl)) znajdują się następujące katalogi:

bin – katalog, w którym znajdują się pliki umożliwiające generowanie dokumentów ERP Optima do rejestru VAT wraz z opisem analitycznym w przypadku pracy na aplikacji desktop.
Pliki z tego katalogu należy skopiować do folderu, w którym zainstalowana jest aplikacja desktop
exe – w katalogu znajdują się pliki umożliwiające generowanie dokumentów ERP Optima do rejestru VAT wraz z opisem analitycznym zarówno z poziomu aplikacji webowej oraz aplikacji desktop. Pliki należy skopiować do folderu bin\exe aplikacji serwerowej(dawna web)
Typ obiegu – przykład typu obiegu do zaimportowania w Comarch BPM (dawniej DMS)
Zrodla – źródła aplikacji OptimaVatRegisterDimension.exe oraz OptimaVatRegisterGenerator.exe – po przekompilowaniu źródeł do katalogu wynikowego należy skopiować pliki z katalogu Binaries

Zawartość pakietu „Generator FVZ (Rejestr VAT + opis analityczny)”

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu