Komendy z grupy „Wykonaj operacje na kartotece/stronie” służą do wykonywania działań bezpośrednio na ekranie, na którym aktualnie pracuje użytkownik.
Za ich pomocą można między innymi:
- pokazywać i ukrywać pola formularza,
- wyświetlać komunikaty błędów przy polach,
- odświeżać zestawienia i kartoteki,
- zamykać bieżące okno,
- otwierać inne strony programu,
- otwierać zewnętrzne strony internetowe,
- wpisywać wartości do pól formularza,
- ograniczać listę dostępnych wariantów pola.
1. Warunki użycia komend #
Komendy z tej grupy mają zastosowanie wyłącznie wtedy, gdy trigger jest wykonywany w trakcie pracy użytkownika w programie.
Nie są przeznaczone do triggerów wykonywanych jako procesy w tle, ponieważ ich działanie dotyczy elementów aktualnie wyświetlanych na ekranie.
Aby można było prawidłowo konfigurować te komendy, w danych ogólnych triggera należy wskazać stronę, dla której trigger jest przeznaczony.
Jeżeli zostanie wskazana strona typu formularz, podczas konfiguracji komend program udostępni listę elementów znajdujących się na tym formularzu.
2. Pokaż ukryte pole formularza #
Komenda „Pokaż ukryte pole formularza” służy do ponownego wyświetlenia jednego lub wielu pól, które wcześniej zostały ukryte.
2.1. Sposób działania #
Pole powinno być standardowo skonfigurowane jako element formularza. Może ono następnie zostać ukryte za pomocą innego triggera, a w określonych okolicznościach ponownie pokazane.
Podczas konfiguracji komendy należy wskazać jeden lub więcej elementów formularza, które mają zostać wyświetlone.
2.2. Przykład #
Formularz zawiera dodatkowe pola związane z rozliczeniem zamówienia.
Początkowo pola te są ukryte. Gdy użytkownik wybierze określony sposób płatności, trigger może je wyświetlić.
Pozwala to budować formularze, które dynamicznie reagują na działania użytkownika.
3. Ukryj wyświetlane pole formularza #
Komenda „Ukryj wyświetlane pole formularza” pozwala ukryć jedno lub więcej pól widocznych na formularzu.
Może dotyczyć zarówno pól dostępnych w trybie edycji, jak i pól pokazywanych w trybie podglądu.
3.1. Charakter ukrycia #
Ukrycie pola ma wyłącznie charakter wizualny.
Oznacza to, że użytkownik nie widzi pola na formularzu, ale jego wartość może nadal znajdować się w kodzie strony. Osoba znająca narzędzia przeglądarki internetowej może potencjalnie uzyskać dostęp do tej wartości.
Komendy tej nie należy więc traktować jako mechanizmu ochrony poufnych danych ani jako zamiennika prawidłowo skonfigurowanych uprawnień.
3.2. Zastosowanie #
Komenda jest przydatna, gdy:
- pole nie jest potrzebne w określonym kontekście,
- formularz ma zostać uproszczony,
- użytkownik powinien widzieć tylko pola związane z wybranym wariantem,
- część pól ma być pokazywana warunkowo.
4. Pokaż błąd wypełnienia pola formularza #
Komenda „Pokaż błąd wypełnienia pola formularza” wyświetla komunikat błędu przy wskazanym elemencie formularza.
Podczas konfiguracji należy:
- wskazać jedno lub więcej pól formularza,
- zdefiniować treść komunikatu.
Program pokaże komunikat przy wybranych polach, sugerując użytkownikowi konieczność ich poprawienia.
4.1. Przykład #
Jeżeli użytkownik wpisał nieprawidłową datę albo pozostawił wymagane pole puste, trigger może wyświetlić przy tym polu komunikat:
„Uzupełnij wymagane dane”.
Komenda pozwala tworzyć własne mechanizmy walidacji formularzy.
5. Odśwież zestawienie na stronie #
Komenda „Odśwież zestawienie na stronie” ponownie wczytuje wyniki wyświetlane w zestawieniu.
Jest przydatna, gdy wcześniejsze komendy triggera zmieniły dane znajdujące się na liście.
5.1. Przykład #
Użytkownik zaznacza kilka rekordów i uruchamia opcję zmieniającą ich status.
Po zakończeniu operacji trigger wykonuje komendę odświeżenia zestawienia. Dzięki temu użytkownik od razu widzi aktualne dane.
6. Odśwież bieżącą kartotekę #
Komenda „Odśwież bieżącą kartotekę” odświeża całe aktualnie otwarte okno.
Odświeżane są między innymi:
- dane obiektu,
- zawartość formularza,
- menu kartoteki,
- pozostałe elementy strony.
Komenda jest przydatna, gdy wykonanie triggera zmieniło dane lub dostępne opcje i użytkownik powinien od razu zobaczyć aktualny stan kartoteki.
7. Zamknij bieżącą kartotekę #
Komenda „Zamknij bieżącą kartotekę” zamyka okno, które użytkownik ma aktualnie otwarte na wierzchu.
Może być stosowana na przykład po zakończeniu operacji wykonywanej w formularzu.
7.1. Przykład #
Użytkownik zatwierdza formularz uruchamiający trigger.
Po prawidłowym wykonaniu operacji trigger może:
- zapisać dane,
- wyświetlić komunikat o powodzeniu,
- zamknąć bieżącą kartotekę.
8. Otwórz stronę programu bs4 #
Komenda „Otwórz stronę programu bs4” służy do otwarcia wybranej strony dostępnej w programie.
Podczas konfiguracji należy wskazać stronę, która ma zostać otwarta.
Może to być:
- strona główna lub inna strona programu,
- zestawienie,
- formularz,
- kartoteka określonego obiektu.
8.1. Otwarcie strony dla konkretnego obiektu #
Jeżeli wybrana strona służy do edycji lub podglądu obiektu, można dodatkowo wskazać zmienną triggerową typu obiekt.
Służy do tego pole:
„Obiekt ze zmiennej triggera”.
Program otworzy wskazaną stronę dla obiektu znajdującego się w tej zmiennej.
8.2. Przykład #
Trigger tworzy nowy obiekt zadania i zapisuje go w bazie.
Następnie może otworzyć kartotekę tego zadania, aby użytkownik od razu zobaczył jego szczegóły.
9. Otwórz dowolną stronę WWW #
Komenda „Otwórz dowolną stronę WWW” pozwala otworzyć wskazany adres internetowy.
W konfiguracji należy podać pełny adres strony.
Program otworzy stronę w nowej karcie lub w odpowiednim oknie przeglądarki.
Komenda może być wykorzystywana na przykład do otwierania:
- strony kontrahenta,
- zewnętrznego systemu,
- dokumentacji,
- mapy,
- strony śledzenia przesyłki,
- serwisu partnera.
10. Wpisz wartość do pola formularza #
Komenda „Wpisz wartość do pola formularza” pozwala automatycznie wstawić wartość do wskazanego elementu formularza.
Podczas konfiguracji należy określić:
- pole formularza,
- wartość, która ma zostać wpisana.
Wartość można:
- podać bezpośrednio jako stałą,
- pobrać ze zmiennej triggerowej.
10.1. Przykład #
Po wybraniu kontrahenta trigger może automatycznie wstawić do formularza:
- domyślnego opiekuna,
- termin płatności,
- walutę,
- kategorię,
- inną wartość wynikającą z danych kontrahenta.
10.2. Pola typu lista #
Jeżeli element formularza jest listą wyboru, wartość należy wskazywać za pomocą identyfikatora wariantu.
Nie należy podawać etykiety widocznej dla użytkownika.
Przykładowo, jeżeli lista zawiera wariant „Aktywny”, trigger powinien wstawić identyfikator tego wariantu, a nie sam tekst „Aktywny”.
11. Odśwież listę wariantów pola #
Komenda „Odśwież listę wariantów pola” służy do przeładowania wariantów dostępnych w polu formularza.
Za jej pomocą można ograniczyć listę wariantów do wskazanego zestawu.
11.1. Sposób działania #
Komenda nie tworzy całkowicie nowej listy wariantów.
Punkt wyjścia stanowią warianty, które są standardowo dostępne w danym polu. Trigger może następnie ograniczyć tę listę do wybranych pozycji.
W tym celu należy wskazać zmienną triggerową typu ID zawierającą identyfikatory wariantów, które mają pozostać dostępne.
11.2. Przykład #
Pole „Status” zawiera dziesięć wariantów.
W zależności od rodzaju dokumentu użytkownik powinien mieć do wyboru tylko trzy z nich.
Trigger może przygotować zmienną typu ID z identyfikatorami tych trzech wariantów, a następnie ograniczyć listę pola formularza.
12. Podsumowanie #
Komendy z grupy „Wykonaj operacje na kartotece/stronie” umożliwiają dynamiczne sterowanie interfejsem programu.
Za ich pomocą można:
- pokazywać i ukrywać pola,
- wyświetlać błędy walidacji,
- wpisywać wartości do formularza,
- ograniczać warianty pól,
- odświeżać zestawienia i kartoteki,
- zamykać okna,
- otwierać strony programu i strony internetowe.
Komendy te powinny być używane w triggerach wykonywanych podczas interaktywnej pracy użytkownika.
