← Powrót do listy dostępnych akcji
Jeśli masz problem ze zrozumieniem jak działa akcja, sprawdź opisy: Akcja, Wykonanie warunkowe, Parametry komponentów
Podstawowe informacje
Kategoria: Ogólne
Umiejscowienie akcji: Formularz, Przycisk formularza, Zmienna, Etykieta
Dostępna od wersji: 1.0.20
Opis
Akcja ustawia wartości w podanych zmiennych nagłówkowych i tabelarycznych. Wartości przekazujemy jako tekst, który zostanie zrzutowany na odpowiedni typ. W wypadku ustawiania wartości zmiennych tabelarycznych(kolumn) należy przekazywać wartości po średniku np. "tekst1;tekst2;tekst3", "1;543;432" itd.
Wywołanie akcji
Pozostawienie pustego pola wykonania warunkowego jest jednoznaczne z ustawieniem go na "prawdę".
| Umiejscowienie akcji | Wartość parametru "Zdarzenia wywołujące akcję" | Działanie parametru "Wykonanie warunkowe" | Warunek wywołania akcji |
|---|---|---|---|
| Formularz, Zmienna, Etykieta | Wywołanie przy zmianie zmiennych | Uaktywnia akcję | Zmiana wartości zmiennej na z parametru "Zmienne aktualizujące". |
| Wywołanie po zajściu warunku wykonania warunkowego | Wywołuje akcję | Zmiana wartości "Wykonania warunkowego" na "prawdę" | |
Przycisk | - | Uaktywnia akcję | Kliknięcie w przycisk |
Parametry konfiguracyjne
| Nazwa parametru | Opis | Typ parametru | Wartość domyślna | Rodzaj pola | Uwagi i ograniczenia |
|---|---|---|---|---|---|
| Zmienne do ustawienia | Lista zmiennych do ustawienia | Tablica zmiennych | Pole edytowalne | ||
| Wartości | Wartości, którymi ustawimy poszczególne zmienne | Tablica wartości tekstowych | Pole edytowalne | ||
| Zdarzenia wywołujące akcję | W tym parametrze określamy, po jakich zdarzeniach ma się wywołać akcja | Tablica wartości tekstowych | Wywołanie po zajściu warunku wykonania warunkowego | Lista wartości | Parametr nie pojawia się w przypadku umieszczenia akcji na przycisku. |
| Zmienne aktualizujące | W tym parametrze określamy, po zmianie których zmiennych wywoła się akcja. | Tablica zmiennych | Pole edytowalne | Parametr pojawia się w przypadku wybrania w Zdarzenia wywołujące akcję opcji Wywołanie przy zmianie zmiennych |
Parametr*- pole wymagane
Przykładowa konfiguracja
Przykład zastosowania
Załóżmy, że potrzebujemy ustawić zmienną Dni do zapłaty (typ całkowity). Jej wartość będzie obliczana na podstawie dnia dzisiejszego i zmiennej przechowującej datę Termin płatności.
W tym celu możemy przenieść akcję Ustawianie wartości zmiennych na pole formularza bądź na zmienną Dni do zapłaty.
Konfiguracja akcji będzie prezentować się następująco:
W parametrze Zmienne do ustawienia podajemy zmienną, którą chcemy ustawić. W naszym przypadku jest to zmienna Dni do zapłaty.
Następnie uzupełniamy parametr Wartości - należy pamiętać, że parametr przyjmuje tylko wartości tekstowe! Naszą liczbę dni musimy zatem zamienić na ciąg znaków. Dokonujemy tego przy pomocy funkcji #toString.
Aby obliczyć różnicę między dwoma datami korzystamy z funkcji #calculateDaysDifference.
Wartość, którą chcemy ustawić została już ustalona, teraz przejdźmy do kolejnych parametrów akcji
W parametrze Zdarzenia wywołujące akcję wybraliśmy Wywołanie przy zmianie zmiennych, ponieważ chcemy, by przy każdej zmianie zmiennej Termin płatności wartość obliczyła się na nowo.
Wybraliśmy także Wywołanie po zajściu warunku wykonania warunkowego, ponieważ przy każdym wejściu do formularza akcja powinna pobierać aktualną datę i w razie potrzeby ją uaktualnić.
To wszystko. Akcja jest gotowa do użytku.
Change log
1.0.20
- Dodanie komponentu
1.0.30
- Poprawienie dynamicznego formularza
1.0.31
- Podpinanie pod zmienną blokuje modyfikacje parametru
1.0.59
- Naprawienie ustawiania daty i czas w IE 11
1.0.64
- Dodanie obsługi etykiet
Pakiet z przykładowym formularzem wykorzystującym akcję
The license could not be verified: License Certificate has expired!