Kontrolka przechowuje informacje o dacie lub dacie i godzinie. 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ą.
- Czas – parametr odpowiadający za to czy w kontrolce będzie prezentowana godzina, ustawienie wartości parametru na „Tak”, skutkuje wyświetlaniem daty i godziny, ustawienie wartości parametru na „Nie”, skutkuje wyświetlaniem tylko daty.
- 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)
Sekcja Inicjowanie wartości
- Inicjowanie – pole 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”.
Dla wartości „C# Script” możliwe jest inicjowanie kontrolki za pomocą kodu w języku C#.
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.
- Inicjuj przy każdym otwarciu – parametr widoczny , jeśli w polu „Inicjowanie” wybrano „SQLOD”, „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 inicjowanie SQL lub C#. Odznaczenie parametru oznacza, że działanie aplikacji w zakresie inicjowania będzie odbywało się jak dotąd, czyli wartość zostanie zainicjowana raz.
- Dokument – pole widoczne, jeśli w polu „Inicjowanie” wybrano „Brak”; w tym polu można wybrać nazwę (identyfikator) wcześniej zdefiniowanej w danym obiegu kontrolki typu Dokument elektroniczny, z której wartość ma zostać zmapowana do kontrolki typu data i godzina (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.
- Pole – pole widoczne, jeśli w polu „Inicjowanie” wybrano „Brak”; w tym polu można wybrać kolumnę z bazy danych Comarch ERP XL, której wartość zostanie zmapowana do kontrolki typu data i godzina (zob. Dokument elektroniczny). Pole aktywne tylko dla współpracy z Comarch ERP XL.
Kontrolka typu „Data i godzina” może być wykorzystywana, jako kontrolka, w której użytkownik wprowadza na karcie obiegu na szczegółach dokumentu np. datę wpływu dokumentu.
Jeżeli w konfiguracji tej kontrolki wprowadzone jest zapytanie SQL-owe, można na jego podstawie z bazy pobrać konkretną wartość, którą aplikacja automatycznie wprowadzi do pola kontrolki.
select GetDate()
Sekcja Zmiana wartości (Obserwator)
Możliwe jest wypełnianie wartości kontrolki typu Data i godzina na podstawie wartości kontrolek powiązanych, za pomocą zapytania SQL lub używając kodu C# (zob. Wypełnianie wartości kontrolki w oparciu o wartości innej kontrolki).
