← 
Image Added
...
| Panel |
|---|
| title | Podstawowe informacje |
|---|
| Kategoria: OgólneDostępna od wersji: 1.0.20 |
| Panel |
|---|
| 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
Jeżeli umieścimy akcję na przycisku, to wywoła się ona po kliknięciu w niego.
W pozostałych przypadkach wywołanie jest definiowane przez parametr Zdarzenia wywołujące akcję. Może on przyjmować dwie wartości:
...
| Warning |
|---|
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. |
| Panel |
|---|
| | Info |
|---|
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 |
|
|
...
Wykonanie warunkowe
Wykonanie warunkowe w przypadku umieszczenia na przycisku aktywuje reakcję na kliknięcie przycisku (nie wywołuje samej akcji). W przypadku umieszczenia na fomularzu/zmiennej zależy od parametru Zdarzenia wywołujące akcję.
Umiejscowienie akcji
Przycisk, Formularz, Zmienna
Image Removed
Zmienne do ustawienia ( typ : tablica zmiennych ) - Lista zmiennych do ustawienia
Wartości (w postaci tekstu) ( typ : tablica wartości tekstowych ) -
| Wywołuje akcję | Zmiana wartości "Wykonania warunkowego" na "prawdę" | Przycisk, Przycisk tabeli | - | Uaktywnia akcję | Kliknięcie w przycisk |
|
| Panel |
|---|
| title | 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 | W przypadku przekazania zmiennej lub funkcji o typach innych niż tekstowy, należy użyć funkcji toString(). | | Zdarzenia wywołujące akcję |
|
|
( typ : lista wyboru wartości tekstowych ) - | W tym parametrze określamy, po jakich zdarzeniach ma się wywołać akcja |
|
|
Zmienne aktualizujące ( typ: tablica zmiennych ) - (parametr pojawia się w przypadku wybrania w Zdarzenia wywołujące akcję opcji Wywołanie przy zmianie zmiennych) | 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. |
|
|
Przykładowe użycia akcji
| 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 |
| Panel |
|---|
| title | Przykładowa konfiguracja |
|---|
| Image Added |
| Panel |
|---|
| title | Przykład zastosowania |
|---|
| | Expand |
|---|
| title | Przykład 1. Ustawienie Dni do zapłaty |
|---|
| | 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:  Image Modified
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.  Image Modified
Aby obliczyć różnicę między dwoma datami korzystamy z funkcji #calculateDaysDifference.  Image Modified
Wartość, którą chcemy ustawić została już ustalona, teraz przejdźmy do kolejnych parametrów akcji  Image Modified
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. |
|
|
...
Mapa z przykładową konfiguracją
Image RemovedTesty komponentów - akcje.zip
Powiązane zadania
| 1.0.20 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 1.0.100 - Dodanie wywołania pod przyciskiem tabeli
|
| Panel |
|---|
| title | Pakiet z przykładowym formularzem wykorzystującym akcję |
|---|
| | View file |
|---|
| name | Testy komponentów - akcje - [AKCJA] Ustawianie warto ci zmiennych 2019-10-14 10_23_33.zip |
|---|
| height | 250 |
|---|
|
|
| Hide If |
|---|
| Powiązane zadaniaAktualne Archiwalne | JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-295 |
|---|
|
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-341 |
|---|
|
|
|
Image RemovedCUFCMP-47 - Poprawienie akcji setVariable In Progress
| English |
|---|
← Return to the list of available actions | Panel |
|---|
| Category: GeneralAvailable from version: 1.0.20 |
| Panel |
|---|
| 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. |
| Warning |
|---|
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. |
| Panel |
|---|
| | Info |
|---|
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 condition | Call-up action | The "Conditional execution" parameter will return "true" | Button, table button | - | Activates action | Pressing the button |
|
| Panel |
|---|
| title | Configuration parameters |
|---|
| Parameter name | Description | Paremeter type | Default value | Field type | Comments and restrictions |
|---|
| Variables to set | List of variables to set | Array of variables | | Editable field | | | Values | The values with which we set individual variables | An array of text values | | Editable field | In case of using variable or function of types other than text, use toString() function. | | Events that trigger the action | In this parameter, we specify after which events the action should be triggered | An array of text values | Call after conditional execution condition | Drop-down list | The 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 |
| Panel |
|---|
| title | Configuration example |
|---|
| Image Added |
| Panel |
|---|
| 1.0.20 1.0.30 - Improving the dynamic form
1.0.31 - Connecting to a variable blocks parameter modification
1.0.59 - Fix date and time setting in IE 11
1.0.64 1.0.100 - Added location on table button
|
|
W przypadku przekazania zmiennej lub funkcji o typach innych niż tekstowy, należy użyć funkcji toString().
