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.
Na poniższym filmie przedstawiono dodawanie kontrolki typu data i godzina:
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.
- 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 – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; przyjmuje wartość Brak lub nazwę kontrolki typu Kontrahent z karty obiegu do mapowania wartości.
- Płatnik – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; przyjmuje wartość Brak lub nazwę kontrolki typu Kontrahent z karty obiegu do mapowania wartości.
- Wartość netto – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; 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 – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania wartości dokumentu. Istnieje możliwość przypisania kontrolki typu tekst i lista.
- Rachunek bankowy – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; przyjmuje wartość Brak lub nazwę kontrolki z karty obiegu do mapowania numeru konta bankowego. Istnieje możliwość przypisania kontrolki typu tekst i lista.
- Opis – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; 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.
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)
- 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.
- Generowanie dokumentu bez OA – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; po zaznaczeniu tej opcji system pozwoli na wygenerowanie dokumentu bez wprowadzonego opisu analitycznego
- Po odwiązaniu pozostaw w dokumentach związanych – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; jeśli ta opcja jest zaznaczona, wówczas w momencie odwiązywania dokumentu informacja o związaniu dokumentów nie jest usuwana
- Typ – pole dostępne we właściwościach kontrolki typu Dokument ERP XL; 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.
- C# Script – właściwość kontrolki typu Własna akcja, 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 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.
- 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.
- Pogrubione pola API na karcie obiegu są polami wymagalnymi i muszą zostać uzupełnione w celu zapisania 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 z ERP (zob. Połączenia z ERP )
- 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).
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?
