Kontrolka typu „Towar” umożliwia wczytywanie towaru z listy towarów zdefiniowanych w programie Comarch ERP XL.
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”.
- Nazwa Spółki – właściwość kontrolek elektronicznych dostępna tylko podczas pracy z funkcjonalnością Wielofirmowość. Prezentuje listę spółek zdefiniowanych na zakładce Połączenia z ERP.
- 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.
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)
W sekcji „Podgląd karty obiegu” po dodaniu tej kontrolki, prezentowany jest przycisk 
, który otwiera listę towarów z programu Comarch ERP XL.
Gdy towar został już dodany w ramach kontrolki, np. 
– w kontrolce prezentowane są przyciski 
[Zmień] wywołujący listę towarów z Comarch ERP XL oraz 
[Odepnij] który usunie wskazanie na kartotekę towarową.
Inicjowanie wartości
Pole Inicjowanie może przyjąć wartość: Brak, SQL OD, SQL ERP (od wersji 2023.1.0) 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” lub „SQL ERP” pojawia się możliwość zdefiniowania zapytania SQL, za pomocą którego będą zaczytywane wartości do kontrolki na karcie obiegu w dokumencie oraz wyświetlany jest parametr „Inicjuj przy każdym otwarciu dokumentu”
- W przypadku wartości „C# Script” możliwe jest zdefiniowanie kodu w języku C#, który będzie inicjował wartości w kontrolce.
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.
- Parametr „Inicjuj przy każdym otwarciu dokumentu” (dostępny, gdy wybrano inicjowanie SQL OD, SQL ERP 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.
Administrator chce, aby w danym obiegu zawsze na nowoutworzonym dokumencie w kontrolce typu Towar wybrany był określony towar.
Baza Comarch ERP XL, z której korzysta administrator, nosi nazwę ERPXL_FirmaA.
Przykład inicjowania kontrolki typu „Towar” za pomocą zapytania SQL:
Administrator w ramach właściwości kontrolki typu Towar o nazwie „Towar” w polu „Inicjowanie” ustawia „SQLOD”, klika „Ustaw” i wpisuje następujące zapytanie:
select top 2 Twr_GIDNumer from ERPXL_FirmaA.cdn.TwrKarty
gdzie „ERPXL_FirmaA” to nazwa bazy Comarch ERP XL
Następnie przechodzi do zakładki „Schemat obiegu”, klika na etap „Rejestracja” i w sekcji „Kontrolki” przy kontrolce „Towar” zaznacza parametr „Inicjalizacja SQL/C#”. Następnie zapisuje typ obiegu.
Przykład inicjowania kontrolki typu „Towar” za pomocą kodu C#
Administrator we właściwościach kontrolki w polu „Inicjowanie” ustawia „C# Script”, klika „Ustaw” i wpisuje następujące zapytanie:
Globals.MainFrame.Towar.Id = 2
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 „Towar” zaznacza parametr „Inicjalizacja SQL/C#”. Następnie zapisuje typ obiegu.
Kontrolka „Towar” 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 „Towar” automatycznie wyświetlany towar, którego Twr_GIDNumer = 2 – choć w razie potrzeby operator może na danym dokumencie zmienić towar na inny.
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 .
