Czy można użyć mechanizmu wymagalności dla konkretnych kolumn w kontrolce Dane tabelaryczne?

Niestety nie. Można ustawić kontrolkę Dane tabelaryczne jako wymaganą, natomiast wymagalność ta zostanie spełniona po dodaniu przynajmniej jednego wiersza, nie ma znaczenia które z kolumn zostaną wypełnione.

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!

Czy po dodaniu uprawnień obserwatora dla typu obiegu, widzi on również dokumenty wygenerowane przed dodaniem uprawnień?

Tak, po dodaniu obserwatora do danego typu obiegu otrzyma on uprawnienia do wyświetlania wszystkich dokumentów, również tych wygenerowanych przed nadaniem uprawnień.

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!

Czy można dynamicznie przekazać argumenty do tematu maila wysyłanego przez DMS?

Tak, istnieje taka możliwość. W temacie wiadomości mailowej można dodawać maski, analogicznie jak w treści. Pozwala to np. na wyświetlenie numeru przekazanego do operatora dokumentu już w temacie – przykład przedstawiono poniżej.

Informacje dotyczące dostępnych masek są dostępne w artykule EMAIL

Szablon wiadomości email – w temacie maila dodano maskę {DocumentNumber} (maskę oznaczono na czerwono)

Przykładowy email otrzymany przez uprawnionego operatora, gdy w temacie maila umieszczono maskę {DocumentNumber} (numer oznaczono na czerwono)

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!

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

Spis treści artykułu

Informacje ogólne
Zakładka „Konfiguracja automatycznego trybu pracy” – nadawanie uprawnień do zakładki i elementy okna
Zakładka „Edytor skryptów”
Zakładka „Uprawnienia”
Uruchamianie i zatrzymywanie programu
Konfiguracja i uruchamianie automatycznego trybu pracy – przykład

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:

[Dodaj] – po naciśnięciu przycisku zostaje dodany nowy skrypt
[Usuń] – przycisk pozwala na usunięcie programu z listy programów w oknie „Konfiguracja automatycznego trybu pracy” oraz z listy programów, które mogą być uruchomione przez użytkownika
[Zapisz] – przycisk służy do zapisywania zmian w programie
[Uruchom] – przycisk otwiera okno „Automatyczny tryb pracy”; przycisk widoczny jedynie dla użytkowników, którym nadano uprawnienie do danego programu na zakładce „Uprawnienia” w ramach okna „Konfiguracja automatycznego trybu pracy” (zob. Uruchamianie i zatrzymywanie programu).

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:

Edytor skryptów
Uprawnienia

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 .

Uwaga

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

[Dodaj] – po naciśnięciu przycisku zostaje dodany nowy skrypt
[Usuń] – przycisk pozwala na usunięcie programu z listy programów w oknie „Konfiguracja automatycznego trybu pracy” oraz z listy programów, które mogą być uruchomione przez użytkownika
[Zapisz] – przycisk służy do zapisywania zmian w programie
[Uruchom] – przycisk otwiera okno „Automatyczny tryb pracy”; przycisk widoczny jedynie dla użytkowników, którym nadano uprawnienie do danego programu na zakładce „Uprawnienia” w ramach okna „Konfiguracja automatycznego trybu pracy” (zob. Uruchamianie i zatrzymywanie programu).

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:

Edytor skryptów
Uprawnienia

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:

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

Uruchamianie i zatrzymywanie programu

Okno „Uruchom program”

Aby uruchomić program, należy kliknąć w ikonę [Uruchom], która 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 tego okna oraz 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”

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:

Uruchom program – w ramach tego pola użytkownik może wybrać program, który chce uruchomić, z rozwijanej listy

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

Zabezpiecz hasłem – pole domyślnie odznaczone; jeżeli zostanie zaznaczone, wówczas zatrzymanie pracy programu będzie wymagało podania hasła zalogowanego operatora w oknie „Automatyczny tryb pracy”.

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

Po wyborze programu operator powinien nacisnąć przycisk [Uruchom] – wówczas okno „Uruchom program” zostanie zamknięte, a otworzy się okno „Automatyczny tryb pracy” i wybrany program rozpocznie działanie.
Natomiast jeżeli operator nie chce jednak uruchomić programu, powinien kliknąć przycisk [Anuluj] – wtedy okno „Uruchom program” zostanie zamknięte, a program się nie uruchomi.

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.

Kiedy operator naciśnie przycisk [Zatrzymaj program]:

jeśli w oknie „Uruchom program” nie zaznaczono checkboxa „Zabezpiecz hasłem” – wykonywanie skryptu zostanie przerwane, okno „Automatyczny tryb pracy” – zamknięte, a operator może znowu pracować z Comarch DMS;
jeśli w oknie „Uruchom program” zaznaczono checkbox „Zabezpiecz hasłem” – wyświetlone zostaje okno, w ramach którego należy wprowadzić hasło zalogowanego operatora.

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

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

[Zatrzymaj program] – kiedy operator wybierze tn przycisk, wówczas wykonywanie skryptu zostanie zatrzymane, okno „Automatyczny tryb pracy” – zamknięte, zostanie również wyświetlone okno informujące o zakończeniu działania programu, w którym należy kliknąć przycisk „Ok”. Operator będzie mógł znowu pracować z Comarch DMS;

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

[Zamknij aplikację] – po naciśnięciu tego przycisku zostaje wyświetlone następujące okno:

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

W ramach okna znajdują się dwa przyciski:

- Tak – aplikacja Comarch DMS zostanie zamknięta
- Nie – jeżeli operator wybierze tę opcję, wówczas aplikacja Comarch DMS pozostaje otwarta, a skrypt nadal jest wykonywany
[Anuluj] – jeśli użytkownik kliknie ten przycisk, wówczas okno do wprowadzenia hasła zostanie zamknięte, a skrypt będzie nadal wykonywany;
Jeżeli operator nie wprowadzi hasła lub wprowadzi błędne hasło, a następnie kliknie w przycisk [Zatrzymaj program], wówczas zostanie wyświetlona informacja o nieprawidłowym haśle, a skrypt nadal będzie wykonywany.

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

Int GenerateDMSDocuments()

Return: 0 – ok, -1 – error

Uwaga

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

GenerateDMSDocuments(string company, string department)
- W ramach parametru string company należy wprowadzić nazwę spółki, a w ramach parametru string department – nazwę działu danej spółki

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

GenerateDMSDocuments(string company)
- W ramach parametru string company należy wprowadzić nazwę spółki

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

[/alert]

GetDocumentList – metoda umożliwia pobranie informacji o zaczytanych dokumentach

Zwraca wyniki:
- 0 – operacja została wykonana poprawnie
- -1 – wystąpił błąd

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

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

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

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

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

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”

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ę:

Trace(string) – metoda umożliwia wyświetlanie dodatkowych informacji na oknie „Automatyczny tryb pracy”,[/su_list]

void Trace(string)

string:message

Przykład:

Globals.Common.Trace("Trwa procesowanie dokumentów dla punktu: \"Faktury od Firmy C\"");

Konfiguracja i uruchamianie automatycznego trybu pracy – przykład

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

Wskazówka

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

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 i kilku innych operatorów i kliknął [Zapisz].

Wskazówka

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

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

Wskazówka

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

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

Wskazówka

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

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.

Wskazówka

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

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.

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ść.

Ustawienia

Zakładka „Ustawienia” zawiera dwie zakładki:

- Szczegóły dokumentu
- Preferencje

Szczegóły dokumentu

W ramach zakładki „Szczegóły dokumentu” użytkownik może określić swoje preferencje dotyczące panelu „Szczegóły dokumentu” widocznego po kliknięciu ikony po prawej stronie dokumentu (zob. Panel szczegółów dokumentu).

Na zakładce „Szczegóły dokumentu” znajdują się trzy sekcje:

Ustawienia panelu szczegółów dokumentu – w ramach tej sekcji dostępne są następujące parametry:
- Widok panelu – domyślnie opcja „ Domyślnie rozwinięte szczegóły dokumentu” nie jest zaznaczona – wówczas panel „Szczegóły dokumentu” domyślnie rozwija się na zakładce „Informacje”. Jeśli użytkownik zaznaczy opcję „Domyślnie rozwinięte szczegóły dokumentu”, wówczas może wybrać, która zakładka będzie domyślnie widoczna po rozwinięciu panelu (Informacje, Status, Komentarze lub Uprawnienia). W tym celu użytkownik powinien zaznaczyć kółko obok danej opcji, a następnie kliknąć przycisk [Zapisz] dostępny w ramach sekcji. Przycisk pozostaje wyszarzony aż do czasu zmiany oznaczenia domyślnie widocznej zakładki.

Zmiana zakładki, która jest domyślnie widoczna po rozwinięciu panelu „Szczegóły dokumentu”

Panel „Szczegóły dokumentu” na dokumencie po dokonaniu zmiany w ramach parametru „Widok panelu” na zakładce „Ustawienia” – po otwarciu panelu domyślnie wyświetla się zakładka „Komentarze”

- Wyświetl historię przekazania zaczynając od etapu – parametr jest domyślnie ustawiony na „Aktualny” – wówczas w ramach panelu „Szczegóły dokumentu” na dokumencie w zakładce „Status” widoczna jest historia przekazywania dokumentu, zaczynając od etapu, na którym aktualnie znajduje się dokument, do pierwszego etapu; jeśli użytkownik naciśnie link [Zmień], wówczas może zmienić ustawienie parametru na „Pierwszy” i zapisać zmianę, naciskając przycisk [Zapisz] dostępny w ramach sekcji. W takim przypadku w ramach panelu „Szczegóły dokumentu” na dokumencie w zakładce „Status” widoczna jest historia przekazywania dokumentu od pierwszego etapu do aktualnego. Użytkownik może zrezygnować z dokonania zmiany, klikając przycisk [Anuluj] – wtedy nastąpi powrót do dotychczasowego ustawienia.

Historia przekazania dokumentu od aktualnego do pierwszego etapu, widoczna w zakładce „Status” w panelu „Szczegóły dokumentu” – gdy zaznaczono ustawienie domyślne „Aktualny”

Wybór opcji „Pierwszy” w ramach parametru „Wyświetl historię przekazania zaczynając od etapu”

Ustawienia sekcji dokumentu – w ramach tej sekcji po kliknięciu w link [Zmień] użytkownik może określić, w jaki sposób mają być wyświetlane sekcje na dokumencie. Dostępne są trzy opcje:
- Ostatnio ustawione (domyślna) – sekcje na dokumencie są wyświetlane jako rozwinięte lub zwinięte, w zależności od tego, jak zostały ostatnio ustawione;
- Zawsze rozwinięte – sekcje na dokumencie są wyświetlane w formie rozwiniętej;
- Zawsze zwinięte – sekcje na dokumencie są wyświetlane w formie zwiniętej

Użytkownik może zrezygnować z dokonania zmiany, klikając przycisk [Anuluj] – wtedy nastąpi powrót do dotychczasowego ustawienia widoczności sekcji.

Aby zmienić sposób wyświetlania sekcji, należy kliknąć na wybraną opcję na liście i nacisnąć przycisk [Zapisz] dostępny w ramach sekcji.

Widok sekcji „Ustawienia sekcji dokumentu”

Przekazanie dokumentu – w ramach tej sekcji użytkownik określa, co nastąpi po przekazaniu dokumentu. Dostępne są trzy opcje:
- Powrót na listę – po przekazaniu dokumentu zostanie wyświetlona lista dokumentów;
- Przejdź do następnego dokumentu – po przekazaniu dokumentu zostanie wyświetlony następny dokument z listy;
- Pozostań na dokumencie – po przekazaniu dokumentu zostanie wyświetlony przekazany dokument.

Użytkownik może zrezygnować z dokonania zmiany, klikając przycisk [Anuluj] – wtedy nastąpi powrót do dotychczasowego ustawienia.

Aby zmienić ustawienie, należy kliknąć na wybraną opcję na liście i nacisnąć przycisk [Zapisz] dostępny w ramach sekcji.

Preferencje

W ramach zakładki „Preferencje” użytkownik może ustawić język aplikacji i preferowany widok listy dokumentów, od wersji 2024.3.0 może również włączyć logowanie dwustopniowe.

Na zakładce „Preferencje” znajdują się trzy sekcje:

Język aplikacji – po kliknięciu w link [Zmień] użytkownik może wybrać język, w jakim ma być wyświetlana aplikacja. Należy wybrać z listy jeden z następujących języków:
- Polski;
- English (angielski);
- Deutsch (niemiecki);
- Français (francuski).

Użytkownik może zrezygnować z dokonania zmiany, klikając przycisk [Anuluj] – wtedy nastąpi powrót do dotychczasowego ustawienia.

Aby zmienić ustawienie, należy kliknąć na wybraną opcję na liście i nacisnąć przycisk [Zapisz] dostępny w ramach sekcji. Zmiana języka następuje po zapisaniu zmiany, bez konieczności ponownego zalogowania.

Widok listy dokumentów – po kliknięciu w link [Zmień] użytkownik może wybrać jedną z następujących opcji:
- Domyślny – wówczas dokumenty na liście wyświetlane są w standardowy sposób, tak jak na poniższej ilustracji:

- Kompaktowy – ustawienie widoku, w którym poszczególne pozycje na liście mają zmniejszony rozmiar tak, że na stronie widoczne jest więcej dokumentów.

Użytkownik może zrezygnować z dokonania zmiany, klikając przycisk [Anuluj] – wtedy nastąpi powrót do dotychczasowego ustawienia.

Aby zmienić ustawienie, należy zaznaczyć kółko obok wybranej opcji i nacisnąć przycisk [Zapisz] dostępny w ramach sekcji.

Logowanie dwuetapowe – sekcja dodana w wersji 2024.3.0; w ramach tej sekcji operator może włączyć lub wyłączyć logowanie dwuetapowe. Jeżeli operator chce włączyć logowanie dwuetapowe, wówczas powinien kliknąć w link [Zmień], znajdujący się obok pola „Używaj aplikacji Google Authenticator, aby generować kody weryfikacyjne w celu lepszego zabezpieczenia konta”.

Zakładka „Ustawienia”, zakładka „Preferencje” – wybór opcji „Zmień” w sekcji „Logowanie dwuetapowe”

Po kliknięciu w link [Zmień] zostaje otwarte okno „Włącz logowanie dwuetapowe”.

Zakładka „Ustawienia”, zakładka „Preferencje”, sekcja „Logowanie dwuetapowe” z oknem „Włącz logowanie dwuetapowe”

Następnie operator musi kolejno wykonać następujące czynności:

1. Pobrać aplikację Google Authenticator na urządzeniu mobilnym

2. Otworzyć aplikację Google Authenticator

3. W aplikacji Google Authenticator kliknąć w przycisk „Dodaj kod”

4. Wybrać jedną z następujących możliwych ścieżek postępowania:

kliknąć w opcję „Zeskanuj kod QR” w aplikacji Google Authenticator i zeskanować kod QR widoczny w oknie „Włącz logowanie dwuetapowe” w aplikacji Comarch DMS

lub

kliknąć w opcję „Wpisz klucz konfiguracyjny” w aplikacji Google Authenticator, a następnie w polu „Nazwa konta” wprowadzić nazwę, pod jaką będzie widoczne konto w aplikacji Google Authenticator, a w polu „Twój klucz bezpieczeństwa” wpisać 16-cyfrowy kod dostępny poniżej kodu QR w oknie „Włącz logowanie dwuetapowe” w Comarch DMS. Po wprowadzeniu wartości należy nacisnąć przycisk „Dodaj” w aplikacji Google Authenticator

5.Zapisać 16-cyfrowy kod z pola poniżej kodu QR na nośniku zewnętrznym – umożliwi to dostęp do konta w przypadku utraty lub usterki urządzenia mobilnego

6.W polu „Wpisz kod weryfikacyjny z aplikacji Google Authenticator” dostępnym w oknie „Włącz logowanie dwuetapowe” w Comarch DMS wpisać 6-cyfrowy kod weryfikacyjny wyświetlany w aplikacji Google Authenticator, zanim upłynie jego ważność, oznaczona zanikającym niebieskim kołem (kod jest ważny 60 sekund) – jeśli dany kod wygasł, w Comarch DMS należy wpisać kolejny wygenerowany kod

7. Kliknąć przycisk [Zapisz].

Okno „Włącz logowanie dwuetapowe” w nowej aplikacji web Comarch DMS – wprowadzanie kodu w polu „Wpisz kod weryfikacyjny z aplikacji Google Authenticator”

Kiedy operator zeskanuje kod albo wprowadzi klucz bezpieczeństwa w aplikacji Google Authenticator, urządzenie mobilne zostanie połączone z serwerem DMS. Następnie Google Authenticator działa bez konieczności podłączenia do Internetu na podstawie czasu – należy jedynie co pewien czas umożliwiać aplikacji połączenie z Internetem, aby została dokonana synchronizacja zegara.

Po wprowadzeniu prawidłowego kodu weryfikacyjnego i naciśnięciu przycisku [Zapisz] okno „Włącz logowanie dwuetapowe” zostaje zamknięte, logowanie dwuetapowe zostaje włączone, a w polu „Logowanie dwuetapowe” w sekcji „Używaj aplikacji Google Authenticator, aby generować kody weryfikacyjne w celu lepszego zabezpieczenia konta” wyświetlana jest wartość „Włączone”.

Zakładka „Ustawienia”, zakładka „Preferencje” , sekcja „Logowanie dwuetapowe” – widok po włączeniu logowania dwuetapowego dla operatora

Wyłączenie weryfikacji dwuetapowej przez operatora w nowej aplikacji web Comarch DMS

Aby wyłączyć logowanie dwuetapowe dla danego operatora w nowej aplikacji web Comarch DMS, należy przejść na zakładkę [Ustawienia], a później do zakładki „Preferencje”. Następnie należy sprawdzić w sekcji „Logowanie dwuetapowe”, którą dodano w wersji 2024.3.0, czy w polu „Używaj aplikacji Google Authenticator, aby generować kody weryfikacyjne w celu lepszego zabezpieczenia konta” wybrana jest opcja „Włączone”– jeśli tak, operator powinien kliknąć w link [Zmień], znajdujący się obok tego pola.

Po kliknięciu w link [Zmień] zostaje otwarte okno „Wyłącz logowanie dwuetapowe”.

Następnie w polu „Wpisz kod weryfikacyjny z aplikacji Google Authenticator” dostępnym w oknie „Wyłącz logowanie dwuetapowe” w Comarch DMS wpisać 6-cyfrowy kod weryfikacyjny wyświetlany w aplikacji Google Authenticator, zanim upłynie jego ważność, oznaczona zanikającym niebieskim kołem (kod jest ważny 60 sekund) – jeśli dany kod wygasł, w Comarch DMS należy wpisać kolejny wygenerowany kod. Później operator powinien kliknąć przycisk [Zapisz].

Okno „Wyłącz logowanie dwuetapowe” w nowej aplikacji web Comarch DMS – wprowadzanie kodu w polu „Wpisz kod weryfikacyjny z aplikacji Google Authenticator”

Po wprowadzeniu prawidłowego kodu weryfikacyjnego i naciśnięciu przycisku [Zapisz] okno „Wyłącz logowanie dwuetapowe” zostaje zamknięte, logowanie dwuetapowe zostaje wyłączone, a w polu „Używaj aplikacji Google Authenticator, aby generować kody weryfikacyjne w celu lepszego zabezpieczenia konta” w sekcji „Logowanie dwuetapowe” wyświetlana jest wartość „Wyłączone”.

Zakładka „Ustawienia”, zakładka „Preferencje” , sekcja „Logowanie dwuetapowe” – widok po wyłączeniu logowania dwuetapowego dla operatora

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!

Powrót do początku artykułu

Dodawanie wielu dokumentów do kontrolki typu Załącznik

W wersji 2025.0.0 umożliwiono dodawanie wielu plików do kontrolki typu Załącznik w nowej aplikacji web Comarch DMS.

Dodawanie plików do kontrolki załącznik, która nie współpracuje z Comarch DMS Repozytorium

Aby dodać wiele plików do kontrolki typu załącznik, która nie współpracuje z Repozytorium, należy kliknąć w przycisk [Dodaj] dostępny w ramach kontrolki, a następnie w ramach okna „Dodaj Załącznik”:

Wybrać pliki z dysku, przeciągnąć je i upuścić w centralnej części okna

Lub

Kliknąć w link [wybierz plik(i)], znajdujący się pośrodku okna, w otwartym oknie wybrać pliki do przesłania, zaś później kliknąć przycisk [Otwórz] .

Widok okna „Dodaj Załącznik” z linkiem „wybierz plik(i)”

Przeciąganie i upuszczanie plików w oknie „Dodaj Załącznik”

Wybór plików do dodania jako załączniki po kliknięciu w link „wybierz plik(i)”

Po przeciągnięciu plików lub po dodaniu ich z okna dialogowego w dolnej części okna „Dodaj Załącznik” zostanie wyświetlona lista wybranych plików, a w górnej części okna – miniaturowy podgląd aktualnie wybranego na liście pliku. Jeśli na liście znajduje się dużo plików, obok dostępny jest pasek przewijania.

Operator może zmienić nazwę każdego z plików na liście, a także zrezygnować z dodawania któregoś z plików, naciskając znak obok danej pozycji. Istnieje również możliwość wybrania kolejnych plików poprzez ich przeciągnięcie i upuszczenie lub poprzez kliknięcie w link [wybierz plik(i)].

Po ewentualnej edycji listy plików do dodania należy nacisnąć przycisk [Dodaj] – wówczas wybrane pliki zostaną dodane w ramach danej kontrolki typu Załącznik.

Okno „Dodaj Załącznik” po wyborze plików do dodania

Kontrolka typu Załącznik z dodanymi plikami

Dodawanie plików do kontrolki załącznik, która współpracuje z Comarch DMS Repozytorium

Aby dodać wiele plików do kontrolki typu załącznik, która współpracuje z Repozytorium, należy kliknąć w przycisk [Dodaj] dostępny w ramach kontrolki, a następnie w ramach okna „Dodaj Załącznik”:

Widok okna „Dodaj Załącznik” z linkiem „wybierz plik(i)” przed przesyłaniem plików, zakładka „Z dysku”

Jeśli operator wybrał zakładkę „Z dysku”, wówczas może:

Wybrać pliki z dysku, przeciągnąć je i upuścić w centralnej części okna

lub

Kliknąć w link [wybierz plik(i)], znajdujący się pośrodku okna, w otwartym oknie wybrać pliki do przesłania, zaś później kliknąć przycisk [Otwórz] .

Przeciąganie i upuszczanie plików w oknie „Dodaj Załącznik”, na zakładce „Z dysku”

Wybór plików do dodania jako załączniki po kliknięciu w link „wybierz plik(i)”, na zakładce „Z dysku”

Po przeciągnięciu plików lub po dodaniu ich z okna dialogowego w dolnej części zakładki „Z dysku” zostanie wyświetlona lista wybranych plików, a w górnej części okna – miniaturowy podgląd aktualnie wybranego na liście pliku. Jeśli na liście znajduje się dużo plików, obok dostępny jest pasek przewijania.

Jeżeli na definicji danej kontrolki dodano więcej niż jeden typ dokumentu, wówczas obok pola z nazwą pliku dostępne jest również pole [Typ dokumentu], w ramach którego można wybrać typ dokumentu, który ma zostać przypisany do danego pliku w Repozytorium.

Po ewentualnej edycji listy plików do dodania należy nacisnąć przycisk [Dodaj] – wówczas wybrane pliki zostaną dodane w ramach danej kontrolki typu Załącznik.

Okno „Dodaj Załącznik”, zakładka „Z dysku” po wyborze plików do dodania

Okno „Dodaj Załącznik”, zakładka „Z dysku” po wyborze plików do dodania (gdy na definicji danej kontrolki wybrano więcej niż jeden typ dokumentu)

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!

Powrót do początku artykułu

Masowe przekazywanie dokumentów z listy w nowej aplikacji web

W wersji 2025.0.0 umożliwiono przekazywanie wielu dokumentów z poziomu listy dokumentów do etapu domyślnego w nowej aplikacji web Comarch DMS.

Aby możliwe było przekazanie wielu dokumentów z poziomu listy dokumentów do etapu domyślnego należy wykonać kolejno następujące czynności:

W aplikacji desktop na zakładce [Definicje obiegów dokumentów] na definicji wybranego obiegu przejść do zakładki „Schemat obiegu” i kliknąć na etap, z którego ma następować przekazywanie dokumentów
W ramach sekcji „Przekazanie” rozwinąć sekcję „Przekazanie z listy”
W ramach pola „Etap domyślny” wybrać etap, do którego ma nastąpić przekazanie z listy

Przykładowe ustawienie funkcjonalności przekazywania dokumentów z listy dla typu obiegu „Projekt”

W ramach nowej aplikacji web kliknąć w przycisk [Więcej filtrów], następnie zaznaczyć parametr [Do przekazania z listy], a później nacisnąć przycisk [Pokaż wyniki]

Ustawianie filtra do przekazywania dokumentów z listy w nowej aplikacji web

Na liście dokumentów zaznaczyć checkboxy obok jednego lub więcej dokumentów, które mają zostać przekazane do etapu domyślnego – wówczas nad lista dokumentów zostanie wyświetlona belka z informacjami o ilości zaznaczonych dokumentów spośród dokumentów dostępnych na danej stronie listy oraz z linkami „Odznacz wszystko”, „Zaznacz wszystko” i „Przekaż”;

Uwaga

Operator może jednorazowo zaznaczyć i przekazać z listy tylko dokumenty znajdujące się na danej stronie listy, np. jeśli na danej stronie wyświetlane jest maksymalnie 25 dokumentów, wówczas można za jednym razem przekazać co najwyżej 25 dokumentów, wszystkie znajdujące się na tej samej stronie listy.

Jeżeli operator zaznaczy dokumenty na jednej stronie listy, a później przejdzie na kolejna stronę listy, wtedy dokumenty ze strony poprzedniej zostaną odznaczone.

Wybór dokumentów do przekazania z poziomu listy dokumentów w nowej aplikacji web

Na belce nad listą dokumentów kliknąć w link [Przekaż] – wówczas zostanie wyświetlone okno „Trwa przekazywanie dokumentów…”, w którym widoczna jest informacja dotycząca postępu operacji przekazywania dokumentów;

Jeśli operacja ma zostać wstrzymana, należy kliknąć w przycisk [Zatrzymaj]. Wówczas przekazywanie dokumentów zostanie wstrzymane i zostanie wyświetlone okno „Chcesz przerwać przekazywanie?”. W ramach okna „Chcesz przerwać przekazywanie?” widoczna jest informacja o postępie operacji przekazywania dokumentów aż do wstrzymania operacji, dostępne są też dwa przyciski:

[Kontynuuj] – jeśli operator kliknie w ten przycisk, nastąpi powrót do okna „Trwa przekazywanie dokumentów…”

[Przerwij] – jeżeli operator naciśnie ten przycisk, wówczas przekazywanie dokumentów zostanie zatrzymane, zamknie się okno „Chcesz przerwać przekazywanie?” i zostanie wyświetlone okno „Nie przekazano … dokumentów!/Nie przekazano 1 dokumentu!”.

W ramach okna „Nie przekazano … dokumentów!/Nie przekazano 1 dokumentu!” widoczne są następujące informacje:

Liczba dokumentów, które nie zostały przekazane do etapu domyślnego
Lista numerów dokumentów, które nie zostały przekazane do etapu domyślnego
Powód nieprzekazania dokumentu do etapu domyślnego

Jeśli nieprzekazanych dokumentów jest więcej niż trzy, wówczas po prawej stronie listy dostępny jest pasek przewijania.

Aby zamknąć okno, należy kliknąć w link [Zamknij].

Okno „Nie przekazano … dokumentów” z suwakiem

Jeżeli przekazywanie wielu dokumentów z listy zakończyło się sukcesem, wówczas w dolnym prawym rogu strony zostanie wyświetlony komunikat „Przekazano dokumenty. Wszystkie wybrane dokumenty zostały przekazane.”

Okno nowej aplikacji web po przekazaniu dokumentów z listy

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!

Powrót do początku artykułu

Tekst

Kontrolka typu „Tekst” służy do wprowadzania dowolnych informacji zawartych na dokumencie, jak na przykład sposób dostawy, tytuł faktury, nazwa towaru, a także komentarzy lub uwag do dokumentu.

Na definicji kontrolki dostępne są następujące pola:

Nazwa wyświetlana – jest to pole, którego zawartość będzie widoczna na karcie obiegu, wartość pola nie musi być unikalna, dzięki temu możliwe jest dodanie kilku kontrolek, dla których wyświetlana jest taka sama nazwa.
Nazwa (identyfikator) – jest to pole, którego wartość widoczna jest wyłącznie we właściwościach kontrolki. Wartość tego pola musi być unikalna w ramach karty obiegu.
Prezentuj na całej szerokości – zaznaczenie tej właściwości spowoduje wyświetlenie kontrolki na całej szerokości okna „Karta obiegu”.
Ustaw kontrolkę na początku wiersza – parametr odpowiada za ustawienie kontrolki na początku nowego wiersza karty obiegu, bez konieczności dodawania separatorów pomiędzy kontrolką bieżącą, a kontrolką poprzednią. Możliwość użycia parametru „Ustaw kontrolkę na początku wiersza” uzależniona jest od wartości parametru „Prezentuj na całej szerokości”. Gdy zaznaczono parametr „Prezentuj na całej szerokości”, nie ma możliwości użycia parametru „Ustaw kontrolkę na początku wiersza”. Gdy parametr „Ustaw kontrolkę na początku wiersza” jest zaznaczony, parametr „Prezentuj na całej szerokości” jest dostępny, jego zaznaczenie spowoduje wyłączenie i dezaktywację parametru „Ustaw kontrolkę na początku wiersza”.
Max długość – określa maksymalną długość wprowadzanego tekstu – max 900 znaków.
Tekst wielolinijkowy – określa liczbę wierszy wyświetlanego pola tekstowego. Dopuszczalna liczba to 100 linijek.
Pokaż na liście – parametr odpowiedzialny za to, czy na liście dokumentów zawężonej do typu obiegu, na którym dodano kontrolkę, będzie wyświetlana kolumna z wartościami kontrolki.

Uwaga

Aby parametr „Pokaż na liście” działał poprawnie, zarówno w przypadku starego jak i nowego trybu uprawnień należy przestrzegać następujących zaleceń:

nie można używać nawiasów kwadratowych
nazwa wyświetlana kontrolek może mieć maksymalnie 128 znaków (dotyczy kontrolek, które mają być wyświetlane na liście)

Sekcja Inicjowanie wartości

Inicjowanie – pole może przyjąć wartość: Brak, SQL OD lub C# Script.

Gdy wybrana jest wartość „Brak”, właściwości kontrolki nie ulegają zmianie, działanie samej kontrolki nie zmienia się, kontrolka działa jak dotychczas.

W przypadku wartości „SQL OD” pojawia się możliwość zdefiniowania zapytania SQL za pomocą, którego będą inicjowane wartości w kontrolce na karcie obiegu.

Parametr „Inicjuj przy każdym otwarciu dokumentu”

W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu C#, który będzie inicjował wartości w kontrolce.

Uwaga

Od wersji 2023.1.2 jeżeli operator w ramach pola „Inicjowanie” wybierze wartość SQL OD, SQL ERP lub C# Script, ale nie kliknie w link „Ustaw” i nie wprowadzi zapytania, wówczas przy próbie zapisu typu obiegu zostanie wyświetlony komunikat, a zmiany nie zostaną zapisane.

W takim przypadku należy zmienić wartość pola „Inicjowanie” na „Brak” albo wprowadzić brakujące zapytanie.

W ramach komunikatu podane są nazwa i identyfikator kontrolki, dla której nie wprowadzono wymaganego zapytania oraz opcja wybrana w polu „Inicjowanie” tej kontrolki.

Przykładowy komunikat wyświetlany przy próbie zapisania typu obiegu, gdy na definicji kontrolki „Tekst 1” w polu „Inicjowanie” wybrano opcję „SQL ERP” oraz na definicji kontrolki „Tekst 2” w polu „Inicjowanie” wybrano opcję „SQL OD”, ale nie wprowadzono zapytań

Inicjuj przy każdym otwarciu – parametr widoczny, jeśli w polu „Inicjowanie” wybrano „SQLOD” lub „C# Script”; zaznaczenie parametru powoduje, że wartości wyświetlane w kontrolce będą inicjowane każdorazowo, gdy dokument zostanie otwarty w etapie, w którego właściwościach włączono inicjalizację SQL/C#. Odznaczenie parametru oznacza, że wartość zostanie zainicjowana raz.
Dokument – pole widoczne, jeśli w polu „Inicjowanie” wybrano „Brak”; w tym polu można wybrać nazwę (identyfikator) wcześniej zdefiniowanej w danym obiegu kontrolki typu Dokument elektroniczny, z której wartość ma zostać zmapowana do kontrolki typu tekst (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.
Pole – pole widoczne, jeśli w polu „Inicjowanie” wybrano „Brak”; w tym polu można wybrać kolumnę z bazy danych Comarch ERP XL, której wartość zostanie zmapowana do kontrolki typu tekst (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.

Przyklad

Przykład inicjowania kontrolki typu „Tekst” za pomocą zapytania SQL:

Administrator chce, aby na każdym nowym dokumencie w kontrolce typu tekst o nazwie „Ulica” domyślnie był wyświetlany tekst „ul.”. W tym celu we właściwościach kontrolki w polu „Inicjowanie” ustawia „SQLOD”, klika „ustaw” i wpisuje następujące zapytanie:

 select 'ul.'

Inicjowanie kontrolki typu tekst o nazwie „Ulica” za pomocą zapytania SQL

Następnie przechodzi do zakładki „Schemat obiegu”, klika na etap „Rejestracja” i w sekcji „Kontrolki” przy kontrolce „Ulica” zaznacza parametr „Inicjalizacja SQL/C#”. Następnie zapisuje typ obiegu.

Zaznaczanie etapu, na którym ma nastąpić inicjalizacja kontrolki „Ulica”

Przykład inicjowania kontrolki typu „Tekst” za pomocą kodu C#:

Administrator chce, aby na każdym nowym dokumencie w kontrolce typu tekst o nazwie „Ulica” domyślnie był wyświetlany tekst „ul.”. W tym celu we właściwościach kontrolki w polu „Inicjowanie” ustawia „C# Script”, klika „Ustaw” i wpisuje następujące zapytanie:

 Globals.MainFrame.ulica.Text="ul."

Inicjowanie kontrolki typu tekst o nazwie „Ulica” za pomocą kodu C#

Następnie administrator klika w ramach okna na ikonkę [Kompiluj i zapisz], a potem, po zamknięciu okna, przechodzi do zakładki „Schemat obiegu”, klika na etap „Rejestracja” i w sekcji „Kontrolki” przy kontrolce „Ulica” zaznacza parametr „Inicjalizacja SQL/C#”. Następnie zapisuje typ obiegu.

Kontrolka „Ulica” na nowym dokumencie

Zarówno w przypadku zainicjowania kontrolki za pomocą zapytania SQL, jak i za pomocą kodu C#, od tej pory na każdym nowoutworzonym dokumencie w kontrolce „Ulica” automatycznie wyświetlany jest tekst „ul.” – operator może dopisać tekst lub, w razie potrzeby, zmienić tekst „ul.” na inny.

Nowy dokument – w kontrolce „Ulica” automatycznie wprowadzony został tekst „ul.”

Zmiana wartości (Obserwator)

W ramach tej sekcji znajdują się następujące pola:

Kontrolki powiązane – kontrolka prezentująca listę kontrolek powiązanych, na podstawie których wyliczana jest wartość kontrolki wynikowej. Kontrolka wynikowa to kontrolka, na której zostało zdefiniowane wyrażenie np. arytmetyczne z użyciem kontrolek powiązanych.
Wzór na wartość – formatka, na której zdefiniowane zostało wyrażenie, na podstawie którego zostanie wyliczona wartość kontrolki wynikowej przy użyciu kontrolek powiązanych. Lista rozwijalna prezentuje wartości: Wyrażenie, SQL OD, SQL ERP lub C# Script .

Przyklad

Administrator dodał w definicji typu obiegu następujące kontrolki typu Tekst:

Imię (identyfikator: imie)
Nazwisko (identyfikator: nazwisko)
Ulica (identyfikator: ulica)
Numer mieszkania (identyfikator: numer_mieszkania)
Kod pocztowy (identyfikator: Kod)
Miasto (identyfikator: miasto)
Dane osobowe (łącznie) (identyfikator: Dane)

Administrator chce, aby w kontrolce Dane osobowe (łącznie) wyświetlone zostały dane z wszystkich pozostałych wymienionych kontrolek typu tekst.

W tym celu we właściwościach kontrolki Dane osobowe (łącznie) w polu Kontrolki powiązane klika w link Dodaj i kolejno wybiera kontrolki Imię, Nazwisko, Ulica, Numer mieszkania, Kod pocztowy i Miasto.

Wersja z zastosowaniem zapytania SQL

Następnie w polu „Wzór na wartość” administrator ustawia „SQLOD”, klika „Ustaw” i wpisuje następujące zapytanie (gdzie parametr @nowaLinia odpowiada za umiejscowienie następującego po nim fragmentu tekstu w nowej linijce, a ’ ’ to odstęp między kolejnymi wartościami kontrolek):

declare @nowaLinia varchar(max) = char(13) + char(10)

select  @imie@  + ' ' +  @nazwisko@ + @nowaLinia
+ @ulica@ + ' '+  @numer_mieszkania@ + @nowaLinia
+  @Kod@ + ' '+  @miasto@

Wprowadzanie zapytania SQL w kontrolce „Dane osobowe (łącznie)”

Następnie administrator zapisuje typ obiegu.

Od tej pory kiedy operator uzupełni kontrolki tekstowe Imię, Nazwisko, Ulica, Numer mieszkania, Kod pocztowy i Miasto, wtedy wszystkie ich wartości zostaną zapisane w kontrolce Dane osobowe (łącznie).

Kontrolka „Dane osobowe (łącznie)” uzupełniona wartościami z pozostałych kontrolek typu Tekst

Wersja z zastosowaniem kodu C#

Ten sam cel można osiągnąć za pomocą kodu C# – wówczas (po dodaniu kontrolek powiązanych) w polu „Wzór na wartość” administrator ustawia „C# Script”, klika „Ustaw” i wpisuje następujące zapytanie (gdzie parametr Environment.NewLine odpowiada za umiejscowienie następującego po nim fragmentu tekstu w nowej linijce, a ’ ’ to odstęp między kolejnymi wartościami kontrolek):

Globals.MainFrame.dane.Text= Globals.MainFrame.imie.Text + ' ' 
+ Globals.MainFrame.nazwisko.Text
+ Environment.NewLine + Globals.MainFrame.ulica.Text +' ' 
+ Globals.MainFrame.numer_mieszkania.Text
+ Environment.NewLine + Globals.MainFrame.Kod.Text + ' ' 
+ Globals.MainFrame.miasto.Text

Wprowadzanie kodu C# w kontrolce „Dane osobowe (łącznie)”

Następnie administrator klika w ramach okna na ikonkę [Kompiluj i zapisz], a potem po zamknięciu okna zapisuje typ obiegu.

Sekcja dotycząca rejestracji współrzędnych GPS i kodów kreskowych

Rejestruj współrzędne GPS – parametr wprowadzony w wersji 2024.1.0; jeśli parametr jest zaznaczony, wówczas w aplikacji mobilnej Comarch DMS aktywna jest obsługa GPS (zob. Obsługa GPS w aplikacjach mobilnych)
Rejestruj kody kreskowe – parametr wprowadzony w wersji 2025.0.0; jeśli parametr jest zaznaczony, wówczas w aplikacji mobilnej Comarch DMS możliwe jest skanowanie i zapisywanie kodów kreskowych w ramach danej kontrolki typu Tekst (zob. Skanowanie i zapisywanie kodu kreskowego w kontrolce typu Tekst w aplikacjach mobilnych Comarch DMS )

Uwaga

Jeżeli we właściwościach kontrolki typu Tekst zaznaczono parametr „Rejestruj współrzędne GPS”, wówczas nie można edytować tej kontrolki w aplikacjach: desktop i web.

Obsługa GPS w aplikacjach mobilnych

W wersji 2024.1.0 udostępniono obsługę GPS w aplikacjach mobilnych.

Dodanie parametru „Rejestruj współrzędne GPS” w aplikacji desktop

Aby włączyć obsługę GPS, należy na definicji kontrolki typu Tekst w aplikacji desktop Comarch DMS zaznaczyć nowododany parametr „Rejestruj współrzędne GPS”.

Domyślnie parametr jest odznaczony – wówczas obsługa GPS nie jest aktywna.

Podobnie jak w przypadku tekstu wprowadzonego ręcznie do kontrolki, kontrolka z wprowadzonymi współrzędnymi geograficznymi może być dostępna do edycji lub jedynie do odczytu, zależnie od ustawień dla danej kontrolki na danym etapie.

Zaznaczanie parametru „Rejestruj współrzędne GPS” na definicji kontrolki typu Tekst w aplikacji desktop

Uwaga

Parametr „Rejestruj współrzędne GPS” wpływa jedynie na aplikacje mobilne Comarch DMS.

Dodanie ikony dotyczącej współrzędnych GPS w aplikacjach mobilnych

Jeżeli operator zaznaczy parametr „Rejestruj współrzędne GPS” i zapisze zmiany, wówczas w ramach danej kontrolki typu Tekst w aplikacji mobilnej dostępna będzie ikona .

Po kliknięciu w ikonę aktualne współrzędne geograficzne urządzenia, na którym zainstalowano aplikację Comarch DMS, zostaną pobrane i wprowadzone do danej kontrolki typu tekst.

Uwaga

Pobieranie współrzędnych GPS może zająć klika minut.

Widok kontrolki typu Tekst w aplikacji iOS Comarch DMS przed uzupełnieniem, jeśli zaznaczono parametr „Rejestruj współrzędne GPS”

Widok kontrolki typu Tekst w aplikacji iOS Comarch DMS po kliknięciu w ikonę pobierania współrzędnych GPS

Widok kontrolki typu Tekst w aplikacji Android Comarch DMS przed uzupełnieniem, jeśli zaznaczono parametr „Rejestruj współrzędne GPS”

Widok kontrolki typu Tekst w aplikacji Android Comarch DMS po kliknięciu w ikonę pobierania współrzędnych GPS

Skanowanie i zapisywanie kodu kreskowego w kontrolce typu Tekst w aplikacjach mobilnych Comarch DMS

W wersji 2025 umożliwiono skanowanie oraz zapisywanie kodu kreskowego w kontrolce typu Tekst w aplikacjach mobilnych Comarch DMS na systemy: Android i iOS.

W wersji 2025.0.0 w aplikacji desktop Comarch DMS na definicji kontrolki typu Tekst dodano parametr „Rejestruj kody kreskowe”. Domyślnie parametr jest odznaczony – wówczas kontrolka typu Tekst działa w aplikacjach mobilnych tak samo, jak do tej pory.

Jeżeli parametr „Rejestruj kody kreskowe” został zaznaczony, wówczas w aplikacji mobilnej Comarch DMS możliwe jest skanowanie i zapisywanie kodów kreskowych w ramach danej kontrolki typu Tekst.

Uwaga

W przypadku, jeśli parametr „Rejestruj współrzędne GPS” jest zaznaczony, wówczas operator nie może zaznaczyć parametru „Rejestruj kody kreskowe”.

Analogicznie, jeśli parametr „Rejestruj kody kreskowe” jest zaznaczony, wówczas operator nie może zaznaczyć parametru „Rejestruj współrzędne GPS”.

Uwaga

Parametr „Rejestruj kody kreskowe” ma wpływ wyłącznie na działanie aplikacji mobilnych Comarch DMS na systemy: iOS i Android.

Analogicznie, jeśli parametr „Rejestruj kody kreskowe” jest zaznaczony, wówczas operator nie może zaznaczyć parametru „Rejestruj współrzędne GPS”.

Zaznaczony parametr „Rejestruj kody kreskowe” na definicji kontrolki typu Tekst

Analogicznie jak w przypadku innych kontrolek typu Tekst dla kontrolki z zaznaczonym parametrem „Rejestruj kody kreskowe” na zakładce „Schemat obiegu”, na zakładce „Kontrolki” można zaznaczyć parametry: „Widoczna”, „Tylko do odczytu” i „Wymagana”.

Uwaga

W przypadku, jeśli na danej kontrolce zaznaczono parametr „Rejestruj kody kreskowe”, a ta kontrolka jest wymagana na danym etapie, wówczas wartość kontrolki można uzupełnić jedynie z poziomu aplikacji mobilnej Comarch DMS.

Od wersji 2025.0.0 w przypadku, jeśli w aplikacji desktop Comarch DMS na definicji kontrolki typu Tekst zaznaczono parametr „ Rejestruj kody kreskowe”, wówczas podczas dodawania albo edycji dokumentu w ramach typu obiegu, w którym znajduje się dana kontrolka, możliwe jest zeskanowanie i zapisanie kodu kreskowego.

Aby zeskanować kod kreskowy, należy kliknąć w ikonę w kontrolce, na której definicji zaznaczono parametr „Rejestruj kody kreskowe”. Wówczas zostanie uruchomiony aparat, który należy skierować na kod kreskowy, który ma zostać zeskanowany. Jeśli kod kreskowy został poprawnie odczytany, zostanie następnie zapisany jako ciąg znaków w danej kontrolce typu Tekst.

Uwaga

Kontrolka typu Tekst z zaznaczonym parametrem „Rejestruj kody kreskowe” może zostać uzupełniona wyłącznie z poziomu aplikacji mobilnej Comarch DMS, za pomocą aparatu fotograficznego.

Widok dokumentu z kontrolką „Kod kreskowy”, dla której zaznaczono parametr „Rejestruj kody kreskowe” w aplikacji mobilnej na system iOS (przed skanowaniem kodu)

Widok dokumentu z kontrolką „Kod kreskowy”, dla której zaznaczono parametr „Rejestruj kody kreskowe” w aplikacji mobilnej na system iOS (po skanowaniu kodu)

Umożliwienie skanowania i zapisywania kodu kreskowego w kontrolce typu Tekst w aplikacji na system iOS

W wersji 2025 umożliwiono skanowanie oraz zapisywanie kodu kreskowego w kontrolce typu Tekst w aplikacjach mobilnych Comarch DMS na systemy: Android i iOS.

Dodanie parametru „Rejestruj kody kreskowe” na definicji kontrolki typu Tekst

Uwaga

W przypadku, jeśli parametr „Rejestruj współrzędne GPS” jest zaznaczony, wówczas operator nie może zaznaczyć parametru „Rejestruj kody kreskowe”.

Analogicznie, jeśli parametr „Rejestruj kody kreskowe” jest zaznaczony, wówczas operator nie może zaznaczyć parametru „Rejestruj współrzędne GPS”.

Uwaga

Parametr „Rejestruj kody kreskowe” ma wpływ wyłącznie na działanie aplikacji mobilnych Comarch DMS na systemy: iOS i Android.

Analogicznie, jeśli parametr „Rejestruj kody kreskowe” jest zaznaczony, wówczas operator nie może zaznaczyć parametru „Rejestruj współrzędne GPS”.

Uwaga

Skanowanie kodu kreskowego i zapisywanie go w kontrolce typu Tekst w aplikacji mobilnej Comarch DMS na system iOS

Uwaga

Kontrolka typu Tekst z zaznaczonym parametrem „Rejestruj kody kreskowe” może zostać uzupełniona wyłącznie z poziomu aplikacji mobilnej Comarch DMS, za pomocą aparatu fotograficznego.

Umożliwienie skanowania i zapisywania kodu kreskowego w kontrolce typu Tekst w aplikacji na system Android

W wersji 2025 umożliwiono skanowanie oraz zapisywanie kodu kreskowego w kontrolce typu Tekst w aplikacjach mobilnych Comarch DMS na systemy: Android i iOS.

Dodanie parametru „Rejestruj kody kreskowe” na definicji kontrolki typu Tekst

Uwaga

W przypadku, jeśli parametr „Rejestruj współrzędne GPS” jest zaznaczony, wówczas operator nie może zaznaczyć parametru „Rejestruj kody kreskowe”.

Analogicznie, jeśli parametr „Rejestruj kody kreskowe” jest zaznaczony, wówczas operator nie może zaznaczyć parametru „Rejestruj współrzędne GPS”.

Uwaga

Parametr „Rejestruj kody kreskowe” ma wpływ wyłącznie na działanie aplikacji mobilnych Comarch DMS na systemy: iOS i Android.

Analogicznie, jeśli parametr „Rejestruj kody kreskowe” jest zaznaczony, wówczas operator nie może zaznaczyć parametru „Rejestruj współrzędne GPS”.

Uwaga

Skanowanie kodu kreskowego i zapisywanie go w kontrolce typu Tekst w aplikacji mobilnej Comarch DMS na system iOS

Uwaga

Kontrolka typu Tekst z zaznaczonym parametrem „Rejestruj kody kreskowe” może zostać uzupełniona wyłącznie z poziomu aplikacji mobilnej Comarch DMS, za pomocą aparatu fotograficznego.