Informacje ogólne

W lewej części okna definicji obiegu dokumentów prezentowane są kontrolki konfigurowanego typu obiegu.

Okno podglądu karty obiegu – przykład

Pierwszym krokiem tworzenia nowego typu obiegu jest dodanie kontrolek służących do wprowadzania danych.

Kontrolki dostępne w aplikacji Comarch DMS możemy podzielić na trzy typy:

Kontrolki proste (Liczba całkowita, Liczba rzeczywista, Liczba stałoprzecinkowa, Data i godzina, Tekst, Lista, Wartość logiczna).
Kontrolki elektroniczne (Dokument elektroniczny, Kontrahent, Towar, Dane tabelaryczne) – umożliwiają wiązanie dokumentów, kontrahenta lub towaru z programu Comarch ERP Optima do aplikacji Comarch DMS.
Kontrolki pozostałe (Załącznik, Właściciel, Własna akcja, Separator, Etykieta)

Aby dodać kontrolkę do listy należy kliknąć przycisk [Dodaj] w panelu „Kontrolki”. Pojawi się formatka, na której z rozwijalnej listy należy wybrać typ kontrolki oraz wprowadzić nazwę. W panelu „Podgląd karty obiegu” pojawi się podgląd kontrolki.

Na poniższym filmie przedstawiono dodawanie kontrolki typu data i godzina:

https://pomoc.comarch.pl/dms/wp-content/uploads/2023/11/kontrolki2.mp4

Dodawanie nowej kontrolki

Przykładowe właściwości kontrolki

Lista typów kontrolek jest predefiniowana i nie można jej modyfikować. Zawiera następujące elementy (po kliknięciu na daną pozycję nastąpi przeniesienie do artykułu poświęconego danemu typowi kontrolki):

Przykładowa lista właściwości kontrolek składa się z następujących elementów:

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 kontrolki nie może zawierać więcej niż 128 znaków.
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.
Inicjowanie – w zależności od typu kontrolki przyjmuje wartość Brak, SQL OD, SQL ERP, C# Script lub Słownik.

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 „Numer dokumentu” w polu „Inicjowanie” wybrano opcję „SQL ERP”, ale nie wprowadzono zapytania

Dokument – pole występujące na kontrolkach prostych. W tym polu można wybrać dokument z kontrolki „Dokument elektroniczny”. Kontrolka będzie prezentować wartość z dokumentu z bazy Comarch ERP Optima.
Czas – wybranie opcji Tak umożliwia wprowadzanie godzin, minut i sekund na kontrolce typu Data i godzina.
Wartości – właściwość kontrolki typu Lista. Umożliwia zdefiniowanie słownika pozycji danej kontrolki. Wprowadzenie wartości następuje po kliknięciu klawisza Enter.
Max długość – właściwość kontrolki typu Tekst. Określa maksymalną długość wprowadzanego tekstu – max 900 znaków.
Tekst wielolinijkowy – właściwość kontrolki typu Tekst. Określa liczbę wierszy wyświetlanego pola tekstowego. Dopuszczalna liczba to 100 linijek.
Tryb pracy – właściwość kontrolki typu Lista. Przyjmuje wartości: Lista i Wyszukiwanie.
Dokumenty – właściwość kontrolki typu Dokumenty w obiegu. Przyjmuje wartości: Wszystkie lub Aktywne.
Plik wykonywalny – właściwość kontrolki typu Własna akcja, w której należy podać nazwę pliku wykonywalnego.
Procedura – właściwość kontrolki typu Własna akcja, w której należy podać nazwę procedury znajdującej się w bazie Comarch DMS.
Procedura ERP – właściwość kontrolki typu Własna akcja, w której należy wprowadzić nazwę procedury z bazy Comarch ERP Optima.
C# Script – właściwość kontrolki typu Własna akcja w wersji Comarch DMS Premium, po kliknięciu w link „Ustaw” zostanie otwarte okno Skrypt C#, w którym można wpisać zapytanie w C#
Kontrolki powiązane – kontrolka prezentująca listę kontrolek powiązanych (w tym kontrolka typu „Lista”) 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#.
Wersjonowanie pliku – właściwość kontrolki typu Załącznik. Umożliwia podpięcie na dokumencie kilku wersji tego samego pliku, z zaznaczeniem kolejności wersji.
Prezentuj na całej szerokości – właściwość każdego typu kontrolki. Umożliwia zaprezentowanie kontrolki na całej szerokości karty obiegu na szczegółach dokumentu.
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ą.

Uwaga

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

Tytuł – właściwość kontrolki typu Komunikat. Wprowadzona wartość zostanie zaprezentowana jako tytuł na oknie wyświetlonego komunikatu.
Nazwa Spółki – właściwość kontrolek elektronicznych dostępna tylko podczas pracy z funkcjonalnością Wielofirmowość. Prezentuje listę zdefiniowanych spółek na zakładce Połączenia z ERP.
Pogrubione pola we właściwościach kontrolek są polami wymaganymi i muszą zostać uzupełnione w celu zapisania typu obiegu.
Liczba prezentowanych wierszy – właściwość kontrolki typu Dane tabelaryczne; określa liczbę wierszy tabeli prezentowaną na dokumencie
Kolumny – właściwość kontrolki typu Dane tabelaryczne; po kliknięciu w link „Dodaj” możliwe jest zdefiniowanie kolejnych kolumn tabeli
Manager dokumentów – parametr dostępny na zakładce „Archiwa” we właściwościach kontrolki typu Załącznik, jeśli praca z Managerem dokumentów jest aktywna, zaznaczenie parametru umożliwia załączanie plików umieszczonych w managerze dokumentów
Zapisz do Repozytorium – parametr dostępny na zakładce „Archiwa” we właściwościach kontrolki typu Załącznik, jeśli współpraca z modułem Comarch DMS Repozytorium jest aktywna, zaznaczenie parametru umożliwia dodanie załącznika do modułu Comarch DMS Repozytorium (zob. Konfiguracja kontrolki typu Załącznik w ramach integracji modułu Repozytorium z modułem Workflow);
Liczba miejsc po przecinku, do której będzie zaokrąglana wartość – pole wprowadzone w wersji 2024.0.0; znajduje się na definicji kontrolki typu Liczba stałoprzecinkowa i służy do określenia, do ilu miejsc po przecinku będzie zaokrąglana wprowadzona liczba (od 0 do 6).
Rejestruj współrzędne GPS – parametr wprowadzony w wersji 2024.1.0; znajduje się na definicji kontrolki typu Tekst; jeśli parametr jest zaznaczony, wówczas w aplikacji mobilnej Comarch BPM aktywna jest obsługa GPS (zob. Obsługa GPS w aplikacji na system iOS i Obsługa GPS w aplikacji na system Android);
Rejestruj kody kreskowe – parametr wprowadzony w wersji 2025.0.0; znajduje się na definicji kontrolki typu Tekst; jeśli parametr jest zaznaczony, wówczas w aplikacji mobilnej Comarch BPM 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 BPM);
Mobilny podpis – parametr wprowadzony w wersji 2024.3.0; znajduje się na definicji kontrolki typu Załącznik; domyślnie odznaczony. Zaznaczenie parametru powoduje zmianę w działaniu kontrolki typu załącznik – zob. Podpis mobile na kontrolce typu Załącznik
Zablokuj usuwanie załączników – parametr wprowadzony w wersji 2024.3.0; znajduje się na definicji kontrolki typu Załącznik; domyślnie odznaczony. Jeśli parametr zostanie zaznaczony, wówczas żaden operator na żadnym etapie nie będzie mógł usunąć pliku/plików z danej kontrolki typu Załącznik (zob. Załącznik);
Automatyczna archiwizacja dokumentu w Repozytorium – parametr wprowadzony w wersji 2025.1.0; znajduje się na definicji kontrolki typu Załącznik; widoczny jedynie w przypadku, jeśli operator zaznaczył parametr „Współpraca z Repozytorium” i ustawił typ/typy dokumentów; domyślnie odznaczony. Jeśli parametr zostanie zaznaczony, wówczas poniżej pojawi się pole „Etap archiwizacji”, w którym dostępna jest lista etapów, które zdefiniowano dla danego typu obiegu. Na wybranym etapie nastąpi archiwizacja dokumentu w Repozytorium (zob. Wprowadzenie opcji automatycznej archiwizacji dokumentów z Workflow w Repozytorium);
Pozwalaj na wybór lokalizacji podczas dodawania załącznika – parametr wprowadzony w wersji 2025.2.0; w przypadku współpracy z modułem Repozytorium jeżeli parametr „Pozwalaj na wybór lokalizacji podczas dodawania załącznika” został zaznaczony, wówczas podczas dodawania załącznika na dokumencie Comarch BPM zostanie otwarte okno, w którym operator może wybrać lokalizację w Comarch BPM Repozytorium, w której ma zostać zapisany dany załącznik (zob. Możliwość wyboru lokalizacji zapisu załącznika w Comarch BPM Repozytorium);
Odśwież po wykonaniu – parametr wprowadzony w wersji 2026.0.0; znajduje się na definicji kontrolki typu Własna akcja; jeśli checkbox „Odśwież po wykonaniu” jest zaznaczony, wówczas po wykonaniu akcji określonej w danej kontrolce karta obiegu zostanie przeładowana bez zapisywania obiegu.

Uwaga

Jeśli operator zaznaczył parametr „Odśwież po wykonaniu”, a nie zaznaczył parametru „Zapisz przed uruchomieniem”, wówczas zmiany, które wprowadzono w innych kontrolkach, nie zostaną zapisane, zaś uruchomienie własnej akcji spowoduje utratę niezapisanych zmian. Okno z pytaniem o zapis zmian nie jest wyświetlane.

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

Sprawdź Szkolenia Comarch BPM!

Powrót do początku artykułu