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, Dokumenty związane, Dokument ERP XL, Dane tabelaryczne) – umożliwiają wiązanie dokumentów, kontrahenta lub towaru z programu Comarch ERP XL do aplikacji Comarch DMS. Kontrolka Dokumenty związane prezentuje wiązanie dokumentów pomiędzy aplikacją Comarch DMS, a systemem Comarch ERP XL. Kontrolka Dokument ERP XL prezentuje numer dokumentu w systemie Comarch ERP XL, który został wygenerowany z poziomu aplikacji Comarch DMS wraz z opisem analitycznym lub dowiązany z systemu Comarch EPR XL.
- 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.
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 ERP XL
- Dokumenty w obiegu
- Dokumenty związane
- 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-1101.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# Script 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 XL.
- Pole – kontrolka występująca na kontrolkach prostych. Nazwa kolumny z tabeli Comarch ERP XL, z której ma być pobrana wartość do odczytu. Kontrolka powiązana z kontrolką Dokument.
- 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. Funkcjonalność pozwala na podłączenie załączników z aplikacji Comarch DMS pod wygenerowany dokument w systemie Comarch ERP XL. Funkcjonalność mapowania uzależniona jest od ustawień w pliku web.config.
- Pokaż na liście – 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 XL, które zostaną wczytane do aplikacji Comarch DMS: (A)FS, (A)FZ, DP, FSE, FAI, FS, FS VAT RR, UNM, NM, , FZ, KK, OS, OZ, PA, MMP, MMW, MP, PW, PM, PZ, RS, RW, TAX FREE, Umowy, KDZ, WKA, PKA, WM, WZ, WZE, ZS, ZZ, ZOS, ZOZ, WYS, PC, Promocje, FW, RLS, RLZ, ZSR.
- 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.
- Tryb pracy, zakładka ERP XL – pole dostępne na właściwościach kontrolki Dokument ERP XL. Przyjmuje wartości: dla nagłówka i dla elementu. Określa, w jakim trybie będzie opisywany analitycznie dokument. Określa także czy dokument generowany w tym typie obiegu będzie miał elementy czy nie.
- 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 XL.
- 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 lub SQL ERP.
- Wersjonowanie pliku – właściwość kontrolki typu Załącznik. Umożliwia podpięcie kilku wersji tego samego pliku do kontrolki typu Załącznik na szczegółach dokumentu
- 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.
- Pogrubione pola API na karcie obiegu są polami wymagalnymi i muszą zostać uzupełnione w celu dokumentu.
- Wybierz centrum – właściwość kontrolki typu Dokument ERP XL. Wybrana wartość określa centrum struktury praw, w którym zostanie utworzony dokument.
- 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 XL