Robotyzacja procesów

W nowej wersji systemu Comarch DMS, udostępniono funkcjonalność robotyzacji procesów (zob. Konfiguracja automatycznego trybu pracy (robotyzacja procesów)). Aktualnie funkcjonalność pozwala na utworzenie skryptu, który bez ingerencji operatora:

  • otworzy wybrany punkt ACD;
  • uruchomi przekazywanie skanów do OCR;
  • wygeneruje dokumenty.

Film
W artykule Automatyczne generowanie dokumentów dzięki mechanizmom RPA. Prezentacja funkcjonalności dostępny jest film z lektorem przedstawiający funkcjonalność.

Uwaga
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].

Nowe pole „Konfiguracja automatycznego trybu pracy” na karcie pracownika

 

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.

Klucz „RPAFolderPath” w pliku „DMS.exe.config”

 

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” .

Okno „Konfiguracja automatycznego trybu pracy” po pierwszym otwarciu zakładki

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#

 

Wprowadzanie kodu do edytora skryptów

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

    • Parametry wejściowe:

0 – generowanie wszystkich dokumentów;

1 – generowanie jedynie wypełnionych dokumentów;

2 – generowanie wybranych dokumentów;

    • Zwraca wyniki:

0 – operacja została wykonana poprawnie

-1 – wystąpił błąd

 

Wskazówka
int SetViewMode(byte)
byte: 0 – all documents, 1 – correct documents, 2 – selected documents
return: 0 – ok, – 1 – error

 

Show – metoda, która otwiera obszar ACD

    • brak parametrów wejściowych
    • zwraca wyniki:

0 – operacja została wykonana poprawnie

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\””);

 

Okno „Automatyczny tryb pracy” z przykładowym komunikatem wprowadzonym w ramach metody Trace

 

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.

 

Zakładka „Uprawnienia” w ramach okna „Konfiguracja automatycznego trybu pracy” przed dodaniem uprawnień

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.

 

Zakładka „Uprawnienia” w ramach okna „Konfiguracja automatycznego trybu pracy” z dodanymi uprawnieniami – przed zapisaniem zmian

Ikona [Uruchom] jest widoczna:

  • Na zakładce [Dokumenty] – dla każdego użytkownika, któremu przyznano uprawnienia do co najmniej jednego programu

 

Widok listy dokumentów dla użytkownika, któremu nadano uprawnienia do programu – w prawym górnym rogu widoczna jest ikona „Uruchom”

 

  • W ramach okna „Konfiguracja automatycznego trybu pracy”, dla operatora, któremu przyznano uprawnienia do co najmniej jednego programu

Widok okna „Konfiguracja automatycznego trybu pracy” dla użytkownika, któremu nadano uprawnienia do programu – w prawym górnym rogu widoczna jest ikona „Uruchom”

 

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].

 

Zakładka „Edytor skryptów” wraz z wprowadzonym kodem

 

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.

 

Okno „Uruchom program”

 

Automatyczny tryb pracy – widok Comarch DMS po uruchomieniu przykładowego programu

 

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].

 

Okno, w którym należy wpisać hasło zalogowanego operatora, aby zatrzymać 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”)

Ustawienia punktu ACD „Faktury od Firmy A” – zakładka „Ogólne”

Ustawienia punktu ACD „Faktury od Firmy A” – zakładka „Kontrolki”

  • 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].

Nadawanie nazwy programu na zakładce „Edytor skryptów”

Nadawanie uprawnień na zakładce „Uprawnienia”

  • 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();

}

Wprowadzanie kodu do edytora skryptów

  • 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”.

Zakładka „Edytor skryptów” po skompilowaniu skryptu

  • 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].

Okno „Uruchom program” – wybór programu „Faktury z firm A,B,C”

  • 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.

Automatyczny tryb pracy – inicjowanie dokumentów

  • Gdy wszystkie dokumenty zostały wygenerowane, administrator kliknął przycisk [Zatrzymaj program]. Okno „Automatyczny tryb pracy” zostało zamknięte.

Widok zakładki „Automatyczne generowanie dokumentów” po zatrzymaniu programu

  • 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.

Lista dokumentów z dokumentami wygenerowanymi w automatycznym trybie pracy

Przykładowy dokument wygenerowany w automatycznym trybie pracy