W lewej części okna definicji obiegu dokumentów prezentowane są kontrolki konfigurowanego typu obiegu.
![](https://pomoc.comarch.pl/dms/pl/20211/wp-content/uploads/2019/11/word-image-905.png)
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.
Panel „Kontrolki” na definicji obiegu dokumentu
Lista typów kontrolek jest predefiniowana i nie można jej modyfikować. Zawiera następujące elementy:
- Dane tabelaryczne
- Data i godzina
- Dokument elektroniczny
- Dokument w obiegu
- Etykieta
- Komunikat
- Kontrahent
- Liczba całkowita
- Liczba rzeczywista
- Liczba stałoprzecinkowa
- Lista
- Separator
- Tekst
- Towar
- URL
- Wartość logiczna
- Własna akcja
- Właściciel
- Załącznik
![](https://pomoc.comarch.pl/dms/pl/20211/wp-content/uploads/2019/11/word-image-906.png)
Pełna 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 (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# lub Słownik.
- 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.
- Kontrahent – przyjmuje wartość Brak lub nazwę kontrolki typu Kontrahent z karty obiegu do mapowania wartości.
- Płatnik – przyjmuje wartość Brak lub nazwę kontrolki typu Kontrahent z karty obiegu do mapowania wartości.
- Wartość netto – przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania wartości dokumentu. Istnieje możliwość przypisania kontrolki typu liczba całkowita, liczba rzeczywista, liczba stałoprzecinkowa.
- Waluta – przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania wartości dokumentu. Istnieje możliwość przypisania kontrolki typu tekst i lista.
- Opis – przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania wartości. Istnieje możliwość przypisania kontrolki typu tekst i lista.
- Załączniki – przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu typu załącznik.
- Lista zdefiniowanych kontrolek – wybranie wartości Tak wyświetli kolumnę z nazwą kontrolki i wartościami kontrolek z poszczególnych dokumentów na liście dokumentów.
- 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.
- Typ – lista dostępnych typów dokumentów z programu Comarch ERP Optima, które zostaną wczytane do aplikacji Comarch DMS: Faktura sprzedaży (FA).
- 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.
- 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.
- 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 ERP Optima.
- Pogrubione pola we właściwościach kontrolek są polami wymaganymi i muszą zostać uzupełnione w celu zapisania typu obiegu.