Aplikacje Comarch DMS w wersji 2023.1.0 współpracują z następującymi Systemami Comarch ERP:
Comarch ERP XL – wersje systemu: 2022.1, 2023.0, 2023.1
Comarch ERP Optima – wersje systemu: 2023.1.1, 2023.2.1, 2023.3.1
Comarch ERP Altum – wersje systemu: 2022.1, 2022.5, 2023.0
Comarch ERP Enterprise 6.1 – DMS Integration APP wersja 26.16
Comarch ERP Enterprise 6.2 – DMS Integration APP wersja 35.5
Comarch ERP Enterprise 6.3 – DMS Integration APP wersja 40.1
Dołączanie plików z Repozytorium do dokumentu w obiegu
Uwaga
Od wersji 2023.1.0 aby możliwa była poprawna współpraca z modułem Repozytorium należy zainstalować dodatek Application Request Routing, dostępny pod następującym adresem:
Następnie należy zaznaczyć parametr „Enable proxy” w ramach zakładki „Application Request Routing” na serwerze IIS i potwierdzić zmianę przyciskiem „Zastosuj”.
W wersji 2023.1.0 wprowadzono funkcjonalność dołączania plików z modułu Repozytorium do dokumentu w module Workflow jako załącznik.
W ramach definicji kontrolki typu załącznik możliwe jest włączenie obustronnej integracji modułów Repozytorium i Workflow.
Użytkownik może:
dołączyć wiele dokumentów z modułu Repozytorium do jednego dokumentu w module Workflow;
łączyć wiele dokumentów z modułu Workflow z jednym dokumentem z modułu Repozytorium.
Zmiany w ustawieniach kontrolki typu załącznik
W wersji 2023.1.0 w ramach ustawień kontrolki typu załącznik, na zakładce „Archiwa”, nastąpiła zmiana nazwy parametru „Zapisz do Repozytorium” na „Współpraca z Repozytorium”.
Kiedy checkbox „Współpraca z Repozytorium” zostanie zaznaczony, wówczas możliwe jest:
dodawanie do kontrolki typu załącznik plików z modułu Repozytorium;
przesyłanie plików, które dodano jako załącznik z dysku albo ze skanu do modułu Repozytorium, tak jak do tej pory.
Kiedy parametr „Współpraca z Repozytorium” został zaznaczony, wówczas parametr „Wersjonowanie pliku” na zakładce „Ogólne” nie jest widoczny, zaś na zakładce „Archiwa” (podobnie jak do tej pory) wyświetlane są parametry związane z przesyłaniem dokumentów do modułu Repozytorium, dotyczące typu dokumentu oraz mapowania wartościami z kontrolek atrybutów przypisanych do danego typu w ramach modułu Repozytorium.
Dodawanie załącznika z modułu Repozytorium w aplikacji desktop Comarch DMS
Jeśli użytkownik zaznaczył checkbox „Współpraca z Repozytorium” w ustawieniach kontrolki typu załącznik, wówczas po kliknięciu ikony w ramach danej kontrolki typu załącznik na dokumencie dostępna jest opcja „Z Repozytorium”.
Kiedy użytkownik kliknie na opcję „z Repozytorium”, wówczas zostanie otwarte okno „Dodaj załącznik”, w ramach którego można dokonać wyboru pliku lub plików, które zostaną dodane do danej kontrolki typu załącznik.
Aby dodać dokument z modułu Repozytorium, użytkownik powinien kolejno:
kliknąć w ramach okna „Dodaj załącznik” na folder, w którym znajduje się dokument, który ma zostać dodany do kontrolki typu załącznik;
na liście dokumentów kliknąć w nazwę danego dokumentu, a następnie nacisnąć przycisk [Dodaj].
Wówczas okno „Dodaj załącznik” zostanie zamknięte, a dokument będzie dodany do kontrolki typu załącznik. Użytkownik może na raz zaznaczyć i dodać wiele dokumentów.
Przycisk [Dodaj] pozostaje nieaktywny aż do czasu, kiedy użytkownik zaznaczy przynajmniej jeden dokument.
Uwaga
Użytkownik może dołączyć do dokumentu w module Workflow tylko takie dokumenty, do których posiada dostęp w module Repozytorium.
Uwaga
Nie jest możliwe załączanie folderów z Repozytorium. Jeśli użytkownik chce załączyć wiele plików, wówczas powinien wejść do folderu i zaznaczyć te pliki.
Atrybuty na danym dokumencie dodanym z modułu Repozytorium są mapowane wartościami z pierwszego dokumentu w module Workflow, do którego został dołączony i który nosi nazwę „proces główny”. „Proces główny” posiada oznaczenie „Główny” w sekcji „Powiązane procesy” na prawym panelu dokumentu w module Repozytorium (zob. artykuł Dodanie oznaczenia „Główny” w sekcji „Procesy powiązane z dokumentem”).
Nad listą dokumentów w oknie „Repozytorium” znajdują się cztery pola służące do filtrowania listy:
Status – w ramach tego pola można wybrać jedną z następujących opcji:
Dowolny – na liście widoczne będą wszystkie dokumenty aktywne i zarchiwizowane z danego folderu
Aktywne – na liście widoczne będą wszystkie aktywne dokumenty z danego folderu
Zarchiwizowane – na liście widoczne będą jedynie dokumenty zarchiwizowane z danego folderu
Data dodania – po kliknięciu na to pole otwierane jest okno, w ramach którego można wybrać zakres dat, w którym dodano dokumenty
Typ dokumentu – po kliknięciu na to pole można wybrać typ/typy dokumentów, z których dokumenty mają być widoczne na liście. Domyślnie zaznaczone są wszystkie dostępne typy.
Więcej filtrów– w ramach tego pola w oknie „Pozostałe filtry” możliwe jest filtrowanie dokumentów według:
Robotyzacja procesów jest dostępna wyłącznie w aplikacji desktop Comarch DMS.
Dostęp do konfiguracji
Dodanie uprawnienia do konfiguracji automatycznego trybu na karcie pracownika
Od wersji 2023.1.0 w ramach zakładki [Struktura organizacyjna], w sekcji „Pracownicy”, po kliknięciu na danego pracownika, na zakładkę „Uprawnienia”, a następnie na sekcję „Funkcjonalności” dostępne jest nowe pole „Konfiguracja automatycznego trybu pracy”. Wybranie wartości „Tak” i zapisanie zmiany znakiem dyskietki pozwala na pracę z zakładką [Konfiguracja automatycznego trybu pracy].
Dodanie klucza „RPAFolderPath” w pliku dms.exe.config
W wersji 2023.1.0 w pliku dms.exe.config znajdującym się w folderze z aplikacją desktop Comarch DMS dodano klucz „RPAFolderPath”. Wpisanie poprawnej wartości w ramach tego klucza jest konieczne, 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 DMS, np. C:\dms202310.
Konfiguracja
Nowa zakładka „Konfiguracja automatycznego trybu pracy” i tworzenie skryptu
W wersji 2023.1.0 została dodana nowa zakładka [Konfiguracja automatycznego trybu pracy] , dostępna w menu głównym aplikacji desktop Comarch DMS nad ikoną panelu użytkownika . Służy ona do konfiguracji robotyzacji.
Zakładka [Konfiguracja automatycznego trybu pracy] jest dostępna w menu głównym aplikacji desktop Comarch DMS jedynie wtedy, gdy danemu operatorowi nadano uprawnienie do tej zakładki na karcie pracownika (zob. Dodanie nowego pola „Konfiguracja automatycznego trybu pracy” na karcie pracownika w tym artykule). Jeżeli takie uprawnienie nie zostało przyznane, wówczas zakładka nie jest widoczna dla pracownika.
Po pierwszym przejściu na zakładkę [Konfiguracja automatycznego trybu pracy] widoczne jest puste okno ze zwiniętym panelem „Skrypty” .
Aby uruchomić automatyczny tryb pracy, należy dodać nową pozycję, naciskając przycisk [Dodaj] w ramach zakładki [Konfiguracja automatycznego trybu pracy]. Wówczas zostanie dodany nowy program z predefiniowaną nazwą „Nazwa programu 1” (możliwą do edycji). W ramach okna widoczne są dwie zakładki:
Edytor skryptów
Uprawnienia
W ramach zakładki „Edytor skryptów” użytkownik może utworzyć skrypt automatyzujący. Na zakładce znajdują się następujące elementy:
Pole „Nazwa programu” – w tym polu znajduje się predefiniowana nazwa programu; użytkownik może wpisać zamiast niej własną nazwę
[Kompiluj i zapisz] – przycisk, po naciśnięciu którego następuje kompilacja utworzonego skryptu i zapis programu
[Referencje] – przycisk, po kliknięciu którego zostanie otwarte okno, w którym użytkownik może wpisać nazwę biblioteki
Okno edytora skryptów – w ramach tego okna należy wprowadzić zapytanie w języku C#
Metody konfiguracji
Na zakładce „Edytor skryptów” możliwe jest korzystanie z następujących metod:
w ramach klasy ACD:
GenerateDMSDocuments (int) – metoda umożliwia wciśnięcie przycisku „Generuj” na zakładce „Automatyczne generowanie dokumentów”.
zwraca wyniki:
0 – operacja została wykonana poprawnie
-1 – kiedy wystąpił błąd
Wskazówka
Int GenerateDMSDocuments()
Return: 0 – ok, -1 – error
GetDocumentList – metoda umożliwia pobranie informacji o zaczytanych dokumentach
Zwraca wyniki:
0 – operacja została wykonana poprawnie
-1 – wystąpił błąd
Wskazówka
Int GetDocumentList(ref ACDDocument[])
Struct ACDDocument
(
string Name,
byte Status
)
Name: document name
Status: 0 – correct, 1 – incorrect
Return: 0 – ok, -1 – error
GetNumberItems (ref long) – metoda, która sprawdza liczbę pobranych dokumentów w punkcie ACD
brak parametrów wejściowych
zwraca wyniki:
Liczba pobranych dokumentów
0 – operacja została wykonana poprawnie
-1 – kiedy metoda została wywołana w niewłaściwym kontekście
Wskazówka
int GetNumberItems(ref long)
long: number of documents
return: 0 – ok, -1 – error
RefreshList() – metoda umożliwia wciśnięcie przycisku „Odśwież” na zakładce „Automatyczne generowanie dokumentów”
brak parametrów wejściowych
zwraca wyniki:
0 – operacja została wykonana poprawnie
-1 – kiedy wystąpił błąd
Wskazówka
Int RefreshList()
return: 0 – ok, -1 – error
SelectDocument (int) – metoda, która umożliwia podświetlenie dokumentu na liście (jeżeli lista prezentuje dokumenty z checkboxami – zaznaczenie checkboxa).
Parametry wejściowe:
Identyfikator dokumentu
Zwraca wyniki:
0 – operacja została wykonana poprawnie
-1 – wystąpił błąd
Wskazówka
int SelectDocument(int)
int: document index
return: 0 – ok, -1 – error
SetPoint (string,byte) – metoda, która odpowiada za wskazanie punktu ACD i włączenie lub wyłączenie automatycznego wysyłania dokumentów do Comarch OCR
Parametry wejściowe:
Pierwszy parametr jest wymagany, należy wprowadzić w nim nazwę punktu ACD, w ramach którego będzie się odbywało przetwarzanie dokumentów
Drugi parametr jest opcjonalny, dotyczy kwestii włączenia procesowania dokumentów w punkcie ACD, przyjmuje następujące wartości:
0 – procesowanie dokumentów jest wyłączone (dotyczy punktów ACD, które nie obsługują OCR)
1 – procesowanie dokumentów jest włączone
Zwraca wyniki:
0 – operacja została wykonana poprawnie
-1 – kiedy wystąpił błąd
-2 – kiedy punkt ACD o podanej nazwie nie istnieje
Wskazówka
int SetPoint(string,byte)
string: ACD point name
byte:1 -turn on ACD proces, 0 – turn off ACD proces
return: 0 – ok, – 1 – error, -2 – ACD point not exists
SetViewMode (byte) – metoda, która odpowiada za tryb filtrowania pobranych dokumentów
1 – operator nie jest uprawniony do okna ACD – jeśli ta wartość została zwrócona, w aplikacji zostaje wyświetlony komunikat „Operator nie posiada uprawnień do automatycznego generowania dokumentów”
Wskazówka
int Show()
return: 0 – ok, -1 – error
W ramach klasy Common
Trace(string) – metoda umożliwia wyświetlanie dodatkowych informacji na oknie „Automatyczny tryb pracy”,
Wskazówka
void Trace(string)
string:message
Przykład:
Globals.Common.Trace(„Trwa procesowanie dokumentów dla punktu: \”Faktury od Firmy C\””);
Dostęp do uruchamiania programu
W ramach zakładki „Uprawnienia” zostają zdefiniowane uprawnienia operatorów do uruchamiania skryptów.
Uprawnienia dla każdego utworzonego programu są nadawane oddzielnie.
Na zakładce dostępne są następujące pola:
Nazwa spółki – pole dostępne jedynie w trybie wielospółkowym Comarch DMS; należy w nim dokonać wyboru spółki, z której pochodzi operator, któremu mają zostać nadane uprawnienia;
Typ – w ramach tego pola możliwy jest wybór pracownika, działu lub stanowiska, dla którego mają zostać przyznane uprawnienia do danego programu;
Wartość – w zależności od wyboru dokonanego w polu „Typ” w ramach tego pola można wybrać danego pracownika/dział/ stanowisko, któremu zostaną przyznane uprawnienia do danego programu.
Po nadaniu uprawnień należy zapisać zmiany, klikając na przycisk [Zapisz]. Wówczas operator zostaje przeniesiony na zakładkę „Edytor skryptów”, a w prawym górnym rogu okna „Konfiguracja automatycznego trybu pracy” pojawia się przycisk [Uruchom], służący do uruchomienia programu.
Ikona [Uruchom] jest widoczna:
Na zakładce [Dokumenty] – dla każdego użytkownika, któremu przyznano uprawnienia do co najmniej jednego programu
W ramach okna „Konfiguracja automatycznego trybu pracy”, dla operatora, któremu przyznano uprawnienia do co najmniej jednego programu
Uruchomienie programu
Po dodaniu uprawnień do programu w zakładce „Uprawnienia” oraz po utworzeniu skryptu w ramach zakładki „Edytor skryptów”, skompilowaniu go za pomocą przycisku [Kompiluj i zapisz] i zapisaniu zmian za pomocą ikony [Zapisz] należy kliknąć przycisk [Uruchom], dostępny z poziomu listy dokumentów lub zakładki [Konfiguracja automatycznego trybu pracy].
Następnie w ramach otwartego okna „Uruchom program” operator powinien wybrać odpowiedni program i nacisnąć przycisk [Uruchom] – wówczas okno „Uruchom program” zostanie zamknięte, a otworzy się okno „Automatyczny tryb pracy” i wybrany program rozpocznie działanie.
Aby zakończyć działanie programu, należy kliknąć przycisk [Zatrzymaj program], znajdujący się w dolnej części okna. Jeżeli w oknie „Uruchom program” zaznaczono checkbox „Zabezpiecz hasłem”, wówczas zatrzymanie pracy programu będzie wymagało podania hasła zalogowanego operatora w otwartym oknie i ponownego naciśnięcia przycisku [Zatrzymaj program].
Przykład konfiguracji i uruchomienia programu
Administrator otworzył do edycji plik DMS.exe.config, znajdujący się w folderze z aplikacją desktop Comarch DMS i w ramach klucza „RPAFolderPath” wprowadził ścieżkę do aplikacji desktop Comarch DMS – w tym przypadku <add key=”RPAFolderPath” value=”C:\dms202310″/> – a później zapisał zmianę.
Administrator dodał na zakładce [Automatyczne generowanie dokumentów] trzy punkty ACD należące do typu „Współpraca z Comarch OCR” o następujących nazwach:
Faktury od Firmy A (zgodnie z ustawieniami punktu dokumenty wygenerowane w tym punkcie mają trafiać do obiegu „Faktury – firma A”)
Faktury od Firmy B (zgodnie z ustawieniami punktu dokumenty wygenerowane w tym punkcie mają trafiać do obiegu „Faktury – firma B”)
Faktury od Firmy C (zgodnie z ustawieniami punktu dokumenty wygenerowane w tym punkcie mają trafiać do obiegu „Faktury – firma C”)
Następnie administrator przeszedł na zakładkę [Konfiguracja automatycznego trybu pracy] i kliknął przycisk [Dodaj].
Na zakładce „Edytor skryptów” w ramach pola „Nazwa programu” wpisał „Faktury z firm A,B,C”, później na zakładce „Uprawnienia” nadał uprawnienia do programu dla siebie oraz kilku innych operatorów i kliknął [Zapisz].
Na zakładce „Edytor skryptów” w polu edytora administrator wprowadził następujący kod:
Globals.ACD.Show();
while (1==1)
{
Globals.ACD.SetPoint("Faktury od Firmy A",1);
Globals.ACD.RefreshList();
Globals.ACD.GenerateDMSDocuments();
Globals.ACD.SetPoint("Faktury od Firmy B",1);
Globals.ACD.RefreshList();
Globals.ACD.GenerateDMSDocuments();
Globals.ACD.SetPoint("Faktury od Firmy C",1);
Globals.ACD.RefreshList();
Globals.ACD.GenerateDMSDocuments();
}
Następnie administrator nacisnął przycisk [Kompiluj i zapisz]. Kompilacja przebiegła pomyślnie, więc w dolnej części okna wyświetlona została informacja „Kompilacja skryptu zakończyła się sukcesem”.
Następnie administrator zapisał zmiany, klikając przycisk [Zapisz]. Później nacisnął przycisk [Uruchom] i w ramach otwartego okna „Uruchom program” wybrał w polu „Uruchom program” program „Faktury z firm A,B,C” i (nie zaznaczając checkboxa „Zabezpiecz hasłem”), a później kliknął przycisk [Uruchom].
Wówczas administrator został przeniesiony na zakładkę „Automatyczne generowanie dokumentów”, gdzie otworzyło się okno „Automatyczny tryb pracy”, a w tle odbywało się inicjowanie dokumentów.
Gdy wszystkie dokumenty zostały wygenerowane, administrator kliknął przycisk [Zatrzymaj program]. Okno „Automatyczny tryb pracy” zostało zamknięte.
Następnie administrator przeszedł na zakładkę [Dokumenty w obiegu] – na liście dokumentów widoczne były wszystkie dokumenty wygenerowane w wyniku działania programu „Faktury z firm A,B,C”. Po wejściu do przykładowego dokumentu można zauważyć, że na dokument zmapowano również wartości odczytane przez OCR, zgodnie z ustawieniami punktów ACD.
Dodanie w punktach ACD współpracujących z Comarch OCR opcji ‘Według języka wykrytego na dokumencie’
W wersji 2023.1.0 została dodana funkcjonalność wykrywania języka dokumentu przez Comarch OCR. W ramach zakładki [Automatyczne generowanie dokumentów]:
po kliknięciu przycisku [Dodaj] i wyborze trybu współpracy „Współpraca z Comarch OCR” lub „Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie DMS)”
lub
po wyborze w polu „Punkt konfiguracyjny” punktu ACD należącego do typu współpracy „Współpraca z Comarch OCR” albo „Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie DMS)” i po kliknięciu przycisku [Edytuj]
na zakładce „Ogólne”, w polu „Język dokumentu” dostępna jest nowa opcja „Według języka wykrytego na dokumencie”.
Przy takim ustawieniu w punkcie konfiguracyjnym ACD można wysyłać do usługi OCR dokumenty we wszystkich językach, które są obsługiwane (polski, niemiecki, angielski, francuski), a Comarch OCR rozpozna język na danym dokumencie i zwróci dane stosownie do schematu dedykowanego danemu językowi.
Umożliwienie uruchamiania pliku .exe w punkcie ACD
W wersji 2023.1.0 umożliwiono uruchamianie pliku .exe w ramach punktu ACD (zob. Uruchamianie pliku exe w punkcie ACD). W tym celu w pliku dms.exe.config, znajdującym się w folderze z aplikacją desktopową Comarch DMS, dodano nowy klucz ACDExePath, w którym należy wprowadzić ścieżkę do pliku .exe, który ma zostać uruchomiony w punkcie ACD.
Kiedy użytkownik wprowadzi ścieżkę w ramach klucza „ACDExePath”, zapisze zmiany, a następnie zaloguje się do aplikacji desktop Comarch DMS i przejdzie na zakładkę [Automatyczne generowanie dokumentów], wówczas po prawej stronie okna widoczna będzie nowa ikona [Uruchom].
Po kliknięciu w przycisk [Uruchom] zostanie uruchomiony plik .exe, do którego ścieżkę podano w pliku dms.exe.config.
Uwaga
Przycisk [Uruchom] jest widoczny tylko w przypadku, jeśli w pliku dms.exe.config w kluczu „ACDExePath” wprowadzono ścieżkę do pliku i zapisano zmiany.
Uwaga
Przycisk [Uruchom] jest dostępny dla wszystkich typów punktu konfiguracyjnego oprócz punktu konfiguracyjnego typu „Współpraca z Comarch OCR (przesyłanie skanów z kontrolki załącznik na dokumencie DMS)” i punktów współpracujących z Saldeo.
Umożliwienie obserwowania kontrolki typu URL przez inne kontrolki
Od wersji 2023.1. 0 kontrolka typu URL może być obserwowana przez inne kontrolki. Możliwe jest obserwowanie:
linku kontrolki – za pomocą parametru @IdentyfikatorKontrolki_Url@
lub
nazwy wyświetlanej kontrolki – za pomocą parametru @IdentyfikatorKontrolki_Display@
Dodanie możliwości inicjowania kontrolek za pomocą SQL ERP
W wersji 2023.1. 0 umożliwiono inicjowanie za pomocą opcji „SQL ERP” następujących typów kontrolek:
Dane tabelaryczne;
Data i godzina;
Dokument elektroniczny;
Kontrahent;
Liczba całkowita;
Liczba rzeczywista;
Liczba stałoprzecinkowa;
Lista;
Towar.
Dodanie możliwości równoległego inicjowania kontrolek
Od wersji 2023.1.0 operator może ustawić równoległe inicjowanie kontrolek. W tym celu w ramach definicji danego typu obiegu, w zakładce „Schemat obiegu”, w zakładce „Kontrolki” w kolumnie „Kolejność inicjowania” należy wybrać tę samą cyfrę.
Zmiana interfejsu iOS
W wersji 2023.1.0 nastąpiła zmiana interfejsu aplikacji Comarch DMS na system iOS.
Uwaga
Aby możliwe było poprawne korzystanie z aplikacji Comarch DMS na system iOS, należy zainstalować najnowszą wersję aplikacji web Comarch DMS.