/ By Mateusz Łukasiński / Baza wiedzy • Comarch BPM/ • • • • • • • / 0 Comments

BPM zawiesza się przy generowaniu dokumentu do Optimy – co sprawdzić po aktualizacji?

Po aktualizacji Comarch DMS/BPM wszystko powinno działać szybciej i stabilniej, ale czasem dzieje się odwrotnie. Użytkownik generuje dokument do Comarch ERP Optima, system zaczyna mielić, zawiesza sesje BPM, a część osób widzi komunikat „Skontaktuj się z administratorem systemu”. Problem nie dotyczy jednego stanowiska, tylko wielu użytkowników naraz.

W takiej sytuacji nie warto zaczynać od ręcznego poprawiania dokumentów. Jeżeli generowanie do Optimy nagle zwolniło po aktualizacji, najpierw trzeba sprawdzić warstwę techniczną: generator dokumentów, sposób działania BPM, logowanie, IIS oraz zgodność wersji.

Sprawdź pliki generatora dokumentów do Optimy

Najczęstsza przyczyna po aktualizacji to niezgodne lub nieaktualne pliki generatora dokumentów do Optimy. Generator powinien być dobrany dokładnie pod wersję Comarch ERP Optima, z którą pracuje środowisko.

Pobierz z portalu Comarch generator C# zgodny z używaną wersją Optimy, a następnie podmień pliki generatora w katalogu BPM. Miejsce podmiany zależy od konfiguracji: w części środowisk dotyczy to wersji desktopowej, w innych aplikacji działającej na IIS.

Jeżeli BPM korzysta z niewłaściwych plików generatora, objawy mogą wyglądać jak zawieszenie systemu, bardzo długie generowanie dokumentu albo rozłączanie sesji użytkowników.

Sprawdź, czy BPM działa przez IIS czy lokalny plik EXE

Sposób diagnozy zależy od tego, jak uruchamiany jest mechanizm generowania dokumentów. Inaczej wygląda środowisko, w którym BPM działa przez serwer IIS, a inaczej instalacja, gdzie plik EXE działa lokalnie na każdym stanowisku.

Jeżeli środowisko działa przez IIS, po podmianie plików generatora warto wykonać restart serwera IIS. Jeżeli generator działa lokalnie, trzeba upewnić się, że odpowiednie pliki zostały podmienione na właściwych stanowiskach.

Dodaj ścieżkę do Optimy w zmiennej PATH

Po aktualizacji warto sprawdzić również zmienną środowiskową PATH. Jeżeli generator ma korzystać z komponentów Optimy, ścieżka do instalacji Optimy powinna być poprawnie dostępna w środowisku systemowym.

Brak właściwej ścieżki może powodować, że generator nie znajduje wymaganych bibliotek albo wykonuje operacje znacznie wolniej. Po zmianach w PATH warto zrestartować usługę, IIS lub serwer, zależnie od konfiguracji.

Przełącz logowanie z aplikacji na plik tekstowy NLog

Po aktualizacji Comarch BPM może ustawić domyślnie logowanie do aplikacji. Według praktyki wdrożeniowej potrafi to znacząco wydłużyć generowanie dokumentów do Optimy.

W wielu przypadkach przełączenie logowania z aplikacji na plik tekstowy NLog skraca czas generowania dokumentu do kilku sekund.

To ważny trop, gdy dokument ostatecznie się generuje, ale trwa to bardzo długo i blokuje pracę użytkowników. Wtedy problemem nie musi być sam dokument, tylko sposób logowania i obsługi procesu po stronie BPM.

Zrestartuj IIS i sprawdź efekt na szybko

Jeżeli BPM działa na IIS, szybkim testem jest restart serwera IIS i ponowne sprawdzenie generowania dokumentu. Nie rozwiązuje to przyczyny docelowo, ale pozwala ocenić, czy problem dotyczy zawieszonego procesu, usług lub zasobów serwera.

Jeżeli po restarcie następuje poprawa, warto iść dalej w stronę diagnostyki IIS, logów generatora, obciążenia serwera i konfiguracji środowiska.

Zaktualizuj BPM do wersji 2026.1.1 z aktualnym pakietem poprawek

Jeżeli środowisko pracuje na wersji 2026.0.1, warto rozważyć aktualizację BPM do wersji 2026.1.1 z aktualnym pakietem poprawek. W odpowiedziach eksperckich pojawia się wskazanie, że problemy z generowaniem dokumentów były poprawiane w nowszych wersjach.

Aktualizacja nie powinna być robiona „w ciemno” na produkcji. Najpierw dobrze jest sprawdzić pliki generatora, logowanie, IIS i logi, a następnie zaplanować aktualizację w kontrolowany sposób.

Perspektywa ELTE-S: BPM i Optima muszą działać jako jeden proces, nie dwa osobne światy

Generowanie dokumentu z BPM do Optimy to nie tylko kliknięcie w aplikacji. Pod spodem pracują wersje systemów, pliki generatora, środowisko IIS lub lokalne EXE, biblioteki Optimy, logowanie i uprawnienia serwerowe. Po aktualizacji jeden niezgodny element potrafi zatrzymać pracę wielu użytkowników.

Dlatego przy takich awariach warto diagnozować proces technicznie: zgodność generatora z wersją Optimy, sposób uruchomienia BPM, konfigurację PATH, ustawienia NLog, logi i wersję BPM. Dopiero wtedy można odróżnić jednorazowe zawieszenie od problemu konfiguracyjnego, który będzie wracał przy każdym generowaniu dokumentu.

Porozmawiajmy o usprawnieniach.

Skontaktuj się z nami

/ By Mateusz Łukasiński / Baza wiedzy • Comarch BPM/ • • • • • • • • / 0 Comments

“Wystąpiły błędy w zapisie” przy pobieraniu faktur z KSeF przez BPM – jak naprawić konfigurację klucza licencyjnego

Masz wykupiony i aktywny pakiet KSeF, Optima poprawnie rozlicza go przy pobieraniu faktur zakupu, ale gdy próbujesz pobrać faktury przez BPM, proces pokazuje liczbę dokumentów do pobrania i natychmiast się przerywa z komunikatem “Wystąpiły błędy w zapisie”. To jeden z tych błędów, który wygląda na problem z KSeF, a w rzeczywistości jest problemem konfiguracji serwera BPM – dokładnie tam, gdzie BPM szuka informacji o Twoim kluczu licencyjnym.

Dlaczego BPM nie widzi Twojego pakietu KSeF, mimo że Optima go widzi

Comarch ERP BPM i Comarch ERP Optima to dwa różne procesy, które mogą korzystać z różnych kluczy wirtualnych. Jeli pakiet KSeF został aktywowany na osobnym kluczu wirtualnym niż ten, z którego standardowo korzysta moduł DMS w BPM, to serwer aplikacyjny BPM (IIS) nie ma skąd wiedzieć, że ma po ten klucz sięgnąć – i próba zapisu dokumentów pobranych z KSeF kończy się błędem. Kluczowy jest tu plik Web.config w katalogu BPMBPMSRVAPP na serwerze, w którym znajdują się dwa wpisy: LicenceKeyServerDMS (klucz standardowo używany przez moduł DMS) i opcjonalny LicenceKeyServerKSeF (dedykowany klucz używany wyłącznie przez integrację KSeF – jeśli zdefiniowany, BPM użyje go zamiast LicenceKeyServerDMS).

Krok po kroku – jak naprawić konfigurację

Krok 1 – sprawdź, czy pakiet KSeF jest na innym kluczu wirtualnym niż BPM/DMS

W Menadżerze Kluczy sprawdź, na którym kluczu wirtualnym siedzi Twoja licencja BPM/DMS, a na którym pakiet KSeF. Jeli to dwa różne numery klucza – to jest źródło problemu i musisz wykonać kroki poniżej. Jeli to ten sam klucz, problem leży gdzie indziej (uprawnienia użytkownika w BPM, wersja BPM – patrz Krok 4).

<screen>

Krok 2 – otwórz Web.config w katalogu BPMBPMSRVAPP na serwerze

Na serwerze aplikacyjnym BPM przejdź do katalogu instalacyjnego BPM, podkatalog BPMSRVAPP, i otwórz plik Web.config w edytorze tekstu (np. Notepad++, z uprawnieniami administratora). Znajdź sekcję z wpisami LicenceKeyServerDMS i LicenceKeyServerKSeF.

<screen>

Krok 3 – wpisz numer klucza KSeF w polu LicenceKeyServerKSeF

W wartości wpisu LicenceKeyServerKSeF wpisz sam numer klucza, na którym masz aktywowany pakiet KSeF – nie format “serwer::numer_klucza” (mimo że komentarz w pliku to sugeruje, w praktyce ten format często nie działa). Zapisz plik, zrestartuj usługę IIS/BPM na serwerze, żeby zmiana została wczytana, i spróbuj ponownie pobrać faktury z KSeF przez BPM.

<screen>

Krok 4 – sprawdź wersję BPM i zaktualizuj, jeli trzeba

Integracja KSeF w BPM jest wspierana od wersji 2026.1.1 wzwyż. Jeli masz starszą wersję (np. 2026.0.0), w Web.config może nawet nie być wpisu LicenceKeyServerKSeF – w takim przypadku najpierw zaktualizuj BPM do wersji wspieranej i dołącz najnowszy dostępny QuickFix, a następnie wróć do Kroku 2 i 3.

<screen>

Krok 5 – zweryfikuj uprawnienia użytkownika do zapisu dokumentów w Optimie

Jeli po poprawieniu klucza błąd nadal się powtarza, sprawdź, czy użytkownik, na którym działa proces BPM, ma odpowiednie uprawnienia do dodawania dokumentów w Optimie (moduy Handel/Księgowość, w zależności gdzie trafiają faktury z KSeF). Warto też porównać konfigurację KSeF/firmy i ścieżek w BPM z inną bazą/firmą, gdzie proces działa poprawnie, oraz przetestować na jednym, prostym szablonie procesu.

<screen>

Krok 6 – włącz logowanie w BPM/DMS, jeli błąd nadal się powtarza

Sam komunikat “Wystąpiły błędy w zapisie” jest zbyt ogólny, aby jednoznacznie zdiagnozować przyczynę, jeli powyższe kroki nie pomogą. Włącz szczegółowe logowanie w BPM/DMS, sprawdź, który krok procesu faktycznie zwraca błąd, i przekaż logi partnerowi do analizy.

<screen>

Perspektywa ELTE-S

Ten błąd jest dobrym przykładem tego, dlaczego przy wdrożeniach z wieloma modułami (BPM + KSeF + DMS) warto od razu na etapie aktywacji pakietu KSeF zweryfikować, na którym kluczu wirtualnym siedzi każdy moduł. Zaoszczędzi to godzin diagnostyki po fakcie, kiedy pakiet jest już opłacony, a integracja nie działa. Rekomendujemy też, aby przy każdej aktualizacji BPM sprawdzać zawartość Web.config po update – niektóre instalatory nadpisują ten plik i mogą zresetować ręcznie wprowadzone wpisy takie jak LicenceKeyServerKSeF.

Porozmawiajmy o poprawnej konfiguracji integracji BPM i KSeF w Twojej firmie.

Skontaktuj się z nami

/ By Wiktor Chruściel / Baza wiedzy • Comarch BPM/ • • • • • • • • • • • • • • / 0 Comments

Ewolucja od DMS do BPM – dlaczego sama “cyfryzacja” to za mało?

Jeszcze kilka lat temu, kiedy przedsiębiorcy myśleli o cyfryzacji dokumentów, mieli przed oczami prosty obraz: skaner, dysk w chmurze i folder z plikami PDF. Nazywano to dumnie „elektronicznym archiwum”. Był to krok w dobrą stronę, ale w rzeczywistości rozwiązywał tylko jeden problem – problem fizycznego miejsca na segregatory. Nie rozwiązywał jednak problemu najważniejszego: chaosu komunikacyjnego i braku kontroli nad tym, co z tym dokumentem dzieje się dalej.

Czytaj dalej
/ By Wiktor Chruściel / Baza wiedzy • Comarch BPM/ • • • • • • • • • • • • • • / 0 Comments

Kalendarze zasobów w Comarch BPM – zarządzanie rezerwacjami w firmie

System Comarch BPM oferuje zaawansowane możliwości zarządzania rezerwacjami zasobów przedsiębiorstwa poprzez systemowe kalendarze. Funkcjonalność ta jest dostępna na wszystkich platformach: desktop, web oraz mobile, a pełna integracja pomiędzy tymi środowiskami umożliwia sprawne zarządzanie rezerwacjami z dowolnego miejsca i urządzenia.

Czytaj dalej
/ By Wiktor Chruściel / Baza wiedzy • Comarch BPM/ • • • • • • • • • • • • • • / 0 Comments

Podpis mobilny, skanowanie kodów kreskowych i inne nowości w aplikacjach mobilnych Comarch BPM

W systemie Comarch BPM wprowadzono szereg nowych funkcji dedykowanych aplikacjom mobilnym, które znacząco rozszerzają możliwości systemu i usprawniają pracę z dokumentami w terenie. Nowe rozwiązania pozwalają na bardziej efektywne zarządzanie obiegiem dokumentów oraz zwiększają bezpieczeństwo i wiarygodność procesów biznesowych.

Czytaj dalej