Baza wiedzy LINKSPOT › Wskazówki

Konfiguracja automatycznego trybu pracy (robotyzacja procesów) – przykład zastosowania kodu C#

Wskazówki · Opublikowano 2026-03-06

Spis treści artykułu

Informacje ogólne

W wersji 2023.1.0 w aplikacji desktop Comarch DMS udostępniono funkcjonalność robotyzacji procesów.

Uwaga

Robotyzacja procesów jest dostępna jedynie w aplikacji desktop Comarch DMS .

W ramach mechanizmu robotyzacji użytkownik korzysta ze skryptów C#, z zastosowaniem predefiniowanych klas. W tym celu został udostępniony lokalny kompilator C#.

Skrypty mogą korzystać z referencji.

Skrypty są aktywowane ręcznie

Uwaga

Aby możliwe było uruchomienie skryptów, operator musi być zalogowany do aplikacji desktop Comarch DMS.

Zakładka „Konfiguracja automatycznego trybu pracy” – nadawanie uprawnień do zakładki i elementy okna

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 .

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.

Aby przyznać uprawnienie do zakładki [Konfiguracja automatycznego trybu pracy] pracownikowi należy przejść na zakładkę [Struktura organizacyjna], następnie kliknąć na sekcje „Pracownicy”, na danego pracownika i na zakładkę „Uprawnienia”. Następnie należy wybrać sekcję „Funkcjonalności” i w ramach pola „Konfiguracja automatycznego trybu pracy” wybrać wartość „Tak”, a następnie zapisać zmiany znakiem dyskietki. Wówczas pracownik będzie mógł tworzyć skrypty do pracy automatycznej.

Jeżeli w polu „Konfiguracja automatycznego trybu pracy” ustawiona jest wartość „Nie”, wówczas zakładka nie jest widoczna dla pracownika i nie ma on uprawnień do tworzenia skryptów do pracy automatycznej.

Uwaga

Jeżeli operator nadaje uprawnienie „Konfiguracja automatycznego trybu pracy” samemu sobie, wówczas zakładka będzie widoczna dopiero po ponownym zalogowaniu .

Nadawanie pracownikowi uprawnień do zakładki „Konfiguracja automatycznego trybu pracy”

Po pierwszym przejściu na zakładkę [Konfiguracja automatycznego trybu pracy] widoczne jest puste okno ze zwiniętym panelem „Skrypty” . W górnej części okna dostępne są następujące przyciski:

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

Aby dodać nową pozycję, należy nacisnąć przycisk [Dodaj]. Wówczas zostanie dodany nowy program z predefiniowaną nazwą „Nazwa programu 1”. W ramach okna widoczne są dwie zakładki:

Zakładka „Edytor skryptów”

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 .

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.

Aby przyznać uprawnienie do zakładki [Konfiguracja automatycznego trybu pracy] pracownikowi należy przejść na zakładkę [Struktura organizacyjna], następnie kliknąć na sekcje „Pracownicy”, na danego pracownika i na zakładkę „Uprawnienia”. Następnie należy wybrać sekcję „Funkcjonalności” i w ramach pola „Konfiguracja automatycznego trybu pracy” wybrać wartość „Tak”, a następnie zapisać zmiany znakiem dyskietki. Wówczas pracownik będzie mógł tworzyć skrypty do pracy automatycznej.

Jeżeli w polu „Konfiguracja automatycznego trybu pracy” ustawiona jest wartość „Nie”, wówczas zakładka nie jest widoczna dla pracownika i nie ma on uprawnień do tworzenia skryptów do pracy automatycznej.

Uwaga

Jeżeli operator nadaje uprawnienie „Konfiguracja automatycznego trybu pracy” samemu sobie, wówczas zakładka będzie widoczna dopiero po ponownym zalogowaniu .

Nadawanie pracownikowi uprawnień do zakładki „Konfiguracja automatycznego trybu pracy”

Po pierwszym przejściu na zakładkę [Konfiguracja automatycznego trybu pracy] widoczne jest puste okno ze zwiniętym panelem „Skrypty” . W górnej części okna dostępne są następujące przyciski:

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

Aby dodać nową pozycję, należy nacisnąć przycisk [Dodaj]. Wówczas zostanie dodany nowy program z predefiniowaną nazwą „Nazwa programu 1”. W ramach okna widoczne są dwie zakładki:

Zakładka „Uprawnienia”

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:

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

Uruchamianie i zatrzymywanie programu

Okno „Uruchom program”

Aby uruchomić program, należy kliknąć w ikonę  [Uruchom], która jest widoczna:

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

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

Po naciśnięciu ikony [Uruchom] zostaje otwarte okno „Uruchom program”. W ramach tego okna operator może uruchomić program. W oknie znajdują się dwa pola:

Uwaga

W ramach pola „Uruchom program” widoczne są tylko te programy, do których przyznano danemu operatorowi uprawnienia na zakładce „Uprawnienia” w oknie „Konfiguracja automatycznego trybu pracy”  (zob. Zakładka „Uprawnienia”).

Wybór z listy programu, który ma zostać uruchomiony

Okno „Uruchom program” z zaznaczonym checkboxem „Zabezpiecz hasłem”

Okno „Automatyczny tryb pracy”

Po naciśnięciu w oknie „Uruchom program” przycisku [Uruchom] zostaje otwarte okno „Automatyczny tryb pracy”.

W ramach okna „Automatyczny tryb pracy” znajduje się nazwa programu, który został uruchomiony, jest również podawany czas, który zajęło dotychczas wykonywanie programu.

Aby zakończyć działania programu, należy kliknąć przycisk [Zatrzymaj program], znajdujący się w dolnej części okna.

Uwaga

Jeśli okno „Automatyczny tryb pracy” jest włączone, użytkownik nie może pracować z Comarch DMS.

Okno „Automatyczny tryb pracy”

Kiedy operator naciśnie przycisk [Zatrzymaj program]:

Okno, w którym należy wpisać hasło zalogowanego operatora, aby zatrzymać program

W oknie dostępne są następujące przyciski:

Okno wyświetlane po podaniu hasła operatora i zatrzymaniu programu

Okno wyświetlone po wyborze przycisku „Zamknij aplikację”

W ramach okna znajdują się dwa przyciski:

Informacja wyświetlana, jeśli nie wprowadzono hasła lub wprowadzono błędne hasło

Klasa ACD

W obiekcie Globals dodano klasę ACD, która określa grupę metod wykonywanych jedynie w kontekście okna ACD. W klasie ACD udostępniono następujące metody:

GenerateDMSDocuments () – metoda umożliwia wciśnięcie przycisku „Generuj” na zakładce „Automatyczne generowanie dokumentów”.

Int GenerateDMSDocuments()

Return: 0 – ok, -1 – error

Od wersji 2024.0.1 na zakładce „Edytor skryptów” na zakładce   [Konfiguracja automatycznego trybu pracy] można korzystać z następujących wariantów metody GenerateDMSDocuments():

Przykład skryptu z metodą GenerateDMSDocuments(string company, string department)

Przykład skryptu z metodą GenerateDMSDocuments(string company)

GetDocumentList – metoda umożliwia pobranie informacji o zaczytanych dokumentach

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

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”

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

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

0 – procesowanie dokumentów jest wyłączone (dotyczy punktów ACD, które nie obsługują OCR)

1 – procesowanie dokumentów jest włączone

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

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

int Show()

return: 0 – ok, -1 - error

Uwaga

W wersji 2024.3.0 udostępniono metodę Globals.ACD:int GetErrorList(ref ACDError[] errors) w ramach skryptów C# na zakładce [Konfiguracja automatycznego trybu pracy]. Metoda zwraca listę ostatnich błędów (do 50 błędów) na bieżącym punkcie ACD, można ją zastosować dla punktów współpracujących z Comarch OCR oraz dla punktów współpracujących ze skrzynką pocztową.

Poniżej przedstawiono przykład z zastosowaniem nowej metody (została oznaczona zieloną czcionką) dla przykładowych punktów ACD typu Współpraca z Comarch OCR („Faktury od Firmy A”, „Faktury od Firmy B”, „Faktury od Firmy C”):

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

ACDError[] errors; 
Globals.ACD.GetErrorList(ref errors); 

Globals.ACD.GenerateDMSDocuments(); 

Globals.ACD.SetPoint("Faktury od Firmy C",1); 

Globals.ACD.RefreshList(); 

Globals.ACD.GenerateDMSDocuments(); 

}

Zakładka „Konfiguracja automatycznego trybu pracy” z wprowadzonym kodem C# z nową metodą

Klasa Common

W ramach klasy Comon udostępniono następującą metodę:

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 zastosowaniem metody Trace

Konfiguracja i uruchamianie automatycznego trybu pracy – przykład

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

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

Wskazówka

Aby zobaczyć przykład, kliknij na film poniżej.

https://pomoc.comarch.pl/dms/wp-content/uploads/2023/07/robo1.mp4

Wskazówka

Aby zobaczyć przykład, kliknij na filmy poniżej.

https://pomoc.comarch.pl/dms/wp-content/uploads/2023/07/robo2.mp4

https://pomoc.comarch.pl/dms/wp-content/uploads/2023/07/robo3.mp4

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

Wskazówka

Aby zobaczyć przykład, kliknij na film poniżej.

https://pomoc.comarch.pl/dms/wp-content/uploads/2023/07/robo4.mp4

Wskazówka

Aby zobaczyć przykład, kliknij na film poniżej.

https://pomoc.comarch.pl/dms/wp-content/uploads/2023/07/robo5.mp4

Wskazówka

Aby zobaczyć przykład, kliknij na film poniżej.

https://pomoc.comarch.pl/dms/wp-content/uploads/2023/07/robo6.mp4

https://pomoc.comarch.pl/dms/wp-content/uploads/2023/07/robo7.mp4

https://pomoc.comarch.pl/dms/wp-content/uploads/2023/07/robo8.mp4

Przykładowy dokument wygenerowany w automatycznym trybie pracy

Film

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

+ Mam problem z tym tematem Otwórz w portalu bazy wiedzy »