← 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

Kategoria: Ogólne

Umiejscowienie akcji: Formularz, Przycisk formularza, Zmienna, Etykieta

Dostępna od wersji: 1.0.20

 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.

Akcja ustawiona na zmiennych tabelarycznych najpierw czyści wartości wierszy, a następnie wpisuje nowe wartości. W przypadku, gdy wierszy w tabeli było mniej niż przekazywanych przez akcję wartości to dopisuje nowe, natomiast gdy wierszy było więcej to nadmiarowe pozostają puste.

Pozostawienie pustego pola wykonania warunkowego jest jednoznaczne z ustawieniem go na "prawdę".

Umiejscowienie akcjiWartość parametru "Zdarzenia wywołujące akcję"Działanie parametru "Wykonanie warunkowe"Warunek wywołania akcji
Formularz, Zmienna, EtykietaWywołanie przy zmianie zmiennych

Uaktywnia akcję

Zmiana wartości zmiennej na z parametru "Zmienne aktualizujące".

Wywołanie po zajściu warunku wykonania warunkowegoWywołuje akcję

Zmiana wartości "Wykonania warunkowego" na "prawdę"

Przycisk

-Uaktywnia akcjęKliknięcie w przycisk
Nazwa parametruOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Zmienne do ustawieniaLista zmiennych do ustawieniaTablica zmiennych Pole edytowalne 
WartościWartości, którymi ustawimy poszczególne zmienneTablica wartości tekstowych Pole edytowalne 
Zdarzenia wywołujące akcjęW tym parametrze określamy, po jakich zdarzeniach ma się wywołać akcjaTablica wartości tekstowychWywołanie po zajściu warunku wykonania warunkowegoLista wartościParametr nie pojawia się w przypadku umieszczenia akcji na przycisku.
Zmienne aktualizująceW tym parametrze określamy, po zmianie których zmiennych wywoła się akcja.Tablica zmiennych Pole edytowalneParametr pojawia się w przypadku wybrania w Zdarzenia wywołujące akcję opcji Wywołanie przy zmianie zmiennych

Parametr*- pole wymagane

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.

x.x

  • Dodanie komponentu

 

 

  ← Return to the list of available actions

If you have a problem understanding how the action works, check: Action, Conditional execution, Components parameters

Category: General

Action location: Form, Button, Variable, Label

Available from version: 1.0.20

The action sets the values in the given header and tabular variables. We pass the values as text that will be cast to the appropriate type. When setting values of tabular variables (columns), enter values after the semicolon, e.g. "text1; text2; text3", "1; 543; 432" etc.

An action set on tabular variables first clears row values and then enters new values. If there were fewer rows in the table than the values passed by the action, then new ones are added, while if there were more rows, the excess ones remain empty.

Leaving an empty conditional field is equal to setting it to "true".

Action location

Value of the "Events triggering" parameter

Conditional execution parameter action

Action call-up condition

Form, Variable, Label

Calling when variables are changed

Activates action

Changing the variable value to from the "Update variables" parameter.

Call after conditional execution conditionCall-up actionThe "Conditional execution" parameter will return "true"

Button

-

Activates action

Pressing the button

Parameter name

Description

Paremeter type

Default value

Field type

Comments and restrictions

Variables to setList of variables to setArray of variables Editable field 
ValuesThe values with which we set individual variablesAn array of text values Editable field 
Events that trigger the actionIn this parameter, we specify after which events the action should be triggeredAn array of text valuesCall after conditional execution conditionDrop-down listThe parameter does not appear in case of placing the action on the button.

Updating variables

In this parameter we specify which variables will trigger the action.

Array of variables

 

Editable field

The parameter appears when the Invoking option is selected in the Events triggering an action when changing variables

Parameter*- mandatory field

x.x

  • Adding a component