W wersji 2024.2.0 umożliwiono dodawanie pliku z modułu Repozytorium do kontrolki typu Załącznik w nowej aplikacji web Comarch DMS.

Dodawanie załączników z Repozytorium w nowej aplikacji web Comarch DMS jest możliwe, jeśli spełnione zostały następujące warunki:

Jeśli powyższe warunki zostały spełnione, wówczas po kliknięciu w przycisk [Dodaj] w ramach kontrolki typu Załącznik w aplikacji web zostaje otwarte okno z dwiema zakładkami:

• Z dysku – domyślnie otwarta; z poziomu tej zakładki możliwe jest dodawanie plików znajdujących się na dysku za pomocą jednego z dwóch sposobów:
  • za pomocą metody drag & drop („przeciągnij i upuść”)
  • poprzez kliknięcie w link znajdujący się w polu, wybór pliku w ramach okna systemowego „Otwieranie” i naciśnięcie przycisku „Otwórz”

 

 

Jeśli dla danej kontrolki zaznaczono parametr „Współpraca z Repozytorium”, wówczas istnieje możliwość nadania nazwy dokumentu podczas dodawania załącznika i przyporządkowania wybranego typu dokumentu z listy typów dokumentów zdefiniowanej w module Repozytorium.

Uwaga

W przypadku, gdy pliki dodawane z dysku nie są przesyłane do Repozytorium, zmiana nazwy pliku podczas dodawania załącznika nie jest możliwa.

 

 

Aby dodać plik do kontrolki typu Załącznik, należy następnie kliknąć w przycisk [Dodaj]. Gdy dokument zostanie zapisany, załącznik zostanie przesłany do Repozytorium pod wprowadzoną nazwą i przyporządkowany do wybranego typu dokumentu.

• Z repozytorium – z poziomu tej zakładki możliwe jest wyszukiwanie i wybór plików z modułu Repozytorium, które zostaną dodane do kontrolki typu Załącznik

Operator, który dodaje pliki z modułu Repozytorium do kontrolki typu Załącznik w nowej aplikacji web Comarch DMS, musi spełniać jeden z następujących warunków:

Istnieje również możliwość wyszukania pliku albo zawężenia listy dokumentów poprzez wpisanie frazy w polu wyszukiwarki „Wyszukaj w repozytorium”, a następnie kliknięcie w pole .

Aby dodać dokument z modułu Repozytorium do kontrolki typu Załącznik, operator powinien kolejno:

Następnie okno „Dodaj załącznik” zostanie zamknięte, a wybrany plik/pliki zostaną dodane do kontrolki typu Załącznik.

Operator może jednorazowo zaznaczyć wiele dokumentów w ramach jednego dokumentu, klikając kolejno w ich nazwy. Jeśli natomiast chce odznaczyć dany plik, wówczas powinien kliknąć w niego ponownie.

Na belce nad listą dokumentów wyświetlana jest liczba wybranych dokumentów.

Podczas przechodzenia do innego katalogu wybrane wcześniej pliki są odznaczane, zeruje się również licznik zaznaczonych dokumentów na belce nad listą dokumentów.

Przycisk [Dodaj] jest nieaktywny, jeśli nie zaznaczono co najmniej jednego dokumentu.

W ramach zakładki „Z repozytorium” nad listą dokumentów znajdują się następujące filtry:

• Status – filtr zawiera opcje pozwalające na ograniczenie listy dokumentów do dokumentów o wybranym statusie:
  • Dowolny – po wyborze tej opcji wszystkie dokumenty aktywne i zarchiwizowane z danego folderu są widoczne na liście
  • Aktywne – po wyborze tej opcji jedynie wszystkie dokumenty aktywne z danego folderu są widoczne na liście
  • Zarchiwizowane – po wyborze tej opcji tylko wszystkie dokumenty zarchiwizowane z danego folderu są widoczne na liście

 

 

• Data dodania – po kliknięciu w to pole otwierane jest okno „Wybierz zakres dat”, które pozwala na wybór zakresu dat, w których dokumenty zostały dodane do Repozytorium. Po zaznaczeniu zakresu dat należy kliknąć w przycisk [Zapisz], aby filtr został zastosowany;

 

• Typ – kliknięcie w ten filtr pozwala na ograniczenie dokumentów na liście do tych, które należą do wybranych typów dokumentów w Comarch DMS Repozytorium (Nieokreślony i/lub typy dokumentów dodane przez administratorów Comarch DMS Repozytorium) pod warunkiem, że dane typy dokumentów zostały ustawione w aplikacji desktop Comarch DMS na definicji danej kontrolki typu Załącznik, na zakładce „Archiwa”, w sekcji „Ustawienia typów dokumentów”.
• Domyślnie wszystkie dostępne typy dokumentów są zaznaczone.

 

 

• Więcej filtrów – po kliknięciu w ten filtr otwarte zostaje okno „Pozostałe filtry”, w ramach którego operator może filtrować dokumenty według kryterium okresu przechowywania (w przypadku dokumentów podległych retencji), wartości atrybutów.

Jeśli użytkownik wybrał filtry, wówczas nad listą dokumentów widoczny jest również link [Wyczyść filtry]. Po kliknięciu w ten link wszystkie filtry zostaną wyłączone.

Gdy do kontrolki typu Załącznik w nowej aplikacji web Comarch DMS dodano załącznik z modułu Repozytorium, wówczas po kliknięciu w nazwę załącznika jego podgląd zostaje wyświetlony na prawym panelu. Podgląd jest możliwy dla każdego operatora, który ma dostęp do dokumentu w module Workflow.

Po kliknięciu w przycisk na kontrolce typu załącznik wyświetlane jest menu kontekstowe.

Jeśli dany załącznik został dodany z modułu Repozytorium, wówczas menu składa się z następujących opcji:

• Otwórz w Repozytorium – opcja dostępna dla operatorów, którzy mają dostęp do modułu Repozytorium; po wyborze tej opcji zostaje otwarty podgląd danego pliku w module Repozytorium – ta opcja jest dostępna także na podglądzie dokumentu po kliknięciu w przycisk [Otwórz w Repozytorium];
• Pobierz – opcja dostępna dla każdego operatora danego dokumentu w module Workflow; po wyborze tej opcji plik załącznika zostaje pobrany na dysk stosownie do ustawień przeglądarki;
• Zmień typ – opcja dostępna dla operatorów, którzy mają dostęp do modułu Repozytorium oraz uprawnienie do danego pliku na poziomie „Edytor” albo „Administrator”; po wyborze tej opcji zostaje otwarte okno „Zmień typ”, w ramach którego można zmienić typ przypisany do danego dokumentu w module Repozytorium na inny zdefiniowany w ramach Repozytorium, klikając na odpowiednią pozycję. Okno „Zmień typ” zostaje wówczas zamknięte. Wprowadzoną zmianę należy zapisać, zapisując dokument w nowej aplikacji web Comarch DMS.

 

 

• Zobacz szczegóły – opcja dostępna dla każdego operatora danego dokumentu w module Workflow; po wyborze tej opcji zostaje otwarte okno „Szczegóły dokumentu”, w którym znajdują się trzy zakładki:
  • Informacje – zakładka zawiera część danych z zakładki [Szczegóły] z prawego panelu widocznego po zaznaczeniu dokumentu w module Repozytorium;
  • Atrybuty – zakładka zawiera informacje z zakładki [Atrybuty] z prawego panelu widocznego po zaznaczeniu dokumentu w module Repozytorium;
  • Powiązane procesy – na zakładce znajdują się informacje z zakładki [Procesy powiązane z dokumentem] z prawego panelu widocznego po zaznaczeniu dokumentu w module Repozytorium. W ramach zakładki widoczne są numery dokumentów w module Workflow, do których dołączono dany dokument z Repozytorium jako załącznik. Proces oznaczony jako „Główny” oznacza dokument w module Workflow, z którego wartości kontrolek są mapowane do atrybutów na dokumencie znajdującym się w module Repozytorium

 

 

 

 

• Usuń – opcja dostępna dla każdego operatora danego dokumentu w module Workflow; po wyborze tej opcji plik zostaje usunięty z kontrolki typu Załącznik, ale nie zostaje usunięty z modułu Repozytorium. Zmianę należy zapisać.

W przypadku, jeśli plik dodany z modułu Repozytorium do kontrolki typu Załącznik usunięto do kosza, kosza retencji lub z systemu, wówczas jeśli operator próbuje wykonać jedną z następujących czynności:

Wówczas zostaje wyświetlony następujący komunikat: „Dokument <nazwa danego pliku> został usunięty w module Repozytorium. Pobranie dokumentu nie jest możliwe.”.

Umożliwienie instalacji serwera Mongo DB oraz instalacji i aktualizacji aplikacji Comarch DMS Repozytorium z poziomu instalatora Comarch

W wersji 2024.2.0 umożliwiono:

Zmiany w oknie „Wybór aplikacji”

W ramach okna „Wybór aplikacji” zaszły następujące zmiany:

Zmianie uległy również komentarze dostępne po lewej stronie okna.

Dodanie okna „Wybór aplikacji cd.”

W wersji 2024.2.0 dodano okno „Wybór aplikacji cd.”. Okno wyświetlane jest w przypadku, jeśli w oknie „Wybór aplikacji” operator zaznaczył opcję „Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium”, a następnie nacisnął [Dalej].

W ramach okna „Wybór aplikacji cd.” operator może wybrać jedną z trzech opcji:

Instalacja serwera Mongo DB

Aby zainstalować serwer Mongo DB, należy przejść do katalogu <wybrana lokalizacja/Comarch DMS 2024.2.0\Comarch DMS 2024.2.0 instalator Comarch DMS i uruchomić plik Instalator Comarch DMS.exe na komputerze, na którym ma zostać zainstalowany serwer MongoDB a/albo MongoDB Compass i gdzie zostanie utworzona nowa baza MongoDB.

Po przejściu kolejnych kroków instalacji analogicznie jak w poprzedniej wersji operator powinien wybrać dodaną w wersji 2024.2.0 opcję „Instalacja serwera MongoDB” w ramach okna „Wybór aplikacji”, a następnie kliknąć [Dalej].

Po naciśnięciu [Dalej] następuje przejście do okna „Serwer MongoDB”. Jeśli na danym komputerze jest już zainstalowany serwer Mongo DB, wówczas wyświetlony zostanie następujący komunikat blokujący ponowną instalację serwera MongoDB:

Po wyborze przycisku „OK” komunikat zostanie zamknięty, a operator będzie mógł wybrać inny komponent do instalacji/aktualizacji w oknie „Wybór aplikacji”

Jeżeli na danym komputerze nie jest zainstalowany serwer MongoDB, wówczas nastąpi przejście do okna „Serwer MongoDB”. W ramach okna znajdują się następujące pola:

Kiedy operator wpisał poprawny adres IP serwera IIS, login oraz hasło, wówczas przycisk [Instaluj] staje się aktywny.

Po kliknięciu w przycisk [Instaluj] następuje przejście do okna „Instalacja” i odbywa się instalacja serwera MongoDB, wyświetlane jest także osobne okno instalacji serwera.

Gdy instalacja serwera MongoDB została zakończona, wówczas następuje przejście do okna „Koniec pracy instalatora”, a okno instalacji serwera zostanie automatycznie zamknięte. Aby zamknąć okno instalatora DMS, należy nacisnąć [Zakończ].

W dalszej kolejności należy zainstalować aplikacje: serwerową, WEB (jeśli nie zostały zainstalowane wcześniej) oraz Repozytorium.

Instalacja aplikacji Comarch DMS

Jeśli operator chce zainstalować aplikację Comarch DMS (bez Comarch DMS Repozytorium) – wówczas powinien zaznaczyć opcję „ Instalacja aplikacji Comarch DMS”.

W takim przypadku kolejne kroki instalacji pozostają bez zmian w stosunku do poprzedniego instalatora Comarch DMS, z wyjątkiem zmiany warunków do silnego hasła oraz komunikatów w oknie Baza danych Comarch DMS, Baza danych Comarch ERP XL, Konfiguracyjna baza danych Comarch ERP Optima, Firmowa baza danych Comarch ERP Optima (zob. Zmiany warunków do silnego hasła oraz komunikatów dotyczących błędnego hasła w instalatorze Comarch DMS).

Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium

Jeśli operator chce zainstalować zarówno aplikację Comarch DMS, jak i aplikację Comarch DMS Repozytorium – w takim przypadku powinien zaznaczyć opcję „Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium”.

W takim przypadku kolejne kroki instalacji aż do okna Baza danych Comarch DMS (tryb pracy Comarch DMS Standalone)/ Baza danych Comarch ERP XL (tryb pracy Współpraca z Comarch ERP XL)/Firmowa baza danych Comarch ERP Optima (tryb pracy Współpraca z Comarch ERP Optima) pozostają bez zmian w stosunku do poprzedniego instalatora Comarch DMS, z wyjątkiem zmiany warunków do silnego hasła oraz komunikatów w oknie Baza danych Comarch DMS, Baza danych Comarch ERP XL, Konfiguracyjna baza danych Comarch ERP Optima, Firmowa baza danych Comarch ERP Optima (zob. Zmiany warunków do silnego hasła oraz komunikatów dotyczących błędnego hasła w instalatorze Comarch DMS).

Po kliknięciu przycisku [Dalej] w ramach okna Baza danych Comarch DMS (tryb pracy Comarch DMS Standalone)/ Baza danych Comarch ERP XL (tryb pracy Współpraca z Comarch ERP XL)/ Firmowa baza danych Comarch ERP Optima (tryb pracy Współpraca z Comarch ERP Optima) następuje przejście do dodanego w wersji 2024.2.0 okna „Pula aplikacji dla Comarch DMS Repozytorium”

W ramach okna „Pula aplikacji Comarch DMS Repozytorium” należy określić, na jakiej puli aplikacji ma pracować aplikacja Comarch DMS Repozytorium– w tym celu należy:

Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji , klikając przycisk   [Dalej].

Następnie w dodanym w wersji 2024.2.0 oknie Kreowanie aplikacji Repozytorium następuje konfiguracja aplikacji dla modułu Comarch DMS Repozytorium. W ramach okna Kreowanie aplikacji Repozytorium użytkownik:

Uwaga

Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

• • • \
    • ?
    • ;
    • :
    • @
    • (spacja)
    • =
    • +
    • $
    • „
    • |
    • ”
    • <
    • >
    • *

Jeżeli użytkownik wpisze nazwę zawierającą jeden lub więcej z powyższych znaków, wówczas nowa aplikacja nie zostanie utworzona, a w dolnej części okna pojawi się informacja o zakazanych znakach specjalnych.

W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Nazwa aplikacji” tak, aby nie zawierała już znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].

Następnie należy kliknąć przycisk   [Utwórz aplikację], aby nowa aplikacja została utworzona. Podczas tworzenia aplikacji w dolnej części okna widoczna jest informacja „Trwa kreowanie aplikacji”. Jeżeli utworzenie aplikacji przebiegło pomyślnie, wówczas wyświetlana jest informacja „Aplikacja została utworzona pomyślnie”. Przycisk   [Utwórz aplikację] nie jest aktywny do czasu wybrania witryny i wpisania nazwy aplikacji przez użytkownika.

Operator ma również opcję dodania nowej witryny, na której utworzy aplikację Comarch DMS Repozytorium, jednakże zaleca się, aby aplikację Comarch DMS Repozytorium zainstalować na tej samej witrynie, na której zainstalowano moduł Workflow Comarch DMS.

Aby jednak utworzyć nową witrynę operator powinien:

Następnie operator powinien nacisnąć przycisk   [Utwórz witrynę]. Jeśli tworzenie witryny zakończyło się powodzeniem, wówczas w dolnej części okna wyświetlany jest napis Witryna została utworzona na serwerze IIS.

Aby przejść do kolejnego kroku instalacji należy wybrać przycisk   [Dalej]. Przycisk nie jest aktywny, dopóki aplikacja nie została utworzona.

Następnie w ramach okna „Baza danych Comarch DMS Repozytorium” operator powinien uzupełnić:

Następnie należy sprawdzić poprawność wprowadzonych danych, klikając w przycisk [Połącz].

Jeśli próba nawiązania połączenia zakończyła się powodzeniem, w dolnej części okna wyświetlony zostaje napis „Nawiązano połączenie z serwerem MongoDB”.

Następnie operator powinien wybrać bazę w ramach pola „Lista baz danych” (jeśli wcześniej przygotowano bazę przeznaczoną dla Comarch DMS Repozytorium) albo nacisnąć przycisk [Dodaj bazę], aby utworzyć nową bazę danych dla aplikacji Comarch DMS Repozytorium.

Jeżeli operator kliknął w przycisk [Dodaj bazę], wówczas zostaje otwarte okno w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch DMS Repozytorium, a następnie kliknąć  [Zapisz]. Jeżeli użytkownik nie chce jednak dodać nowej bazy, wtedy powinien nacisnąć przycisk   [Anuluj] albo znak X.

Po naciśnięciu przycisku   [Zapisz] baza Comarch DMS Repozytorium zostaje dodana i w ramach instalatora wyświetla się informacja „ Baza danych została utworzona”.

Następnie operator powinien nacisnąć przycisk [Zmień hasło].

W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser serwera MongoDB, za którego pośrednictwem będzie odbywać się komunikacja aplikacji Comarch DMS Repozytorium z bazą danych. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

Hasło powinno spełniać następujące warunki:

Jeżeli wpisano hasło, które nie spełnia któregoś z tych trzech wymagań, wówczas po kliknięciu przycisku   [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

Należy zmienić hasło, tak, aby spełniało wszystkie warunki.

Jeśli natomiast hasło wpisane w polu „Powtórz hasło” różni się od hasła wpisanego w polu „Hasło”, wtedy po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

Należy uzupełnić pole „Powtórz hasło” tak, aby zgadzało się z polem „Hasło”.

Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk   [Zapisz], okno zmiany hasła dla MongoUsera zostaje zamknięte, a hasło użytkownika MongoUser zostaje zmienione. Następnie operator powinien kliknąć  [Dalej].

Po kliknięciu w przycisk  [Dalej] następuje przejście do okna „Klucze licencji”. Operator powinien uzupełnić:

Po uzupełnieniu pól operator powinien kliknąć [Instaluj]. Następuje wówczas przejście do kolejnego okna „Instalacja”.

Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji. Gdy użytkownik kliknie przycisk   [Zakończ], instalator zostanie zamknięty, natomiast zostanie otwarta przeglądarka na ekranie logowania do nowej aplikacji WEB Comarch DMS, zgodnie z nazwą aplikacji, którą podano w instalatorze.

Dalsze kroki dotyczące konfiguracji Comarch DMS Repozytorium należy wykonać w ramach aplikacji desktop Comarch DMS, a następnie w zakładce [Repozytorium] w aplikacji web Comarch DMS.

Instalacja Comarch DMS Repozytorium

Jeżeli operator chce zainstalować tylko aplikację Comarch DMS Repozytorium do wybranej aplikacji Comarch DMS – wówczas powinien zaznaczyć opcję „Instalacja Comarch DMS Repozytorium” i nacisnąć [Dalej].

Po kliknięciu przycisku [Dalej] następuje przejście do okna Warunki korzystania z oprogramowania, gdzie należy zapoznać się z warunkami korzystania z oprogramowania Comarch DMS, zaznaczyć checkbox „Akceptuję warunki instalacji” i nacisnąć   [Dalej], aby przejść do kolejnego etapu – przycisk nie jest aktywny, jeśli nie została zaznaczona zgoda na warunki instalacji.

Po przejściu przez kolejne okna – „Internetowe usługi informacyjne (IIS)”, a następnie „Wymagane dodatki” – analogiczne do okien w dotychczasowym instalatorze – w ramach okna „Pula aplikacji Comarch DMS Repozytorium” należy określić, na jakiej puli aplikacji ma pracować aplikacja Comarch DMS Repozytorium– w tym celu należy:

Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji , klikając przycisk   [Dalej].

Następnie w dodanym w oknie Kreowanie aplikacji Repozytorium następuje konfiguracja aplikacji dla modułu Comarch DMS Repozytorium. W ramach okna Kreowanie aplikacji Repozytorium użytkownik:

Uwaga

Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

• • • \
    • ?
    • ;
    • :
    • @
    • (spacja)
    • =
    • +
    • $
    • „
    • |
    • ”
    • <
    • >
    • *

Jeżeli użytkownik wpisze nazwę zawierającą jeden lub więcej z powyższych znaków, wówczas nowa aplikacja nie zostanie utworzona, a w dolnej części okna pojawi się informacja o zakazanych znakach specjalnych.

W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Nazwa aplikacji” tak, aby nie zawierała już znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].

Następnie należy kliknąć przycisk   [Utwórz aplikację], aby nowa aplikacja została utworzona. Podczas tworzenia aplikacji w dolnej części okna widoczna jest informacja „Trwa kreowanie aplikacji”.

Jeżeli utworzenie aplikacji przebiegło pomyślnie, wówczas wyświetlana jest informacja „Aplikacja została utworzona pomyślnie”. Przycisk   [Utwórz aplikację] nie jest aktywny do czasu wybrania witryny i wpisania nazwy aplikacji przez użytkownika.

Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Nazwa witryny” i ponownie kliknąć    [Utwórz aplikację].

Operator ma również opcję dodania nowej witryny, na której utworzy aplikację Comarch DMS Repozytorium, jednakże zaleca się, aby aplikację Comarch DMS Repozytorium zainstalować na tej samej witrynie, na której zainstalowano moduł Workflow Comarch DMS.

Aby jednak utworzyć nową witrynę operator powinien:

Następnie operator powinien nacisnąć przycisk   [Utwórz witrynę].

Jeśli tworzenie witryny zakończyło się powodzeniem, wówczas w dolnej części okna wyświetlany jest napis Witryna została utworzona na serwerze IIS.

Po kliknięciu  [Dalej] następuje przejście do okna „Witryny i aplikacje Comarch DMS”. W ramach okna operator powinien:

Kiedy operator wskazał witryny i aplikacje, a następnie kliknął przycisk  [Dalej], wówczas następuje weryfikacja zgodności wersji wybranych aplikacji Comarch DMS z wersją modułu Comarch DMS Repozytorium, która jest instalowana.

Jeżeli weryfikacja wykaże, że wersje nie są zgodne, wówczas zostanie wyświetlony następujący komunikat:

Gdy operator kliknie przycisk [OK], instalator zostanie zamknięty.

Jeśli weryfikacja zgodności wersji wybranych aplikacji Comarch DMS z wersją modułu Comarch DMS Repozytorium zakończyła się powodzeniem, wówczas po kliknięciu przycisku  [Dalej] następuje przejście do okna „Baza danych Comarch DMS Repozytorium”.

W oknie „Baza danych Comarch DMS Repozytorium” operator powinien uzupełnić:

Następnie należy sprawdzić poprawność wprowadzonych danych, klikając w przycisk [Połącz].

Jeśli próba nawiązania połączenia zakończyła się powodzeniem, w dolnej części okna wyświetlony zostaje napis „Nawiązano połączenie z serwerem MongoDB”.

Następnie operator powinien wybrać bazę w ramach pola „Lista baz danych” (jeśli wcześniej przygotowano bazę przeznaczoną dla Comarch DMS Repozytorium) albo nacisnąć przycisk [Dodaj bazę], aby utworzyć nową bazę danych dla aplikacji Comarch DMS Repozytorium.

Jeżeli operator kliknął w przycisk [Dodaj bazę], wówczas zostaje otwarte okno w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch DMS Repozytorium, a następnie kliknąć  [Zapisz].

Jeżeli użytkownik nie chce jednak dodać nowej bazy, wtedy powinien nacisnąć przycisk   [Anuluj] albo znak X.

Po naciśnięciu przycisku   [Zapisz] baza Comarch DMS Repozytorium zostaje dodana i w ramach instalatora wyświetla się informacja „ Baza danych została utworzona”.

Następnie operator powinien nacisnąć przycisk [Zmień hasło].

W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser serwera MongoDB, za którego pośrednictwem będzie odbywać się komunikacja aplikacji Comarch DMS Repozytorium z bazą danych.

Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

Hasło powinno spełniać następujące warunki:

Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk   [Zapisz], okno zmiany hasła dla MongoUsera zostaje zamknięte, a hasło użytkownika MongoUser zostaje zmienione. Następnie operator powinien kliknąć  [Dalej].

Po kliknięciu w przycisk  [Dalej] następuje przejście do okna „Klucze licencji”. Operator powinien uzupełnić:

Po uzupełnieniu pól operator powinien kliknąć [Instaluj]. Następuje wówczas przejście do kolejnego okna „Instalacja”.

Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji. Gdy użytkownik kliknie przycisk   [Zakończ], instalator zostanie zamknięty, natomiast zostanie otwarta przeglądarka na ekranie logowania do nowej aplikacji WEB Comarch DMS, zgodnie z nazwą aplikacji, którą wybrano w instalatorze.

Dalsze kroki dotyczące konfiguracji Comarch DMS Repozytorium należy wykonać w ramach aplikacji desktop Comarch DMS, a następnie w zakładce [Repozytorium] w aplikacji web Comarch DMS.

Aktualizacja aplikacji Comarch DMS i Comarch DMS Repozytorium

Aby zaktualizować aplikacje Comarch DMS i Comarch DMS Repozytorium, należy przejść do katalogu <wybrana lokalizacja/Comarch DMS 2024.2.0\Comarch DMS 2024.2.0 instalator Comarch DMS i uruchomić plik Instalator Comarch DMS.exe na komputerze, na którym zainstalowano aplikacje Comarch DMS i Comarch DMS Repozytorium, które mają zostać zaktualizowane.

Po przejściu kolejnych kroków instalacji analogicznie jak w poprzedniej wersji instalatora operator powinien wybrać opcję „Aktualizacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium” w ramach okna „Wybór aplikacji”, a następnie kliknąć [Dalej].

W takim przypadku kolejne kroki instalacji aż do okna Baza danych Comarch DMS (tryb pracy Comarch DMS Standalone)/ Baza danych Comarch ERP XL (tryb pracy Współpraca z Comarch ERP XL)/Firmowa baza danych Comarch ERP Optima (tryb pracy Współpraca z Comarch ERP Optima) pozostają bez zmian w stosunku do poprzedniego instalatora Comarch DMS, z wyjątkiem zmiany warunków do silnego hasła oraz komunikatów w oknie Baza danych Comarch DMS, Baza danych Comarch ERP XL, Konfiguracyjna baza danych Comarch ERP Optima, Firmowa baza danych Comarch ERP Optima (zob.Zmiany warunków do silnego hasła oraz komunikatów dotyczących błędnego hasła w instalatorze Comarch DMS).

Po kliknięciu przycisku [Dalej] w ramach okna Baza danych Comarch DMS (tryb pracy Comarch DMS Standalone)/ Baza danych Comarch ERP XL (tryb pracy Współpraca z Comarch ERP XL)/ Firmowa baza danych Comarch ERP Optima (tryb pracy Współpraca z Comarch ERP Optima) następuje przejście do dodanego w wersji 2024.2.0 okna „Aktualizacja aplikacji Repozytorium”

W ramach okna „Aktualizacja aplikacji Repozytorium” znajdują się następujące pola:

Następnie należy kliknąć [Dalej], aby przejść do kolejnego okna.

Następnie w ramach okna „Baza danych Comarch DMS Repozytorium” operator powinien uzupełnić:

Następnie należy sprawdzić poprawność wprowadzonych danych, klikając w przycisk [Połącz].

Jeśli próba nawiązania połączenia zakończyła się powodzeniem, w dolnej części okna wyświetlony zostaje napis „Nawiązano połączenie z serwerem MongoDB”.

Jeśli nawiązano połączenie z serwerem MongoDB, wówczas w ramach pola „Lista baz danych” wybrana jest baza Comarch DMS Repozytorium odpowiednia dla danej aplikacji.

Nastepnie, opcjonalnie, operator może zmienić hasło dla użytkownika MongoUser, klikając przycisk [Zmień hasło].

W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser, dodanego do serwera MongoDB podczas pierwszej instalacji danej aplikacji Comarch DMs Repozytorium. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

Hasło powinno spełniać następujące warunki:

Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk   [Zapisz], okno zmiany hasła dla MongoUsera zostaje zamknięte, a hasło użytkownika MongoUser zostaje zmienione. Następnie operator powinien kliknąć  [Dalej].

Po kliknięciu w przycisk  [Dalej] następuje przejście do okna „Klucze licencji”. W ramach okna dostępne są następujące pola:

Po uzupełnieniu pól operator powinien kliknąć [Instaluj]. Następuje wówczas przejście do kolejnego okna „Aktualizowanie”.

Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji. Gdy użytkownik kliknie przycisk   [Zakończ], instalator zostanie zamknięty, natomiast zostanie otwarta przeglądarka na ekranie logowania do nowej aplikacji WEB Comarch DMS, zgodnie z nazwą aplikacji, którą podano w instalatorze.

Zmiany warunków do silnego hasła oraz komunikatów dotyczących błędnego hasła w instalatorze Comarch DMS

W wersji 2024.2.0 w instalatorze Comarch DMS uległy zmianie warunki do silnego hasła oraz komunikaty dotyczące błędnego hasła w ramach następujących okien:

Podobnie jak w przypadku wcześniejszych instalatorów, po kliknięciu przycisku [Zmień hasło] w otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika ODUser, dodanego do serwera SQL podczas pierwszej instalacji Comarch DMS. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

Od wersji 2024.2.0 hasło powinno spełniać następujące warunki:

Jeżeli wpisano hasło, które nie spełnia któregoś z tych trzech wymagań lub nie jest jednakowe w polach „Hasło” i „Powtórz hasło”, wówczas po kliknięciu przycisku   [Zapisz] hasło nie zostaje zapisane, a zamiast dotychczasowych komunikatów odpowiednie informacje są wyświetlane w dolnej części okna:

Uwaga

Należy pamiętać, aby na zakładce „Schemat obiegu” na  etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#”  przy danej kontrolce i  aby zapisać wszystkie wprowadzone zmiany  za pomocą przycisku [Zapisz] .

Kontrolka „Kontrahent” posiada identyfikatory numeryczne i tekstowe.

Jeżeli kontrolka współpracuje z systemem ERP: XL, Altum, Optima, domyślnie ustawiany jest identyfikator numeryczny (Id).

W przypadku współpracy z systemem CEE używane są identyfikatory tekstowe (IdText).

 Globals.MainFrame.ERPContractor1.Id = 1;

Globals.MainFrame.ERPContractor1.IdText = "C14ECF1A-3076-45BC-9A86-12A116A40161";

Globals.MainFrame.String2.Text = Globals.MainFrame.ERPContractor1.Shortcut;

Uwaga

Należy pamiętać, aby na zakładce „Schemat obiegu” na  etapie, na którym ma się odbyć inicjalizacja, na zakładce „Kontrolki” zaznaczyć parametr „Inicjalizacja SQL/C#”  przy danej kontrolce i  aby zapisać wszystkie wprowadzone zmiany  za pomocą przycisku [Zapisz] .

Kontrolka „Dokument elektroniczny” posiada identyfikatory numeryczne i tekstowe.

Jeżeli kontrolka współpracuje z systemem ERP: XL, Altum, Optima, domyślnie ustawiane są identyfikatory numeryczne.

W przypadku współpracy z systemem CEE używane są identyfikatory tekstowe.

Przyklad

Przykład 1:

Zainicjowanie kontrolki dokumentem ERP o identyfikatorze 5024 i typie 1521:

Globals.MainFrame.ERPDocument1.Id = 5024; Globals.MainFrame.ERPDocument1.IdType = 1521;

 

Poniższy film przedstawia zainicjowanie kontrolki typu Dokument elektroniczny podczas tworzenia nowego dokumentu:

 

Film

Podczas dodawania nowego dokumentu dokument o zdefiniowanym id i należący do wybranego typu zostaje automatycznie dodany do kontrolki typu Dokument elektroniczny:

 

Globals.MainFrame.ERPDocument1.IdText = "E97B3CE0-F719-44CD-A473-54A59ABF20D5"; 
Globals.MainFrame.ERPDocument1.IdTextType = "3EEC4A14-8263-4196-B721-CE7A61C12F45"; 
Globals.MainFrame.ERPDocument1.IdTextCategory = "2C755635-6E2F-4995-A0DA-2A2257FAC2F9";

 Globals.MainFrame.String1.Text=Globals.MainFrame.ERPDocument1.Number;

Od wersji 2024.0.2 możliwe jest wskazanie identyfikatora connection stringa za pomocą kodu C#, aby określić  connection string, na podstawie którego będzie następowało połączenie do bazy danych. Jeżeli:

• <add key=”MultiCompany” value=”false” /> – wówczas connection stringi strConnectERPComp i strConnectERPConf1 są przechowywane w pliku Web.config
• <add key=”MultiCompany” value=”true” /> – wówczas connection stringi są przechowywane  w pliku Web.config i w tabeli do.DF_ConfCMDictionary – w tym przypadku connection stringi do baz: konfiguracyjnej i firmowej są zapisywane pod jednym ID połączenia, zastosowano zatem nastepujące identyfikatory:
  • nazwa_spółki_Comp – pobiera connection string zapisany w kolumnie CMD_ConnectionStringERP / CMD_ConnectionStringERPEncrypted
  • nazwa_spółki_Conf – pobiera connection string zapisany w kolumnie CMD_ConnectionStringERPConf / CMD_ConnectionStringERPConfEncrypted

 

gdzie nazwa_spółki – wartość wprowadzona w polu „Nazwa spólki” / „Nazwa spółki (baza)” na zakładce  „Połączenia z ERP” na zakładce [Ustawienia]

 

 

 

Identyfikatory connection stringów są wykorzystywane w kodzie C#:

• • dla MS SQL:
    • connection = new DmsSqlConnection(Globals.Common.ConnectionStrings.strConnectDMS)
    • DmsSqlCommand command = new DmsSqlCommand(connection, sqlQuery)
  • dla PostgreSQL:
    • connection = new DmsNpgsqlConnection(„pgStrConnectDMS”)
    • DmsNpgsqlCommand command = new DmsNpgsqlCommand(connection, sqlQuery)

Informacje podstawowe

Skrypty C# zostały wykorzystane w kontrolkach typu Własna akcja i Komunikat. Skrypt dla kontrolki typu własna akcja utworzono na podstawie wzorca API XL

Konfiguracja typu obiegu

Przykład pokazuje, w jaki sposób administrator Comarch DMS może skonfigurować definicję obiegu, aby generować dokument „Faktura zakupu” do systemu Comarch ERP XL, bez pomocy kontrolki typu Dokument ERP XL. W tym celu należy:

1. dodać nowy typ obiegu w ramach zakladki  [Definicje obiegów dokumentów] 

2. nadać nazwę typowi obiegu – np. Generowanie faktury zakupu i prefix – np. GEN

3. nadać danemu administratorowi uprawnienie do inicjowania dokumentu na zakładce „Ustawienia obiegu” w sekcji „Uprawnienia do inicjowania dokumentu”

4. W ramach zakładki „Schemat obiegu” utworzyć etap początkowy „Generuj dokument” i etap końcowy „Koniec” oraz dodać uprawnienie dla danego administratora do etapów.

5. W ramach zakładki „Karta obiegu” dodać następujące kontrolki:

 A Kontrolka typu Kontrahent – „Kontrahent” (identyfikator: Kontrahent)

B  Kontrolka typu Dane tabelaryczne – „Elementy” (identyfikator: Elementy) – w ramach kontrolki należy:

• • w zakładce „Listy” dodać następujące listy:
    • „Jm” z wartością „Jednostki miary” w polu „Inicjowanie”
    • „VAT” z wartością „Stawki VAT” w polu „Inicjowanie”

 

• • w zakładce „Ogólne” dodać następujące kolumny:
    • kolumna typu Towar – „Towar” (identyfikator: Towar)
    • kolumna typu Liczba stałoprzecinkowa – „Ilość” (identyfikator: Ilosc)
    • kolumna typu Lista – „Jm.” (identyfikator: Jm) z wartością „Jm” wybraną w polu „Listy”
    • kolumna typu Lista – „VAT” (identyfikator: VAT) z wartością „VAT” wybraną w polu „Listy”
    • kolumna typu Liczba stałoprzecinkowa –  „Cena netto” (identyfikator: CenaNetto)
    • kolumna typu  Liczba stałoprzecinkowa – „Cena brutto” (identyfikator: CenaBrutto)
    • kolumna typu  Liczba stałoprzecinkowa – „Wartość Netto” (identyfikator: WartoscNetto)
    • kolumna typu  Liczba stałoprzecinkowa – „Wartość Brutto” (identyfikator: WartoscBrutto)

 

 

• • w zakładce „Inicjowanie wartości” :
    • w ramach pola „Kontrolki powiązane” kliknąć przycisk „Dodaj” i wybrac kontrolkę „Elementy”
    • w ramach pola „Wzór na wartość” wybrać opcję „SQL OD”, kliknąć „Ustaw”, a następnie wprowadzić następujące zapytanie:

 if  @^InitSenderControlName@ = 'Elementy'
Begin
    
    declare @vat decimal(22,4) = 0.0
    declare @netto decimal (22,4) = 0.0
    declare @brutto decimal (22,4) = 0.0
    declare @ilosc decimal (22,4) = 0.0
    
    if  @Elementy_Column@ in (2,4,5)
    Begin
        select @netto = CenaNetto, @ilosc = Ilosc from  @Elementy@ 
where POS = @Elementy_Row@ 
        select @vat = case 
            when VAT = 1 then 23
            when VAT = 2 then 8
            when VAT = 3 then 0
            when VAT = 4 then 0
            when VAT = 5 then 0
            when VAT = 6 then 7
            when VAT = 7 then 5
            else 0 end
        from  @Elementy@ where POS = @Elementy_Row@ 
        set @brutto = ((@netto*@vat)/100)+@netto
        
        update @Elementy@ set CenaBrutto = @brutto, WartoscBrutto = @ilosc * @brutto, 
        WartoscNetto = @ilosc * @netto where POS = @Elementy_Row@  
        select * from  @Elementy@ 
    End

    if @Elementy_Column@  = -1
    Begin
        update @Elementy@ set Ilosc = 1, JM = 1, VAT = 1 
        where POS = @Elementy_Row@  
        select * from  @Elementy@ 
    End
End

 

Wprowadzone zapytanie należy zapisać, klikając w przycisk „Zapisz” w oknie „Wyrażenie kontrolki”

 

 

 

• • w zakładce „Ograniczenie Edycji” zaznaczyć checkboxy na obydwóch etapach dla kolumn: „Cena netto”, „Cena brutto”, „Wartość Netto”, „Wartość Brutto”

C kontrolka typu Własna akcja – „Generuj dokument” (identyfikator: GenerujDokument) – w ramach definicji kontrolki należy kliknąć w link „Ustaw” w polu „C# Script”, następnie w otwartym oknie „Skrypt C#” w polu „Miejsce wykonania skryptu” wybrać „Proces (exe)” (jeśli istnieje opcja wyboru) i wprowadzić następujący kod:

using System.Threading;
using System.Runtime.InteropServices;
using cdn_api;


static ThreadLocal<bool> threadToClarionAttached = new ThreadLocal<bool>(() => false);

[DllImport("ClaRUN.dll")]
private static extern void AttachThreadToClarion(int flag);
public void AttachThreadToClarion()
{
    try
    {
        if (!threadToClarionAttached.Value)
        {
            AttachThreadToClarion(1); // C8
            threadToClarionAttached.Value = true;
        }
    }
    catch (DllNotFoundException ex)
    {
    // -----------------------------------------------------------------
    // Tu przekaż informacje o statusie działania skryptu
    // -----------------------------------------------------------------
    Globals.MainFrame.GenerujDokument_CSSCRIPT.Text = ex.Message;
    }
}


AttachThreadToClarion();

int _lSesjaID = 0;
string blad = "";

try
{
    int documentId = 0;
    int wersjaApi = odpowiedniawersjaapi;
    
    var loginInfo = new XLLoginInfo_odpowiedniawersjaapi()
    {
        Wersja = odpowiedniawersjaapi,
        ProgramID = "Comarch DMS",
        Winieta = -1,
        TrybWsadowy = 1,
        Baza = "nazwafirmy",
        OpeIdent = "Login",
        OpeHaslo = "hasło",
        SerwerKlucza = @"serwerklucza"
    };
    
    var XLLoginResult = cdn_api.cdn_api.XLLogin(loginInfo, ref _lSesjaID);
    if (XLLoginResult != 0)
    {
        blad = "Funkcja XLLogin zwróciła bład nr: " + XLLoginResult;
        throw new Exception();
    }
    
    // -----------------------------------------------------------------
    // Tu dodaj kod obsługi API
    // -----------------------------------------------------------------
    
    var dokumentNagInfo = new XLDokumentNagInfo_odpowiedniawersjaapi
    {
        Wersja = odpowiedniawersjaapi,
        Typ = 1521,//FZ
        KntTyp = 32,
        KntNumer = Globals.MainFrame.Kontrahent.Id ?? 0, // Pobierz GidNumer kontrahenta
        RodzajZakupu = 1,
        //Avista = 1
    };

    var XLNowyDokumentResult = cdn_api.cdn_api.XLNowyDokument (_lSesjaID, ref documentId, dokumentNagInfo);
    if (XLNowyDokumentResult != 0)
    {
        blad = "Funkcja XLNowyDokument zwróciła bład nr: " + XLNowyDokumentResult;
        throw new Exception();
    }
    
    //var element;
    
    for (int i=0; i<Globals.MainFrame.Elementy.RowCount; i++)
    {

        var element = new XLDokumentElemInfo_odpowiedniawersjaapi();
        
        element.Wersja = odpowiedniawersjaapi;
        element.TwrTyp = 16;
        element.Ilosc = Globals.MainFrame.Elementy.Items[i].Ilosc.Value.ToString();
        element.TwrNumer = Globals.MainFrame.Elementy.Items[i].Towar.Id;
        element.JmZ = Globals.MainFrame.Elementy.Items[i].Jm.Text;
        element.Cena = Globals.MainFrame.Elementy.Items[i].CenaNetto.Value.ToString();
    
        
        var XLDodajPozycjeResult = cdn_api.cdn_api.XLDodajPozycje(documentId, element);
        if (XLDodajPozycjeResult != 0)
        {
            blad = "Funkcja XLDodajPozycje zwróciła bład nr: " + XLDodajPozycjeResult;
            throw new Exception();
        }        
    }
    
    var zamkniecieDokumentuInfo = new XLZamkniecieDokumentuInfo_odpowiedniawersjaapi
    {
        Wersja = odpowiedniawersjaapi,
        Tryb = 1
    };
    
    var XLZamknijDokumentResult = cdn_api.cdn_api.XLZamknijDokument(documentId, zamkniecieDokumentuInfo);
    if (XLZamknijDokumentResult != 0)
    {
        blad = "Funkcja XLZamknijDokument zwróciła bład nr: " + XLZamknijDokumentResult;
        throw new Exception();
    }    
    
}
catch (Exception ex)
{
    if (blad == "")
        blad = "Nieokreślony błąd: " + ex.Message;
}
finally
{
    var XLLogoutResult = cdn_api.cdn_api.XLLogout(_lSesjaID);
    if (XLLogoutResult != 0)
    {
        blad = "Funkcja XLLogout zwróciła bład nr: " + XLLogoutResult;
    }
    // -----------------------------------------------------------------
    // Tu przekaż informacje o statusie działania skryptu
    // -----------------------------------------------------------------
    if ( blad == "")
        Globals.MainFrame.GenerujDokument_CSSCRIPT.Text = "Operacja zakończona sukcesem.";
    else
        Globals.MainFrame.GenerujDokument_CSSCRIPT.Text = blad;
}

gdzie należy zmienić następujące wartości:

odpowiedniawersjaapi – wersja API ERP XL zgodna z wersją pliku cdn_api[wersja].net.dll

nazwafirmy – nazwa Firmy Comarch ERP XL (nazwę firmy można sprawdzić w managerze baz Comarch ERP XL)

Login – login operatora Comarch ERP XL

hasło – hasło operatora Comarch ERP XL

serwerklucza – serwer klucza licencji

Po wprowadzeniu kodu należy nacisnąć przycisk [Kompiluj i zapisz], a następnie, gdy w dolnej części okna zostanie wyświetlony napis „Kompilacja skryptu zakończyła się sukcesem” nacisnąć przycisk „Zamknij”.

D Kontrolka typu Komunikat – należy w ramach pola:

• • „Nazwa (identyfikator)” wprowadzić nazwę „Msg1”
  • „Tytuł” wprowadzić tekst „Status wykonania API ERP XL”
  • „Kontrolki powiązane” kliknąć w link „Dodaj” i wybrać kontrolkę „Generuj dokument”
  • „Wzór na wartość” wybrać wartość „C# Script”, kliknąć „Ustaw”, a następnie wprowadzić następujący kod:

 Globals.MainFrame.Msg1.Message = Globals.MainFrame.GenerujDokument_CSSCRIPT.Text;

Po wprowadzeniu kodu należy nacisnąć przycisk [Kompiluj i zapisz], a następnie, gdy w dolnej części okna zostanie wyświetlony napis „Kompilacja skryptu zakończyła się sukcesem” nacisnąć przycisk „Zamknij”.

6. zapisać typ obiegu za pomocą przycisku [Zapisz]

Generowanie dokumentu FZ do Comarch ERP XL – jak działa

Po zdefiniowaniu typu obiegu operator przechodzi na zakładkę [Dokumenty], klika na typ obiegu „Generowanie faktury zakupu” i naciska przycisk [Dodaj]. Następnie kolejno:

1. zapisuje nowy dokument, naciskając [Zapisz]

2. wybiera kontrahenta w ramach kontrolki „Kontrahent”

3. w ramach kontrolki „Elementy” dodaje towar w kolumnie „Towar”, wybiera opcję w kolumnach „Jm.” i „VAT” oraz wpisuje wartość w kolumnie „Cena netto” (jeśli poprawnie skonfigurowano obieg, wówczas kolumny „Cena brutto”, „Wartość Netto” i „Wartość Brutto” powinny zostać uzupełnione automatycznie)

4. naciska przycisk „Generuj dokument” – wówczas następuje generowanie dokumentu – poniżej przycisku widoczne są poruszające się punkty

5. Jeśli generowanie dokumentu zakończyło się powodzeniem, wówczas na środku ekranu wyświetlany jest następujący komunikat:

Film

Aby zobaczyć przebieg generowania dokumentu do Comarch ERP XL, kliknij w poniższy film:

 

 

Wygenerowany dokument jest już widoczny w Comarch ERP XL:

 

Informacje podstawowe

Skrypty C# zostały wykorzystane w kontrolkach typu Własna akcja i Komunikat. Skrypt dla kontrolki typu własna akcja utworzono na podstawie wzorca API XL

Konfiguracja typu obiegu

Przykład pokazuje, w jaki sposób administrator Comarch DMS może skonfigurować definicję obiegu, aby zatwierdzić dokument „Faktura zakupu” w systemie Comarch RP XL z poziomu Comarch DMS. W tym celu należy:

1. dodać nowy typ obiegu w ramach zakladki  [Definicje obiegów dokumentów] 

2. nadać nazwę typowi obiegu – np. Zatwierdzanie faktury zakupu i prefix – np. ZAT

3. nadać danemu administratorowi uprawnienie do inicjowania dokumentu na zakładce „Ustawienia obiegu” w sekcji „Uprawnienia do inicjowania dokumentu”.

4. W ramach zakładki „Schemat obiegu” utworzyć etap początkowy „Zatwierdzanie dokumentu” i etap końcowy „Koniec” oraz dodać uprawnienie dla danego administratora do etapów.

5. W ramach zakładki „Karta obiegu” dodać następujące kontrolki:

 A Kontrolka typu Dokument elektroniczny – „Faktura zakupu” (identyfikator: FakturaZakupu) – w polu „Typ” należy wybrać „Faktura zakupu”

B kontrolka typu Własna akcja – „Zatwierdź dokument” (identyfikator: ZatwierdzDokument) – w ramach definicji kontrolki należy kliknąć w link „Ustaw” w polu „C# Script”, następnie w otwartym oknie „Skrypt C#” w polu „Miejsce wykonania skryptu” wybrać „Proces (exe)” (jeśli istnieje opcja wyboru) i wprowadzić następujący kod:

using System.Threading;
using System.Runtime.InteropServices;
using cdn_api;


static ThreadLocal<bool> threadToClarionAttached = new ThreadLocal<bool>(() => false);

[DllImport("ClaRUN.dll")]
private static extern void AttachThreadToClarion(int flag);
public void AttachThreadToClarion()
{
    try
    {
        if (!threadToClarionAttached.Value)
        {
            AttachThreadToClarion(1); // C8
            threadToClarionAttached.Value = true;
        }
    }
    catch (DllNotFoundException ex)
    {
    // -----------------------------------------------------------------
    // Tu przekaż informacje o statusie działania skryptu
    // -----------------------------------------------------------------
    //Globals.MainFrame.ZatwierdzDokument_CSSCRIPT.Text = ex.Message;
    Globals.MainFrame.ZatwierdzDokument_CSSCRIPT.Text=ex.Message;
    }
}


AttachThreadToClarion();

int _lSesjaID = 0;
string blad = "";

try
{
    int documentId = 0;
    int wersjaApi = odpowiedniawersjaapi;
    
    var loginInfo = new XLLoginInfo_odpowiedniawersjaapi()
    {
        Wersja = odpowiedniawersjaapi,
        ProgramID = "Comarch DMS",
        Winieta = -1,
        TrybWsadowy = 1,
        Baza = "nazwafirmy",
        OpeIdent = "Login",
        OpeHaslo = "hasło",
        SerwerKlucza = @"serwerklucza"
    };
    
    var XLLoginResult = cdn_api.cdn_api.XLLogin(loginInfo, ref _lSesjaID);
    if (XLLoginResult != 0)
    {
        blad = "Funkcja XLLogin zwróciła bład nr: " + XLLoginResult;
        throw new Exception();
    }
    
    // -----------------------------------------------------------------
    // Tu dodaj kod obsługi API
    
                var otworzDocumentInfo = new XLOtwarcieNagInfo_odpowiedniawersjaapi
                {
                    Wersja = odpowiedniawersjaapi,
                    GIDTyp = 1521,
                    GIDNumer = Globals.MainFrame.FakturaZakupu.Id ?? 0,
                    Tryb = 2

                };

                var XLOtwarcieInfoResult = cdn_api.cdn_api.XLOtworzDokument(_lSesjaID, ref documentId, otworzDocumentInfo);
                if (XLOtwarcieInfoResult != 0)
                {
                    blad = "Funkcja XLOtworzDokument zwróciła bład nr: " + XLOtwarcieInfoResult;
                    throw new Exception();
                }


                var zamkniecieDokumentuInfo = new XLZamkniecieDokumentuInfo_odpowiedniawersjaapi
                {
                    Wersja = odpowiedniawersjaapi,
                    Tryb = 0
                };

                               
                var XLZamknijDokumentResult = cdn_api.cdn_api.XLZamknijDokument(documentId, zamkniecieDokumentuInfo);
                if (XLZamknijDokumentResult != 0)
                {
                    blad = "Funkcja XLZamknijDokument zwróciła bład nr: " + XLZamknijDokumentResult;
                    throw new Exception();
                }
    // -----------------------------------------------------------------
}
catch (Exception ex)
{
    if (blad == "")
        blad = "Nieokreślony błąd: " + ex.Message;
}
finally
{
    var XLLogoutResult = cdn_api.cdn_api.XLLogout(_lSesjaID);
    if (XLLogoutResult != 0)
    {
        blad = "Funkcja XLLogout zwróciła bład nr: " + XLLogoutResult;
    }
    // -----------------------------------------------------------------
    // Tu przekaż informacje o statusie działania skryptu
    // -----------------------------------------------------------------
    
    //Globals.MainFrame.ZatwierdzDokument_CSSCRIPT.Text = blad; 
    if (blad == "")
        Globals.MainFrame.ZatwierdzDokument_CSSCRIPT.Text = "Operacja zakończona sukcesem";
    else 
        Globals.MainFrame.ZatwierdzDokument_CSSCRIPT.Text = blad;
    
}

gdzie należy zmienić następujące wartości:

odpowiedniawersjaapi – wersja API ERP XL zgodna z wersją pliku cdn_api[wersja].net.dll

nazwafirmy – nazwa Firmy Comarch ERP XL (nazwę firmy można sprawdzić w managerze baz Comarch ERP XL)

Login – login operatora Comarch ERP XL

hasło – hasło operatora Comarch ERP XL

serwerklucza – serwer klucza licencji

Następnie należy kliknąć w przycisk [Referencje], znajdujący się w prawym górnym rogu okna „Skrypt C#”, w wpisać tam nazwę odpowiedniego pliku dll:

 cdn_api[odpowiedni numer wersji].net.dll

Następnie należy nacisnąć przycisk  [Zapisz].

Po wprowadzeniu kodu do edytora i nazwy dll w oknie „Referencje”  należy nacisnąć przycisk [Kompiluj i zapisz], a następnie, gdy w dolnej części okna zostanie wyświetlony napis „Kompilacja skryptu zakończyła się sukcesem” nacisnąć przycisk „Zamknij”.

Uwaga

Jeśli w ramach okna „Referencje” po kliknięciu przycisku [Referencje] wprowadzono niewłaściwą nazwę pliku dll, wówczas po naciśnięciu przycisku [Kompiluj i zapisz] w dolnej części okna wyświetlana jest informacja „Assembly not found”.

C Kontrolka typu Komunikat – należy w ramach pola:

 Globals.MainFrame.Message1.Message = Globals.MainFrame.ZatwierdzDokument_CSSCRIPT.Text

Po wprowadzeniu kodu należy nacisnąć przycisk [Kompiluj i zapisz], a następnie, gdy w dolnej części okna zostanie wyświetlony napis „Kompilacja skryptu zakończyła się sukcesem” nacisnąć przycisk „Zamknij”.

6. zapisać typ obiegu za pomocą przycisku [Zapisz].

Zatwierdzanie dokumentu FZ w Comarch ERP XL – jak działa

Po zdefiniowaniu typu obiegu operator przechodzi na zakładkę [Dokumenty], klika na typ obiegu „Zatwierdzanie faktury zakupu” i naciska przycisk [Dodaj]. Następnie kolejno:

1. zapisuje nowy dokument, naciskając [Zapisz]

2. dodaje dokument z Comarch ERP XL w ramach kontrolki „Faktura zakupu”

3. naciska przycisk „Zatwierdź dokument” – wówczas następuje zatwierdzanie dokumentu – poniżej przycisku widoczne są poruszające się punkty

4. Jeśli zatwierdzanie dokumentu zakończyło się powodzeniem, wówczas na środku ekranu wyświetlany jest następujący komunikat:

Uwaga

Jeśli operator w kontrolce „Faktura zakupu” wybierze dokument, który już został zatwierdzony w Comarch ERP XL, i kliknie przycisk „Zatwierdź dokument”, wówczas zostaje wyświetlony następujący komunikat:

 

W wersji 2024.1.1 dodano zakładkę „Raporty” w nowej aplikacji web Comarch DMS.

Uwaga

W przypadku ręcznej instalacji lub aktualizacji nowej aplikacji web Comarch DMS aby dostępny był podgląd raportów i dashboardów, należy w ramach katalogu zawierającego aplikację web (nową aplikację webową) otworzyć do edycji plik web.config i uzupełnić w ramach „WorkflowDashboards” 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.

 

Aby zakładka była widoczna dla danego operatora, musi on mieć przyznane uprawnienie do co najmniej jednego raportu lub dashboardu na zakładce „Uprawnienia” w ramach zakładki [Kreator raportów i dashboardów] w aplikacji desktop.

W ramach otwartego okna Raporty i dashboardy wyświetlana jest lista dashboardów oraz raportów, do których uprawniony jest dany operator.

W górnej części okna dostępna jest wyszukiwarka, za pomocą której operator może wyszukać dashboard lub raport według nazwy lub jej fragmentu.

Lista dashboardów i raportów składa się z trzech kolumn:

Obok każdej kolumny znajduje się przycisk – kiedy operator kliknie ten przycisk kolumny zostaną posortowane alfabetycznie (odrębnie dla dashboardów i raportów predefiniowanych oraz utworzonych przez użytkownika)

Po kliknięciu w nazwę danego dashboardu/raportu w nowym oknie przeglądarki zostaje otwarty podgląd tego dashboardu/raportu.

W przypadku podglądu dashboardu w prawym górnym rogu ekranu dostępny jest przycisk [Export to]. Po kliknięciu w ten przycisk widoczna jest lista formatów, w jakich można eksportować dashboard: [pdf]; [png, gif, jpg]; [xls,xlsx].

Gdy operator wybierze dany format, wówczas zostaje wyświetlone okno z dodatkowymi opcjami eksportu.

Po kliknięciu w przycisk [Export], a następnie „Zapisz jako” operator powinien wybrać lokalizację do zapisu pliku i nacisnąć [Zapisz].

W przypadku podglądu raportu istnieje możliwość wydrukowania raportu po kliknięciu w przycisk . Możliwe jest również zapisanie raportu – w tym celu operator powinien kolejno:

1. kliknąć w pole ;

2. wybrać z listy określony format;

3. nacisnąć , a następnie „Zapisz jako”;

4. wybrać lokalizację, w której raport ma zostać zapisany i kliknąć [Zapisz]