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)”
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?
Konfiguracja kontrolki typu Załącznik w ramach integracji modułu Repozytorium z modułem Workflow
Uwaga
W aktualnej wersji Comarch BPM (dawniej DMS) w ramach typów obiegów, dla których został włączony zapis załączników do Repozytorium, nie są dostępne funkcjonalności:
przekazanie czasowe
przekazanie z listy
W następnych wersjach Comarch BPM (dawniej DMS) będą prowadzone prace nad udostępnieniem tych funkcjonalności
Integracja modułu Repozytorium z modułem Workflow umożliwia:
od wersji 2023.1.0 dodawanie pliku z modułu Repozytorium do kontrolki typu załącznik w module Workflow (zob. Załącznik dodany z modułu Repozytorium); od wersji 2024.2.0 także z poziomu nowej aplikacji web Comarch BPM (dawniej DMS);
od wersji 2024.0.0 przejście z poziomu panelu szczegółów dokumentu w module Comarch BPM Repozytorium do powiązanego z nim dokumentu w aplikacji WEB Comarch BPM (dawniej DMS) ;
od wersji 2024.2.0 podgląd w Repozytorium dokumentu dodanego z modułu Repozytorium do kontrolki typu Załącznik w nowej aplikacji web Comarch BPM (dawniej DMS)
We właściwościach kontrolki typu załącznik został wprowadzony podział na dwie zakładki: ’Ogólne’ i ’Archiwa’.
Pola w zakładce 'Ogólne’ kontrolki typu załącznik
W zakładce ’Archiwa’:
jeżeli współpraca z modułem Repozytorium jest wyłączona, znajduje się checkbox ’Manager dokumentów’.
jeśli współpraca z Repozytorium jest włączona, w tym miejscu pojawia się checkbox ’Współpraca z Repozytorium’ (od wersji 2023.1.0; wcześniej 'Zapisz do Repozytorium’). Po jego zaznaczeniu:
załączniki, które są dodawane do dokumentu, przesyłane są do Repozytorium, tam też są przechowywane;
od wersji 2023.1.0. dostępna jest funkcjonalność dodawania plików z Repozytorium do kontrolki typu załącznik w module Workflow, od wersji 2024.2.0 dostępna również w nowej aplikacji web Comarch BPM (dawniej DMS) (zob. Załącznik dodany z modułu Repozytorium).
Opcja „Współpraca z Repozytorium” w zakładce „Archiwa” we właściwościach kontrolki typu załącznik (przed zaznaczeniem checkboxa)
Uwaga
W przypadku współpracy z Comarch ERP XL jeżeli na zakładce „Archiwa” na definicji kontrolki typu Załącznik zaznaczono parametr „Współpraca z Repozytorium”, wówczas załącznik nie zostanie przeniesiony do bazy Comarch ERP XL pomimo odpowiednich ustawień w pliku web.config.
Aby funkcjonalność przesyłania plików z kontrolki do Repozytorium lub dodawania plików z Repozytorium do kontrolki była możliwa, należy kolejno:
1. w aplikacji stacjonarnej BPM (dawniej DMS) wybrać zakładkę ’Archiwa’
2.zaznaczyć opcję ’Współpraca z Repozytorium’
3.określić warunki zapisu, takie jak:
przy wyborze opcji 'Lokalizacja’: lokalizacja w Repozytorium, do której domyślnie powinny być przesyłane pliki; do wyboru spomiędzy wszystkich folderów, które zostały utworzone w module Repozytorium (oprócz katalogu głównego), ułożonych według struktury drzewa katalogów.
Lokalizacja – struktura drzewa folderów w module Repozytorium
Wybór określonej lokalizacji ( w tym przypadku Folderu 1) w module Repozytorium z poziomu właściwości kontrolki typu załącznik w aplikacji stacjonarnej
zaznaczenie/odznaczenie parametru „Pozwalaj na wybór lokalizacji podczas dodawania załącznika” – jest to parametr dodany w wersji 2025.2.0; jeśli parametr jest 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 (zob. Wybór lokalizacji zapisu załącznika w Comarch BPM Repozytorium przez operatora dodającego załącznik w aplikacji desktop); jeśli parametr jest odznaczony, wówczas załącznik zostanie dodany do domyślnej lokalizacji, którą wybrano w polu „Lokalizacja” na definicji kontrolki;
w ramach pól: ‘Podczas zapisu załącznika w Repozytorium stosuj’ i ’Podczas pracy z załącznikiem z Repozytorium stosuj’”, dostępnych od wersji 2024.2.0 w wyniku zastąpienia pola ‘Zastosuj login operatora Repozytorium’), rodzaj uprawnień do zapisu i odczytu danych w module Workflow we współpracy z modułem Repozytorium
W każdym z pól dostępne są dwie opcje:
Login własny operatora – zapis załącznika/praca z załącznikiem odbywa się w imieniu operatora BPM (dawniej DMS), który dodał załącznik za pomocą kontrolki/pracuje z załącznikiem.
Login operatora z konfiguracji – zapis załącznika/praca z załącznikiem odbywa się w imieniu operatora domyślnego, który został wybrany w zakładce „Ustawienia” w sekcji ‘Przechowywanie plików’ po kliknięciu w pole „Kontrolki typu Załącznik” i w przycisk „Ustaw”
Operator, w zależności od tego, jakie opcje wybrał w tych dwóch polach, może korzystać:
Z uprawnień własnych zarówno podczas zapisu załącznika, jak i podczas dalszej pracy z załącznikiem (mapowania wartości, odczytu załącznika)– jeśli wybrano następujące ustawienia:
Z uprawnień operatora z konfiguracji zarówno podczas zapisu załącznika, jak i podczas dalszej pracy z załącznikiem (mapowania wartości, odczytu załącznika)– jeśli wybrano ustawienie „Login operatora z konfiguracji” w polu „Podczas zapisu załącznika w Repozytorium stosuj” (w tym przypadku pole „Podczas pracy z załącznikiem z Repozytorium stosuj” ustawia się automatycznie i jest nieedytowalne):
Z uprawnień własnych podczas zapisu załącznika, zaś z uprawnień operatora z konfiguracji podczas dalszej pracy z załącznikiem (mapowania wartości, odczytu załącznika) – jeśli wybrano następujące ustawienia:
Przyklad
Przykład zapisywania załącznika w Repozytorium w imieniu operatora z konfiguracji:
W ‘Ustawieniach’ w polu ‘Login domyślnego operatora Repozytorium’ wybrano operatora ‘Anna Nowa’.
Ustawianie operatora domyślnego dla Repozytorium
We właściwościach kontrolki typu załącznik w polu „Podczas zapisu załącznika w Repozytorium stosuj” zaznaczono „Login operatora z konfiguracji”.
Wybór loginu operatora Repozytorium z konfiguracji
Następnie operator ‘Administrator’ dodał nowy dokument i dołączył do niego załącznik o nazwie ‘Faktura FZ_5_2021’.
Dokument z kontrolką typu załącznik zapisany przez Administratora (przy zaznaczonej opcji 'Login operatora z konfiguracji’)
Po wejściu do ‘Folderu 1’ w module Repozytorium w aplikacji webowej załącznik ‘Faktura FZ_5_2021’ jest widoczny jako utworzony przez operatora ‘Anna Nowa’ – choć w rzeczywistości utworzył go operator ‘Administrator’.
Dokument utworzony przez Administratora – jako autor dokumentu figuruje Anna Nowa, ponieważ została wybrana na operatora domyślnego w Repozytorium
Natomiast po zaznaczeniu opcji’Ustawienia typów dokumentów’ i kliknięciu przycisku‘Dodaj’ pod napisem ‘Typy’ powinny zostać wybrane takie właściwości jak:
1. typ dokumentów, który będzie przypisywany do przesłanych plików, a także określony typ domyślny (może zostać wybrany tylko jeden typ domyślny).
Lista typów dokumentów ułożona jest alfabetycznie.
Jeżeli typ dokumentu nie zostanie określony, załączniki będą wysyłane do Repozytorium jako przynależne do typu 'Nieokreślony’.
Możliwe jest wybranie wielu typów dokumentów, ale tylko jeden może zostać oznaczony jako typ domyślny. Lista dostępnych typów dokumentów zależy od typów dokumentu zdefiniowanych w module Repozytoriumw sekcji ‘Ustawienia’ w ramach okna ‘Zarządzanie aplikacją’ w zakładce ‘Typy dokumentów’.
Wskazówka
Od wersji 2023.1.0 wybór typów dokumentów w ramach kontrolki typu załącznik określa również, które typy dokumentów i przypisane do nich dokumenty będą dostępne w ramach okna „Dodaj załącznik” w ramach funkcjonalności dodawania załączników z Repozytorium do dokumentów w module Workflow (zob. Załącznik dodany z modułu Repozytorium ).
Widok przykładowych typów dokumentów zdefiniowanych w module Repozytorium
Wybór typu dokumentów we właściwościach kontrolki typu załącznik
Przyklad
Ustawianie typów dokumentów dostępnych w oknie „Dodaj załącznik” w ramach funkcjonalności dodawania załączników z modułu Repozytorium do modułu Workflow
Użytkownik w ustawieniach kontrolki typu załącznik „Załącznik”, w zakładce „Archiwa”, po zaznaczeniu parametru „Współpraca z Repozytorium” i wybraniu lokalizacji oraz loginu operatora:
usunął domyślny typ dokumentu „Nieokreślony”;
dodał dwa typy dokumentów dostępne w Repozytorium: „Faktura Zakupu” i „instrukcja”, wraz z atrybutami i zapisał zmiany
Typy dokumentów dodane w ustawieniach kontrolki typu załącznik „Załącznik”
po dodaniu nowego dokumentu i kliknięciu kontrolki „Załącznik”, a następnie wyborze opcji „Z Repozytorium” zostaje otwarte okno, w którym dostępne są jedynie dwa typy dokumentów, zgodnie z ustawieniami kontrolki – „Faktura Zakupu” i „instrukcja”.
Okno „Dodaj załącznik”, w którym dostępne są tylko dwa typy dokumentów – „Faktura Zakupu” i „instrukcja”
2.kontrolki BPM (dawniej DMS), które zostaną zmapowane do atrybutów oznaczonych jako wymagane (jeśli dla danego typu dokumentu będą one określone).
Jeżeli w ustawieniach modułu Repozytorium dla wybranego typu dokumentu nie zostały ustalone wymagane atrybuty, określenie atrybutów i kontrolek do mapowania nie jest konieczne.
Po wybraniu określonego atrybutu po kliknięciu w ’Ustaw’ wyświetla się lista kontrolek, spośród których można wybrać kontrolki dostępne w ramach tego atrybutu.
Uwaga
Funkcjonalność mapowania atrybutów z modułu Workflow do modułu Repozytorium nie jest dostępna, jeżeli w zakładce „Schemat obiegu” w sekcji „Przekazanie”, a następnie „Przekazanie czasowe” zaznaczono opcję „Przekazuj po zadanym czasie”.
Przyklad
Wybór atrybutów
Dla typu dokumentu ‘Faktura Zakupu’ w ustawieniach modułu Repozytorium wybrano jako wymagane atrybuty ‘Nazwa faktury’ i ‘data wystawienia’. Z tego powodu jeśli do kontrolki typu załącznik dodano typ dokumentu ‘Faktura zakupu’, konieczne jest ustawienie kontrolek dla tych atrybutów. Natomiast dla typu dokumentu ‘instrukcja’ nie wybrano w ustawieniach modułu Repozytorium wymaganych atrybutów. Wobec tego, jeśli do kontrolki typu załącznik dodano typ dokumentu ‘instrukcja’, to ustawienie atrybutów jest opcjonalne. W ramach atrybutu ‘data wystawienia’ możliwy jest wybór jednej z dwóch kontrolek typu Data i godzina znajdujących się na karcie obiegu.
Atrybuty, które nie są wymagane, można usuwać z listy we właściwościach kontrolki za pomocą ikony kosza . Dla atrybutów wymaganych taka opcja nie jest dostępna.
Definiowanie typu dokumentu ‘Faktura zakupu’ w module Repozytorium – atrybuty ustawione jako wymagane
Definiowanie typu dokumentu ‘instrukcja’ w module Repozytorium – atrybuty nie są ustawione jako wymagane
Dodawanie atrybutów i kontrolek we właściwościach kontrolki ‘Załącznik’
3.w ramach pola 'Etap mapowania’: 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. Wybór etapu mapowania dla każdego wybranego typu dokumentu jest konieczny dla zapisania obiegu.
Wybór etapu mapowania
Kontrolki, jakie są prezentowane, zależą od tego, jaki typ atrybutu został wybrany.
Dany atrybut może zostać dodany tylko raz w ramach jednego typu dokumentu.
Wyróżnione zostały następujące typy atrybutów, wraz z typami kontrolek, które mogą do nich należeć:
atrybut krótki tekst – kontrolka typu dokument elektroniczny, typu dokument ERP XL, typu dokumenty w obiegu, typu dokumenty związane, typu kontrahent, typu lista, typu tekst, typu towar, typu URL, typu właściciel
atrybut długi tekst – kontrolka typu dokument elektroniczny, typu dokument ERP XL, typu dokumenty w obiegu, typu dokumenty związane, typu kontrahent, typu lista, typu tekst, typu towar, typu URL, typu właściciel
atrybut liczba (z odznaczoną opcją wartość dziesiętna) – kontrolka typu liczba całkowita
atrybut liczba (z zaznaczoną opcją wartość dziesiętna) – kontrolka typu liczba całkowita, typu liczba rzeczywista, typu liczba stałoprzecinkowa
atrybut data – kontrolka typu data i godzina
atrybut wartość logiczna – kontrolka typu wartość logiczna
Jeżeli we właściwościach kontrolki wybrano dwa lub więcej typów dokumentów, to przy dodawaniu załącznika z dysku lub ze skanu na dokumencie pojawia się okienko z opcją wyboru typu, do którego operator chce przypisać dany załącznik.
Okno wyboru typu dokumentu po naciśnięciu kontrolki typu załącznik
Przypisanie typu dokumentu dla załącznika dodanego do Repozytorium z poziomu Workflow lub załącznika dodanego z Repozytorium do dokumentu w Workflow można później zmienić, klikającna ikonę obok nazwy załącznika, wybierając inny typ dokumentu i zapisując zmiany. Zmiana typu dokumentu będzie widoczna w module Repozytorium.
Zmiana typu dokumentu, do którego przypisano dany dokument
Jeżeli dokument w Repozytorium podlega regule retencji, wówczas po usunięciu pliku z kontrolki załącznik w module Workflow pozostaje on w dotychczasowym folderze w Repozytorium i nie zostaje usunięty, ale traci informacje o procesach powiązanych z dokumentem. Po usunięciu takiego załącznika w module Workflow i próbie zapisu pojawia się poniższy komunikat:
Automatyczna archiwizacja dokumentów z Workflow w Repozytorium
W wersji 2025.1.0 wprowadzono możliwość automatycznej zmiany statusu dokumentu na archiwalny w czasie mapowania danych na etapie, który wybrano z listy.
Archiwizacja jest dostępna na każdym wskazanym przez użytkownika etapie następującym po etapie mapowania. W tym celu na zakładce „Archiwa” dodano opcję „Automatyczna archiwizacja dokumentu w Repozytorium”, widoczną jedynie wówczas, jeśli operator zaznaczył parametr „Współpraca z Repozytorium” i ustawił typ/typy dokumentów.
Widok definicji kontrolki typu Załącznik z odznaczonym parametrem „Automatyczna archiwizacja dokumentu w Repozytorium”
Po zaznaczeniu parametru „Automatyczna archiwizacja dokumentu w Repozytorium” poniżej pojawi się pole „Etap archiwizacji”, w którym dostępna jest lista etapów, które zdefiniowano dla danego typu obiegu. Należy wybrać jeden z etapów. Na wybranym etapie nastąpi archiwizacja dokumentu w Repozytorium.
W przypadku, gdy operator zaznaczy parametr „Automatyczna archiwizacja dokumentu w Repozytorium”, a nie wybierze etapu w polu „Etap archiwizacji”, zapis typu obiegu nie będzie możliwy – wyświetli się komunikat informujący o nieokreśleniu etapu archiwizacji. Po kliknięciu w przycisk „OK” komunikat zostanie zamknięty, a operator pozostanie na definicji obiegu.
Jeżeli parametr „Automatyczna archiwizacja dokumentu w Repozytorium” nie zostanie zaznaczony, wówczas operator może zarchiwizować dokument z poziomu modułu Repozytorium, tak samo jak dotychczas.
Komunikat wyświetlany, gdy zaznaczono parametr „Automatyczna archiwizacja dokumentu w Repozytorium”, a nie wybrano etapu w polu „Etap archiwizacji”
Widok definicji kontrolki typu Załącznik z zaznaczonym parametrem „Automatyczna archiwizacja dokumentu w Repozytorium” i wybranym etapem archiwizacji
Uwaga
Mapowanie wartości nie dokona się na dokumencie zarchiwizowanym. Jeśli w polach „Etap mapowania” i „Etap archiwizacji” wskazano ten sam etap, wówczas w pierwszej kolejności nastąpi mapowanie wartości, a później archiwizacja dokumentu.
Kiedy w obiegu dokumentów w module Workflow dokument dotrze do etapu archiwizacji, wówczas dokument załącznika w module Repozytorium zostanie zarchiwizowany.
Jeśli dokument był już przedtem zarchiwizowany, wówczas jego stan nie ulega zmianie.
Jeżeli do dokumentu w module Workflow dodano załącznik, który w module Repozytorium ma status „Archiwalny”, wówczas mapowanie i archiwizacja nie zostaną przeprowadzone – stan pliku w Repozytorium pozostanie bez zmian.
Uwaga
Cofnięcie dokumentu do etapu archiwizacji w module Workflow nie spowoduje archiwizacji dokumentu w module Repozytorium.
Rozpoczynasz pracę z Comarch BPM (dawniej DMS) Repozytorium i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) Repozytorium i chcesz dowiedzieć się więcej?
Instalacja aplikacji stacjonarnej za pomocą instalatora
Od wersji Comarch DMS 2022.0 istnieje możliwość instalacji aplikacji stacjonarnej za pomocą instalatora.
Uwaga
Podczas instalacji za pomocą Instalatora (Instalator Comarch BPM.exe) potrzebny jest dostęp do Internetu.
Uwaga
Instalator aplikacji desktop nie jest dostępny w wersji 2022.0.2
Uwaga
Od wersji 2023.0.0 w ramach pakietu instalacyjnego nie jest dostępny instalator aplikacji web dla Comarch BPM (dawniej DMS) we współpracy z Comarch ERP Altum.
Od wersji 2023.0.0 przejście do instalatora Comarch BPM (dawniej DMS) Desktop następuje z poziomu nowego instalatora Comarch BPM (dawniej DMS) (zob. Nowy instalator Comarch DMS Web). W tym celu należy ponownie uruchomić instalator Comarch BPM (dawniej DMS) , przejść początkowe kroki analogicznie do instalacji aplikacji web i w oknie „Wybór aplikacji” wybrać opcję Instalacja aplikacji Comarch BPM Desktop, a następnie przycisk [Dalej].
Okno początkowe instalatora aplikacji web Comarch BPM – wybór języka instalacji
Wybór instalacji aplikacji desktop Comarch BPM (dawniej DMS) za pomocą instalatora
Po przejściu do kolejnego okna należy nacisnąć przycisk [Instaluj] – wówczas zostanie otwarte okno instalatora aplikacji Comarch BPM (dawniej DMS) Desktop, w którym należy postępować zgodnie z dalszą częścią instrukcji.
Okno instalatora Comarch DMS, z którego można przejść do instalacji aplikacji desktop Comarch BPM (dawniej DMS)
Instalator aplikacji desktopowej umożliwia:
pierwszą instalację
ponowną instalację
Po uruchomieniu instalatora zostaje wyświetlone okno początkowe, gdzie należy nacisnąć przycisk „Dalej”
Okno początkowe instalatora aplikacji desktopowej
W kolejnym kroku zostaje wyświetlone okno zawierające warunki korzystania z oprogramowania Comarch BPM (dawniej DMS). Aby przejść do kolejnego kroku instalacji, należy zaznaczyć parametr ” Akceptuję warunki gwarancji i korzystania z oprogramowania Comarch BPM” i nacisnąć przycisk „Dalej”.
Akceptacja warunków korzystania z oprogramowania Comarch BPM (dawniej DMS)
W następnym kroku wymagany jest wybór folderu docelowego, w którym zostanie zainstalowana aplikacja stacjonarna. Lokalizację można zmienić, wpisując odpowiednią ścieżkę w polu „Folder:” lub wybierając folder po naciśnięciu przycisku „Przeglądaj”. Po wyborze folderu docelowego należy wybrać „Dalej”.
Wybór folderu docelowego do instalacji Comarch BPM (dawniej DMS)
W kolejnym kroku należy wprowadzić adres URL aplikacji serwerowej (starszej aplikacji web) Comarch BPM (dawniej DMS).
Wprowadzanie adresu URL aplikacji serwerowej
Wskazówka
Adres URL aplikacji serwerowej można sprawdzić w Menedżerze internetowych usług informacyjnych, po kliknięciu na nazwę danej aplikacji (np. „Standalone”) i wyborze opcji „Przeglądaj*:80 (http)”, dostępnej w oknie „Akcje” po prawej stronie. W przeglądarce zostanie wówczas wyświetlony adres aplikacji serwerowej, który można skopiować i wkleić w instalatorze.
Sprawdzanie adresu URL aplikacji serwerowej
Adres URL aplikacji serwerowej w przeglądarce
Następnie konieczne jest sprawdzenie poprawności połączenia za pomocą przycisku „Sprawdź połączenie”. Jeżeli wpisano poprawny adres URL, pod przyciskiem powinna pojawić się informacja „Wprowadzony adres URL jest prawidłowy”.
Po wprowadzeniu adresu URL i jego pozytywnej weryfikacji można przejść do zakładki „Ustawienia zaawansowane cz. 1”. W ramach tej zakładki operator może dokonać zmiany domyślnych ustawień, dostępnych w pliku DMS.exe.config w katalogu z plikami aplikacji stacjonarnej.
Zakładka „Ustawienia zaawansowane cz.1”
W ramach zakładki dostępne są następujące ustawienia:
Systemowe paski przewijania – odpowiada kluczowi <add key=”SystemScrollbars” value=”false” /> w pliku DMS.exe.config – decyduje o tym, czy w aplikacji desktop wyświetlane są paski przewijania o domyślnym systemowym wyglądzie (zaznaczony checkbox) czy ostylowane przez Comarch BPM (dawniej DMS) (odznaczony checkbox”);
Liczba dokumentów prezentowanych na jednej stronie – odpowiada kluczowi <add key=”DocumentListRowsCount” value=”50″ /> w pliku BPM.exe.config – określa ilość dokumentów widoczną na jednej stronie wyników wyszukiwania w aplikacji desktop (domyślnie 50);
Podgląd załączników PDF w zewnętrznym programie – odpowiada kluczowi <add key=”IntegratedPdfViewer” value=”true” /> w pliku DMS.exe.config – jeżeli zaznaczono checkbox, wówczas możliwy jest podgląd załączników w formacie *.pdf bezpośrednio w aplikacji Comarch BPM (dawniej DMS), w prawym panelu karty obiegu
W podglądzie PDF wyświetlaj pełną stronę załącznika – odpowiada kluczowi <add key=”ExtendedPdfViewerZoomToPageLevel” value=”false”/> w pliku BPM.exe.config – pozwala na dopasowanie rozmiaru załącznika do rozmiaru okna podglądu jedynie w przypadku podglądu za pomocą DevExpress);
Włącz kanały wirtualne dla plików – odpowiada kluczowi <add key=”VirtualChannelToLocalMachineFiles” value=”false” /> w pliku BPM.exe.config – jest odpowiedzialne za możliwość załączania plików z lokalnego komputera do aplikacji Comarch BPM (dawniej DMS), która jest uruchomiona na wirtualnej maszynie.
Kiedy checkbox jest zaznaczony, dodawanie załączników z katalogów umieszczonych na maszynie wirtualnej nie jest możliwe, wywoływane są wyłącznie okna z komputera lokalnego, na którym uruchomiono połączenie terminalowe.
>Można załączać pliki zarówno z lokalnego komputera jak i maszyny wirtualnej, jeśli w opcjach podłączania pulpitu zdalnego udostępniono dyski komputera lokalnego. W takiej konfiguracji należy odznaczyć checkbox.
Włącz kanały wirtualne dla skanerów – odpowiada kluczowi <add key=”VirtualChannelToLocalMachineScanner” value=”false” /> w pliku DMS.exe.config –odpowiedzialne za możliwość załączenia w aplikacji Comarch BPM (dawniej DMS) uruchomionej na wirtualnej maszynie skanu dokumentu bezpośrednio ze skanera podłączonego do lokalnego komputera użytkownika.
Wyświetlaj okna Comarch ERP Optima w trybie – odpowiada kluczowi <add key=”OptimaWindowsMode” value=”0″ /> – odpowiada za to, czy okna Comarch ERP Optima będą uruchamiane w trybie SDI czy MDI.Domyślnie została ustawiona wartość SDI.
Następnie można przejść do zakładki „Ustawienia zaawansowane cz. 2”. W ramach tej zakładki operator może dokonać zmiany kolejnych domyślnych ustawień, dostępnych w pliku BPM.exe.config w katalogu z plikami aplikacji stacjonarnej.
Zakładka „Ustawienia zaawansowane cz. 2”
W ramach zakładki dostępne są następujące ustawienia:
Wyświetlaj przebieg procesu na standardowym wydruku karty obiegu – odpowiada kluczowi <add key=”ShowTheProcessFlowOnThePrintout” value=”true” /> w pliku BPM.exe.config – określa, czy przebieg (etapy) ma być pokazywany na standardowych wydrukach;
Komponent do rozpoznawania kodów kreskowych – odpowiada kluczowi <add key=”ScanMode” value=”Aspose” /> w pliku BPM.exe.config – w ramach tego klucza możliwa jest zmiana komponentu do rozpoznawania kodów kreskowych; Można wybrać wartość
Aspose – komponent, który od wersji 2020.0.0 jest domyślnym komponentem służącym do rozpoznawania kodów kreskowych.
Internal – poprzedni komponent.
Limit czasu dla przetwarzania dokumentu w usłudze Comarch OCR – odpowiada kluczowi <add key=”OCRComarchTimeout” value=”15″ /> w plku DMS.exe.config – wartość to wyrażony w minutach czas, po którym przetwarzanie pliku zostanie przerwane i wyświetlony zostanie błąd (!), a program przejdzie do przetwarzania następnego dokumentu w kolejce.
Liczba maili pobieranych jednorazowo ze skrzynki – odpowiada kluczowi <add key=”MailsMaximumNumber” value=”15″ /> w pliku BPM.exe.config – umożliwia zmianę liczbę maili pobieranych jednorazowo ze skrzynki pocztowej. Domyślnie wartość klucza ustawiona jest na 15 – oznacza to, że jednorazowe odświeżenie listy maili przy pomocy przycisku pobierze i wyświetli na liście kolejne 15 wiadomości. W przypadku, kiedy w kluczu zostanie ustawiona wartość 0, wówczas będą pobierane wszystkie wiadomości e-mail.
Komponent obsługujący pocztę przychodzącą – odpowiada kluczowi <add key=”UseAlternativeMailClient” value=”true” /> w pliku DMs.exe.config – określa, czy do odbierania maili w punktach ACD użytkownicy korzystają z MailKit czy (wcześniejszego) MailSystem.NET (ActiveUp));
Utrzymanie sesji XL API – odpowiada kluczowi add key=”XLAPIHoldSession” value=”False” /> w pliku BPM.exe.config – służy do utrzymywania sesji podczas pracy z XLApi.Jeśli:
zaznaczono checkbox– podczas pracy z formatkami XL przez XLApi, sesja tworzy się w czasie pierwszego podniesienia formatki i nie jest zamykana po zamknięciu formatki – jest używana do czasu zamknięcia aplikacji.
nie zaznaczono checkboxa– sesja jest zamykana po zamknięciu formatki
Następnie należy nacisnąć „Dalej”.
Instalator jest już gotowy do instalacji. Aby do niej przystąpić, konieczne jest wybranie przycisku „Instaluj”.
Wybór przycisku „Instaluj”
Po wyborze przycisku „Instaluj” rozpoczyna się kilkuminutowa instalacja aplikacji stacjonarnej. Instalator dodaje pliki aplikacji stacjonarnej w lokalizacji wybranej przez operatora i dokonuje modyfikacji pliku dms.exe.config zgodnie z zaznaczonymi podczas instalacji wyborami.
Instalacja aplikacji desktop
Po zakończeniu instalacji zostaje wyświetlone okno „Instalacja Comarch BPM została zakończona”, w którym należy nacisnąć przycisk „Zakończ”. Jeżeli operator zaznaczy wcześniej parametr „Uruchom Comarch BPM”, zostanie uruchomiona aplikacja desktopowa.
Zakończenie instalacji aplikacji desktop
Aplikację desktopową BPM.exe można znaleźć w wybranym folderze domyślnym, np. C:\Program Files (x86)\Comarch S.A\Comarch BPM.
Uwaga
Instalator umożliwia instalację tylko jednej instancji BPM na komputerze. Jeżeli istnieje potrzeba zainstalowania kolejnych aplikacji BPM desktop, konieczne jest zainstalowanie ich ręcznie.
Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?
W ramach pliku BPM.exe.config (dawniej DMS.exe.config), który jest dostępny w katalogu z aplikacją desktop Comarch BPM (dawniej DMS), znajdują się następujące klucze:
<add key=”ServerUri” value=”http://localhost/bpmapi” /> – klucz, w którym należy wprowadzić adres URL, za pomocą którego uruchamiana jest aplikacja serwerowa (dawna web);
<add key =”DefaultPdfViewerType” value =”Devexpress”/> – klucz wprowadzony w wersji 2025.0.1 ; pozwala na wybór rodzaju podglądu załącznika w formacie PDF w ramach szczegółów dokumentu w aplikacji desktop Comarch BPM (dawniej DMS) (zob. Podgląd załącznika. Klucz przyjmuje następujące wartości:
"Chromium" – jeśli klucz przyjmuje tę wartość, a <add key="IntegratedPdfViewer" value="true" /> (wartość domyślna), wówczas podgląd załącznika może być wyświetlany jako:
podgląd wbudowany – wówczas podgląd nie ulega zmianie
podgląd za pomocą Chromium
podgląd za pomocą domyślnej aplikacji zewnętrznej
"Devexpress" – wartość domyślna; jeśli klucz przyjmuje tę wartość, a <add key="IntegratedPdfViewer" value="true" />, wówczas podgląd załącznika może być wyświetlany jako:
podgląd wbudowany
podgląd za pomocą Devexpressa
podgląd za pomocą domyślnej aplikacji zewnętrznej
<add key=” PdfViewerZoom” value=” FitToWidth”/> – klucz wprowadzony w wersji 2024.2.1 zamiast klucza "ExtendedPdfViewerZoomToPageLevel". Służy do ustawienia domyślnego zooma PDF Viewera dla załączników (jedynie w przypadku podglądu za pomocą DevExpress). Klucz może przyjąć jedną z następujących wartości:
" " - brak wartości; wówczas dokument jest wyświetlany w oryginalnym rozmiarze
FitToVisible – wówczas podgląd załącznika zostanie dopasowany do szerokości okna
FitToWidth – wartość domyślna; jeśli ta wartość została wprowadzona, wówczas podgląd załącznika zostanie dopasowany do szerokości tej strony dokumentu, która jest najszersza
ToPageLevel – wówczas podgląd załącznika zostanie wyświetlony z poziomu całej strony
<add key="IntegratedPdfViewer" value="true" /> - jeżeli w ramach klucza zostanie wprowadzona wartość „true”, wówczas możliwy jest podgląd załączników w formacie *.pdf bezpośrednio w aplikacji Comarch BPM (dawniej DMS) w prawym panelu karty obiegu;
<add key="SystemScrollbars" value="false" /> - klucz decyduje o tym, czy w aplikacji desktop wyświetlane są paski przewijania o domyślnym systemowym wyglądzie ("true") czy ostylowane przez Comarch BPM (dawniej DMS) ("false");
<add key="DocumentListRowsCount" value="50" /> - klucz określa ilość dokumentów widoczną na jednej stronie wyników wyszukiwania w aplikacji desktop;
<add key="ShowTheProcessFlowOnThePrintout" value="true" /> - klucz określa, czy przebieg (etapy) ma być pokazywany na standardowych wydrukach;
<add key="OptimaWindowsMode" value="0" /> - klucz odpowiada za to, czy okna Comarch ERP Optima będą uruchamiane w trybie SDI czy MDI. Parametr może przyjmować wartości 0 (tryb SDI) i 1 (tryb MDI). Domyślnie została ustawiona wartość 0
<add key="BlackBoxtimestampServer" value="https://serveraddress" /> – klucz dodany w wersji 2025.1.0; jest to adres serwera określającego aktualny czas. Serwer ten jest używany podczas elektronicznego podpisywania pdf (za pomocą wbudowanego komponentu SecureBlackBox);
<add key="ScanMode" value="Aspose" /> - w ramach tego klucza możliwa jest zmiana komponentu do rozpoznawania kodów kreskowych; klucz może przyjąć wartości:
Aspose – komponent, który od wersji 2020.0.0 jest domyślnym komponentem służącym do rozpoznawania kodów kreskowych.
Internal – poprzedni komponent.
Uwaga
Aby korzystać z poprzedniego komponentu do rozpoznawania kodów kreskowych konieczne jest wpisanie w wartość klucza ScanMode wartości „Internal”, w pozostałych przypadkach Comarch BPM (dawniej DMS) będzie korzystał z komponentu Aspose.
<!-- <add key="ScanRectangle" value="0,0,450,90"/> --> w ramach tego klucza można określić obszar (prostokąt) na skanie, w którym szukany jest kod kreskowy. Poszczególne parametry to:
(0) – współrzędna x lewego górnego wierzchołka prostokąta
(0) – współrzędna y lewego górnego wierzchołka prostokąta
(450) – szerokość prostokąta
(90) – wysokość prostokąta
<!-- <add key="AsposeScanFormats" value="EAN13"/> - klucz, w którym możliwe jest określenie typu rozpoznawanych kodów kreskowych dla komponentu Aspose. Domyślnie klucz jest zakomentowany - oznacza to, że komponent sam rozpozna typ skanowanego kodu kreskowego.
<!-- <add key="ScanFormats" value="CODE_39"/> - klucz określa aktywne formaty kodów kreskowych dla poprzedniego komponentu Internal,
<add key="UseAlternativeMailClient" value="true" /> - klucz określa, czy do odbierania maili w punktach ACD użytkownicy korzystają z MailKit ("true") czy (wcześniejszego) MailSystem.NET (ActiveUp) ("false");
<add key="MailsMaximumNumber" value="15" /> - klucz, który umożliwia zmianę liczbę maili pobieranych jednorazowo ze skrzynki pocztowej. Domyślnie wartość klucza ustawiona jest na 15 - oznacza to, że jednorazowe odświeżenie listy maili przy pomocy przycisku pobierze i wyświetli na liście kolejne 15 wiadomości. W przypadku, kiedy w kluczu zostanie ustawiona wartość 0, wówczas będą pobierane wszystkie wiadomości e-mail.
<add key="VirtualChannelToLocalMachineFiles" value="false" /> - klucz jest odpowiedzialny za możliwość załączania plików z lokalnego komputera do aplikacji Comarch BPM (dawniej DMS), która jest uruchomiona na wirtualnej maszynie.
Kiedy kanał wirtualny VirtualChannelToLocalMachineFiles jest włączony ("True"), dodawanie załączników z katalogów umieszczonych na maszynie wirtualnej nie jest możliwe, wywoływane są wyłącznie okna z komputera lokalnego, na którym uruchomiono połączenie terminalowe.
Można załączać pliki zarówno z lokalnego komputera jak i maszyny wirtualnej, jeśli w opcjach podłączania pulpitu zdalnego udostępniono dyski komputera lokalnego. W takiej konfiguracji należy wartość klucza VirtualChannelToLocalMachineFiles ustawić na "False".
<add key="VirtualChannelToLocalMachineScanner" value="false" /> - klucz jest odpowiedzialny za możliwość załączenia w aplikacji Comarch BPM (dawniej DMS) uruchomionej na wirtualnej maszynie skanu dokumentu bezpośrednio ze skanera podłączonego do lokalnego komputera użytkownika.
<add key="OCRComarchUri" value="https://cr.erp.comarch.pl/api/v1/" /> - adres serwera usługi Comarch OCR, na który wysyłane są pliki do rozpoznania w Comarch OCR
<add key="OCRComarchTimeout" value="15" /> - wartość to wyrażony w minutach czas, po którym przetwarzanie pliku zostanie przerwane i wyświetlony zostanie błąd (!), a program przejdzie do przetwarzania następnego dokumentu w kolejce.
<add key="OCRFilesExtensionFilter" value="" /> – klucz dodany w wersji 2024; w ramach klucza możliwe jest wprowadzenie takich rozszerzeń dokumentów, które mają być przetwarzane przez OCR. Poszczególne rodzaje rozszerzeń należy rozdzielić średnikami. Domyślnie filtr nie ma podanej wartości – w takim przypadku filtr jest nieaktywny;
add key="XLAPIHoldSession" value="False" /> - klucz służy do utrzymywania sesji podczas pracy z XLApi. Klucz przyjmuje wartości:
„true” – podczas pracy z formatkami XL przez XLApi, sesja tworzy się w czasie pierwszego podniesienia formatki i nie jest zamykana po zamknięciu formatki - jest używana do czasu zamknięcia aplikacji.
„false” – sesja jest zamykana po zamknięciu formatki
<add key="RPAFolderPath" value="C:\bpm" /> – klucz dostępny od wersji 2023.1.0; należy wpisać poprawną wartość, aby skrypt wprowadzony w ramach zakładki „Konfiguracja automatycznego trybu pracy” został poprawnie skompilowany. Jako wartość klucza należy wpisać ścieżkę do folderu z aplikacją desktop Comarch BPM (dawniej DMS), np. C:\bpm. (zob. Zakładka „Edytor skryptów”);
<add key="ACDExePath" value="" /> – klucz dostępny od wersji 2023.1.0; w ramach tego klucza należy wprowadzić ścieżkę do pliku .exe, który ma zostać uruchomiony w punkcie ACD, np. <add key="ACDExePath" value="C:\Windows\System32\calc.exe" /> (zob. Uruchamianie pliku exe w punkcie ACD);
<add key="ACDGenMaxDOP" value="1" /> – klucz dostępny od wersji 2024.0.0; w ramach tego klucza użytkownik może zwiększyć szybkość generowania dokumentów w punktach ACD; domyślna wartość tego parametru wynosi 1 – aby zwiększyć tempo generowania dokumentów należy wpisać cyfry większe niż 1; zaleca się, aby nie przekraczać wartości 4.
<add key="Version" value="5048505146494648" /> - zakodowany numer wersji Comarch BPM (dawniej DMS) - nie należy edytować.
Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?
W wersji Comarch DMS 2021.2.1 przed przystąpieniem do konfiguracji generatora dokumentów i opisu analitycznego do Comarch ERP Optima, należy na bazie firmowej Comarch ERP Optima wykonać skrypt fDO_IsRequiredDimension.sql
W przypadku zmodyfikowania standardowego przykładu generatora, wsparcie Asysty nie będzie świadczone.
Uwaga
Przed rozpoczęciem konfiguracji przykładu, w Comarch BPM (dawniej DMS) (lub w jednej ze spółek w trybie wielospółkowym) musi być skonfigurowana współpraca z Comarch ERP Optima 2025.5.1.
Uwaga
W przypadku aktualizacji istniejącego generatora należy skopiować wszystkie pliki z katalogu bin lub exe (w zależności od stosowanej konfiguracji desktop/web); w tym plik OptimaVatRegisterGenerator.exe.config. Plik konfiguracyjny został zaktualizowany do nowszej wersji formatu JSON i jego podmiana jest niezbędna do poprawnego działania generatora po aktualizacji.
Przykład generowania dokumentów został skonfigurowany dla parametru „Księgowość kontowa”.
Comarch ERP Optima, Konfiguracja rodzaju księgowości
Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?
Właściwości kontrolki typu załącznik, którą wybrano w punkcie konfiguracyjnym
Po skonfigurowaniu punktu ACD w ramach Współpracy z Comarch OCR (przesyłania skanów z kontrolki załącznik na dokumencie BPM) (zob. Definiowanie punktu konfiguracyjnego) wystarczy tylko utworzyć nowy dokument i dodać wybrany plik do kontrolki typu załącznik, która została wskazana w zakładce 'Ogólne’ punktu konfiguracyjnego.
Plik jest wtedy przesyłany do Comarch OCR, a wówczas kontrolki, które zostały skonfigurowane zapytaniem SQL w zakładce 'Kontrolki’ punktu konfiguracyjnego, są automatycznie uzupełniane danymi z załącznika.
Dane rozpoznane w Comarch OCR mogą zostać zweryfikowane poprzez włączenie podglądu dokumentu i porównanie z plikiem.
Uwaga
Kontrolka typu załącznik, z której dokument przesyłany jest do Comarch OCR, podlega pewnym ograniczeniom:
do kontrolki możliwe jest dodanie tylko jednego pliku
jeśli plik PDF dodany w ramach kontrolki składa się z dwóch lub więcej faktur, dodane będą tylko dane z pierwszej z faktur
możliwość dodawania skanów wprost ze skanera w ramach tej kontrolkizostała zablokowana – załącznik może pochodzić z dysku albo z managera dokumentów (po uprzednim zaznaczeniu opcji 'Manager dokumentów’ na karcie kontrolki typu załącznik)
jedynie pliki jpg, jpeg i pdfmogą zostać dodane w ramach kontrolki
Dodawanie załącznika do kontrolki, dla której utworzono punkt ACD
Dokument z danymi wczytanymi z pliku przesłanego z kontrolki typu załącznik do Comarch OCR, z włączonym oknem podglądu pliku
Od wersji 2025.2.0 w przypadku, jeśli obieg, który wybrano na definicji danego punktu ACD typu „Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie BPM” na zakładce „Ogólne” w polu „Typ obiegu” jest skonfigurowany do pracy z Repozytorium i wyboru lokalizacji w Repozytorium (na kontrolce typu Załącznik zaznaczono parametry: „Współpraca z Repozytorium” i „Pozwalaj na wybór lokalizacji podczas dodawania załącznika”), wówczas podczas dodawania załącznika zostanie wyświetlone okno wyboru lokalizacji, do której ma trafić plik załącznika w Comarch BPM Repozytorium (por. Wybór lokalizacji zapisu załącznika w Comarch BPM Repozytorium przez operatora dodającego załącznik w aplikacji desktop).
Wybór lokalizacji w Comarch BPM Repozytorium, do której ma trafić plik załącznika
Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?
Praca z punktem ACD (generowanie dokumentów do Repozytorium)
Analogicznie to typu współpracy „Współpraca z Comarch OCR” aby rozpocząć pracę z punktem ACD należy kolejno:
nacisnąć przycisk [Ustawienia OCR] i wybrać folder, z którego będą pobierane dokumenty do procesowania przez usługę Comarch OCR; w wersji 2025.2.1 w ramach okna wyświetlanego po kliknięciu w przycisk [Ustawienia OCR] dodano dwa pola, analogiczne do tych znajdujących się w punkcie ACD typu „Współpraca z OCR“:
Zakres stron do przetworzenia – pole umożliwia wprowadzenie zakresu stron do przetworzenia.
Łączenie stron przesyłanych plików – pole umożliwia wybór sposobu łączenia stron przetwarzanych przez OCR:
Według treści - łączenie stron w przesłanym pliku będzie odbywało się na podstawie zawartości zinterpretowanej przez algorytm usługi OCR
Jeden przesłany plik to jeden dokument - dokument nie zostaje podzielony i jest w całości przekazany do Repozytorium.
Kiedy zakres stron zostanie określony, OCR najpierw wybierze ten zakres stron z dokumentu, później zaś w tym zakresie połączy strony dokumentu według treści lub według założenia, że jeden przesłany plik jest równy jednemu dokumentowi (zgodnie z wybraną opcją).
Widok okna „Ustawienia OCR“ z polami „Zakres stron do przetworzenia“ i „Łączenie stron przesyłanych plików“
Widok okna „Ustawienia OCR“ z polami „Zakres stron do przetworzenia“ i „Łączenie stron przesyłanych plików“ – widoczne są opcje dostępne w ramach pola „Łączenie stron przesyłanych plików“
kliknąć przycisk [Dodaj pliki], aby wskazać plik, który zostanie umieszczony w folderze wybranym do pobierania dokumentów do procesowania lub przycisk [Skanuj], aby dodać dokument bezpośrednio ze skanera
Aby uruchomić przetwarzanie dokumentów w usłudze Comarch OCR należy zaznaczyć parametr „Włącz procesowanie dokumentów”. Po zaznaczeniu parametru dokumenty umieszczone we wskazanym folderze zostaną automatycznie przesłane do Comarch OCR i przeniesione do podkatalogu „Wysłane”.
Kiedy pliki zostały przeprocesowane przez usługę OCR, dokumenty wyświetlają się na liście, według zapytania z zakładki „Lista”, a informacje pochodzące z przeprocesowanego dokumentu zostają przeniesione do odpowiednich pól atrybutów, zgodnie z atrybutami wybranymi na zakładce „Atrybuty”. Obok nazwy atrybutu widoczny jest jego typ.
Następnie należy zaznaczyć checkbox znajdujący się obok danej pozycji na liście, a następnie kliknąć przycisk . Zostaje wówczas wyświetlone okno „Inicjowanie dokumentów”.
Okno „Inicjowanie dokumentów” informujące o wysyłaniu dokumentów do modułu Repozytorium
W ramach okna „Inicjowanie dokumentów” operator może kliknąć na przycisk [Zatrzymaj]. W takim przypadku, jeśli:
Generowany pojedynczy dokument zdążył zostać zainicjowany i przesłany – nie jest już widoczny na liście w punkcie ACD i znajduje się wybranej lokalizacji w module Repozytorium
Generowany pojedynczy dokument nie zdążył zostać przesłany – nadal jest widoczny na liście w punkcie ACD
Żaden z wielu generowanych dokumentów nie zdążył zostać przesłany – wszystkie dokumenty nadal są widoczne na liście w punkcie ACD
Tylko część z wielu generowanych dokumentów zdążyła zostać przesłana – wówczas ta część dokumentów nie jest już widoczna na liście w punkcie ACD i znajduje się w wybranej lokalizacji w module Repozytorium, a pozostałe nadal są na liście
Wszystkie z wielu generowanych dokumentów zdążyłyzostać przesłane – wówczas żaden z tych dokumentów nie jest już widoczny na liście w punkcie ACD i wszystkie znajdują się w wybranej lokalizacji w module Repozytorium
Dokument przetworzony przez Comarch OCR jest wysyłany do modułu Repozytorium, do lokalizacji, którą wybrano w ramach definicji punktu konfiguracyjnego. Przeprocesowane dane są także wprowadzane do bazy MongoDB.
Okno pracującego punktu konfiguracyjnego typu „Współpraca z Comarch OCR (generowanie dokumentów do Repozytorium)”
Rozpoczynasz pracę z Comarch BPM (dawniej DMS) i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch BPM (dawniej DMS) i chcesz dowiedzieć się więcej?
W przypadku zmodyfikowania standardowego przykładu generatora, wsparcie Asysty nie będzie świadczone.
Uwaga
Przed rozpoczęciem konfiguracji przykładu, w Comarch BPM (dawniej DMS) (lub w jednej ze spółek w trybie wielospółkowym) musi być skonfigurowana współpraca z Comarch ERP Optima 2025.5.1.
Uwaga
W przypadku aktualizacji istniejącego generatora należy skopiować wszystkie pliki z katalogu bin lub exe (w zależności od stosowanej konfiguracji desktop/web); w tym plik OptimaVatRegisterGenerator.exe.config. Plik konfiguracyjny został zaktualizowany do nowszej wersji formatu JSON i jego podmiana jest niezbędna do poprawnego działania generatora po aktualizacji.
Przykład generowania dokumentów został skonfigurowany dla parametru „Księgowość kontowa”.
Comarch ERP Optima, Konfiguracja rodzaju księgowości
Instalacja Microsoft SQL Server Express za pomocą instalatora Comarch BPM
Jeżeli użytkownik nie ma zainstalowanego Microsoft SQL, wtedy od wersji 2023.0.0 może dokonać instalacji darmowego Microsoft SQL Server Express za pomocą instalatora Comarch BPM (dawniej DMS) .
Aby uruchomić instalator Comarch BPM (dawniej DMS) , w pobranym pakiecie instalacyjnym należy wejść do katalogu Comarch BPM [wersja] instalator Comarch BPM i uruchomić Instalator Comarch BPM.exe
Uwaga
Podczas instalacji za pomocą Instalatora (Instalator Comarch BPM.exe) potrzebny jest dostęp do Internetu.
Wybór języka instalacji
Po uruchomieniu instalatora zostaje wyświetlone okno początkowe, w ramach którego dostępne jest pole „Język instalatora”, w którym należy dokonać wyboru języka, w jakim ma zostać przeprowadzona instalacja aplikacji. Dostępne są następujące języki:
Po wyborze języka instalacji należy nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji. Jeżeli operator naciśnie przycisk [Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony następujący komunikat:
Komunikat, który zostanie wyświetlony po naciśnięciu przycisku „Anuluj” lub przy próbie zamknięcia okna instalatora
Jeśli użytkownik wybierze przycisk:
Tak – instalator zostanie zamknięty
Nie – użytkownik pozostanie w tym samym oknie, a komunikat będzie zamknięty
Okno przygotowania komponentów
W kolejnym kroku instalatora zostaje wyświetlone okno, informujące o tym, że instalator przygotowuje potrzebne komponenty. Przejście do następnego okna nastąpi automatycznie.
W następnym kroku instalatora wyświetlone zostaje okno powitalne instalatora.
Okno przygotowania komponentów
W następnym kroku instalatora wyświetlone zostaje okno powitalne instalatora.
Jeżeli użytkownik chce kontynuować instalację, wówczas powinien nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji. Jeżeli operator naciśnie przycisk [Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony komunikat analogiczny do przedstawionego powyżej.
Wybór aplikacji
Następnie w ramach okna Wybór aplikacji należy zaznaczyć opcję Microsoft SQL Server Express i kliknąć przycisk [Dalej].
Wybór opcji „Microsoft SQL Server Express”
Wtedy następuje przejście do instalatora, w ramach którego nastąpi zainstalowanie najnowszej wersji Microsoft SQL Server Express – zostaje otwarte okno „Serwer bazodanowy SQL”
Serwer bazodanowy SQL
W ramach okna „Serwer bazodanowy SQL” użytkownik może wybrać sposób logowania do serwera SQL:
Logowanie domenowe – w takim przypadku użytkownik nie dokonuje żadnych zmian, tylko klika przycisk [Instaluj], aby przejść do następnego kroku instalacji
Okno „Serwer bazodanowy SQL”, jeśli wybrano logowanie domenowe – użytkownik nie wprowadza zmian, jedynie klika „Instaluj”
Za pomocą własnego hasła – w takim wypadku użytkownik będzie logował się do serwera SQL, używając własnego hasła, które zostanie nadane dla konta administratora o nazwie „sa” – w tym celu konieczne jest zaznaczenie dostępnego w ramach okna checkboxa Zabezpiecz własnym hasłem (domyślnie checkbox jest odznaczony). Po zaznaczeniu checkboxa poniżej pojawiają się pola:
Hasło – należy tu wpisać hasło, za pomocą którego użytkownik będzie się logował na serwerze SQL. Hasło musi składać się z 12 znaków i spełniać następujące zasady, a mianowicie zawierać:
Małe litery
Wielkie litery
Cyfry
Znaki specjalne
Powtórz hasło – w tym polu konieczne jest ponowne wpisanie frazy, za pomocą której uzupełniono pole „Hasło”
Po wpisaniu hasła w obydwóch polach należy nacisnąć przycisk [Instaluj], aby przejść do następnego kroku instalacji. Przycisk jest nieaktywny do czasu poprawnego uzupełnienia pól.
Okno „Serwer bazodanowy SQL”, jeśli wybrano logowanie za pomocą własnego hasła – użytkownik zaznacza checkbox „Zabezpiecz własnym haslem”, uzupełnia hasło w dostępnych polach i klika „Instaluj”
Wskazówka
Jeśli wybrano logowanie za pomocą własnego hasła, to aby zalogować się do Microsoft QL Server Express konieczny będzie wybór opcji „SQL Server Authentication” i wpisanie sa w polu „Login” oraz określonego podczas instalacji hasła w polu „Hasło”.
Przykładowe logowanie do serwera SQL
Instalowanie
Po wyborze sposobu logowania do serwera SQL i kliknięciu przycisku [Instaluj] następuje instalacja Microsoft SQL Server Express, wyświetlane jest także okno instalacji serwera.
Koniec pracy instalatora
Kiedy instalacja Microsoft SQL Server Express dobiegnie końca, wówczas nastąpi przejście do okna „Koniec pracy instalatora”, zaś okno instalacji serwera zamknie się automatycznie. Aby wyjść z okna, należy wybrać przycisk „Zakończ”.
Okno „Koniec pracy instalatora”
Następnie należy zainstalować aplikacje: serwerową (dawną web) i WEB (nową web) Comarch BPM (dawniej DMS) jak opisano w artykule:
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?
Do katalogu bin\exe w katalogu, w którym zainstalowano aplikację serwerową (dawna web) należy skopiować całą zawartość kataloguexe.
W ustawieniach zaawansowanych puli aplikacji należy powiązać pulę z kontem Windows, na którym zainstalowano Comarch ERP Optima.
Ustawienia zaawansowane puli aplikacji
Ustawienie tożsamości puli aplikacji
Tożsamość puli aplikacji – ustawianie poświadczeń dla niestandardowego konta
W definicji kontrolek:
Rejestr VAT zakupu
Komunikat
Walidator
należy we wzorze na wartość SQL OD zamienić identyfikator kontrolki @Generuj_dokument_EXE@ na @Generuj_dokument_IISEXE@
Wzór na wartość w kontrolce typu ‘Dokument elektroniczny’ – Rejestr Vat zakupu
Następnie należy wskazać konfiguracyjną bazę danych ERP Optima w zapytaniach inicjujących wartości kontrolek. W tym celu należy:
1. uruchomić stacjonarną wersję Comarch BPM (dawniej DMS);
2. przejść do konfiguracji zaimportowanego typu obiegu.
3. w kontrolkach:
Waluta
Elementy, Lista Stawka
Elementy, zakładka inicjowanie wartości -> kontrolki powiązane: 3 wystąpienia
w zapytaniach SQLodszukać nazwę bazy „CDN_KNF_Konfiguracja” i zamienić ją na właściwą nazwę konfiguracyjnej bazy danych.
4. w wielospółkowym trybie pracy Comarch BPM (dawniej DMS) należy dodatkowo zweryfikować spółkę, która jest wskazana w kontrolkach:
Kontrahent
Kategoria
Opis kategorii
Rejestr
Typ rejestru
Forma płatności
Waluta
Definicje list w kontrolce Elementy
Generuj dokument
Rejestr Vat zakupu
Aby możliwe było generowanie dokumentów do Rejestru VAT Optima z załącznikami, wymagane jest zapisywanie załączników w bazie Comarch BPM (dawniej DMS).
Za ustawienie bazy, w której zapisywane są załączniki odpowiada klucz <add key=”DestinationAttachmentsWorkflow”value=”DO” />w pliku Web.config (wartość DO oznacza zapisywanie załączników w bazie Comarch BPM (dawniej DMS)).
Z poziomu kontrolki „Własna akcja” (Generuj dokument), należy ustawić definicję uruchomienia dodatku, definicja uruchomienia powinna się znaleźć w edytorze SQL wywołanym dla opcji IIS.
Definicja obiegu dokumentów, kontrolka typu Własna akcja, Zapytanie SQL dla pliku wykonywalnego na serwerze IIS.
Kontrolka Walidator
W załączonym typie obiegu znajduje się kontrolka Walidator, w jej definicji wprowadzono warunek, odpowiadający za możliwość jednokrotnego generowania dokumentu.
Warunek blokuje możliwość wygenerowania kolejnego dokumentu również w przypadku, gdy wcześniej wygenerowany dokument w Comarch ERP Optima został odpięty od dokumentu w Comarch BPM (dawniej DMS).
W przypadku, gdy zajdzie potrzeba wygenerowania wielu dokumentów, należy zmienić warunek w kontrolce.
W przypadku, gdy:
dokument generowany jest poprawnie, kontrolka typu „Własna akcja” (Generuj dokument) zwróci w kontrolce Walidator wartość większą od zera (ID wygenerowanego dokumentu),
wystąpi błąd, kontrolka typu „Własna akcja” (Generuj dokument) zwróci w kontrolce Walidator wartość mniejszą od zera.
Domyślnie w kontrolce jest wartość 0.
Uruchomienie przykładu
Po otwarciu nowego dokumentu BPM (dawniej DMS) należy wprowadzić lub zmienić wartości na karcie obiegu. Wartości w kontrolkach, których opis jest pogrubiony są obowiązkowe.
Następnie należy zapisać dokument lub przekazać do kolejnego etapu.
Kolejnym krokiem jest kliknięcie w przycisk „Generuj dokument”, wygenerowany dokument automatycznie zostanie podpięty do pola „Rejestr VAT zakupu”.
Obieg dokumentów, generowanie dokumentu do rejestru VAT w Comarch ERP Optima.
W przypadku gdy dokument generowany jest z załącznikami, dołączone pliki dostępne są na dokumencie OBD powiązanym z wygenerowanym dokumentem w rejestrze VAT.
W oknie dokumentu Comarch ERP Optima uruchomionym w Comarch BPM (dawniej DMS)nie ma możliwości podglądu dokumentu OBD, tym samym nie ma możliwości usunięcia załączników dodanych na dokument OBD.
Aby zweryfikować listę załączonych plików, należy otworzyć dokument w systemie Comarch ERP Optima.
Dokument w rejestrze VAT zakupu w Comarch ERP Optima oraz powiązany dokument OBD z załącznikiem przekazanym z Comarch BPM (dawniej DMS). Dokumenty wyświetlone w systemie Comarch ERP Optima
Oprócz dołączania załączników, na dokument OBD w Comarch ERP Optima umieszczane są:
1. w polu Numer obcy: informacjao numerze dokumentu Comarch BPM (dawniej DMS), z którego wygenerowano dokumenty w Comarch ERP Optima
2. w tytule dokumentu: informacja ‘Dokument Comarch BPM’.
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?
. Dla atrybutów wymaganych taka opcja nie jest dostępna.
obok nazwy załącznika, 
[Dalej].
[Instaluj] – wówczas zostanie otwarte okno instalatora aplikacji Comarch BPM (dawniej DMS) Desktop, w którym należy postępować zgodnie z dalszą częścią instrukcji.
[Zatrzymaj]. W takim przypadku, jeśli:
[Dalej], aby przejść do kolejnego kroku instalacji. Jeżeli operator naciśnie przycisk 
[Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony następujący komunikat:
[Dalej], aby przejść do kolejnego kroku instalacji. Jeżeli operator naciśnie przycisk 
[Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony komunikat analogiczny do przedstawionego powyżej.
[Dalej].
[Instaluj], aby przejść do następnego kroku instalacji. Przycisk jest nieaktywny do czasu poprawnego uzupełnienia pól.
[Instaluj] następuje instalacja Microsoft SQL Server Express, wyświetlane jest także okno instalacji serwera.
