Versions Compared

Old Version 2

changes.mady.by.user Piotr Szarkiewicz

Saved on

compared with

New Version Current

changes.mady.by.user Joanna Jankowiak

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image Added

 

Polish

 ← Powrót do listy dostępnych akcji

Info
Jeśli masz problem ze zrozumieniem jak działa akcja, sprawdź opisy: Akcja, Wykonanie warunkowe, Parametry komponentów
Panel
titlePodstawowe informacje

Kategoria: Ogólne

Umiejscowienie akcji: Formularz, Przycisk formularza, Tabela, Przycisk tabeli, Zmienna, Etykieta

Dostępna od wersji: 1.0.

20

81

Panel
titleOpis

 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.

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ą pusteAkcja umożliwia wyświetlenie nowej nazwy i opisu (tooltip) elementu lub wielu elementów formularza, gdy spełniony jest warunek jej wykonania. Akcja jest "niesymetryczna", czyli gdy wykonanie warunkowe akcji zmieni się z "prawdy na fałsz" to nazwa i opis sprzed zmiany nie są przywracane.

Panel
titleWywołanie akcji
Info

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, Przycisk formularza, Tabela, Przycisk tabeli, 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 warunkowegoWywołuje akcję

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

Przycisk

-Uaktywnia akcjęKliknięcie w przycisk
Panel
titleParametry konfiguracyjne
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Zmienne Element do ustawieniazmiany * Lista nazw zmiennych formularza do ustawieniazmianyTablica zmiennych Pole edytowalne WartościWartości, którymi ustawimy poszczególne zmienne

Parametry pojawiają się w przypadku umieszczenia akcji na formularzu.

Nowa nazwa*
 Lista nowych nazw dla elementów z listy Element do zmianyTablica wartości tekstowych Pole edytowalne
Nowa nazwa przycisku* 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 Nowa nazwa przycisku formularzaTekst Pole edytowalneParametr pojawia się w przypadku umieszczenia akcji na przycisku formularza oraz w przypadku ustawienia nazwy przycisku tabeli.Zmienne aktualizująceW tym parametrze określamy, po zmianie których zmiennych wywoła się akcja.Tablica zmiennych 
Nowy tytuł tabeli* Nowa wartość dla tytułu tabeliTekst Pole edytowalneParametr pojawia się w przypadku umieszczenia akcji na tabeli.
Nowa nazwa zmiennej* Nowa wartość dla nazwy zmiennejTekst Pole edytowalneParametr pojawia się w przypadku wybrania w Zdarzenia wywołujące akcję opcji Wywołanie przy zmianie zmiennych

Parametr*- pole wymagane

Panel
titlePrzykładowa konfiguracja

Image Removed

Panel
titlePrzykład zastosowania
Expand
titlePrzykł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 Removed

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 Removed

Aby obliczyć różnicę między dwoma datami korzystamy z funkcji #calculateDaysDifference.

Image Removed

Wartość, którą chcemy ustawić została już ustalona, teraz przejdźmy do kolejnych parametrów akcji

Image Removed

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.

umieszczenia akcji na zmiennej.
Nowa nazwa etykiety* Nowa wartość dla nazwy etykietyTekst Pole edytowalneParametr pojawia się w przypadku umieszczenia akcji na etykiecie.
Nowy opis1.0.123Nowy opis (tooltip) elementu.Tekst / Tablica wartości tekstowych Pole edytowalne

Parametr jest typu tablicy wartości tekstowych w przypadku umieszczenia akcji na formularzu. W sytuacji umieszczenia akcji na zmiennej lub przycisku tabeli, parametr jest typu tekstowego. Parametr występuje tylko, gdy akcja zostanie przeciągnięta na formularz, zmienną lub przycisk tabeli. Parametr jest opcjonalny. Pozostawienie go pustego lub przekazanie pustego ciągu znaków za pomocą zmiennej lub funkcji skutkuje brakiem zmiany opisu elementu.

Warning

Parametr jest dostępny tylko w systemie PlusWorkflow 4.0.

Parametr*- pole wymagane

Panel
titlePrzykładowa konfiguracja
Umiejscowienie akcji na formularzu:

Image Added

 

Umiejscowienie akcji na tabeli:

Image Added

 

Umiejscowienie akcji na przycisku:

Image Added

Panel
titleChange log

x1.x0.81

  • Dodanie komponentu

 

1.0.123

  • Dodanie parametru "Nowy opis"
Panel
titlePakiet z przykładowym formularzem wykorzystującym komponent

View file
nameTesty komponentów - akcje - [AKCJA] Zmiana nazwy elementu 2020-06-10 13 03 59.zip
height250
 

English

  ← Return to the list of available actions

Info

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

Panel
titleBasic information

Category: General

Action location: Form, Form Button, Table, Table Button, Variable, Label

Available from version: 1.0.

20

81

Panel
titleDescription

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 emptyallows setting a new element's name and description (tooltip) in the form, depending on given condition. The action is "asymmetrical", ie when the condition of the action changes from true to false, the name and description from before change are not restored.

Panel
titleAction call-up
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, Form button, Table, Table button, Variable, LabelCalling 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

Panel
titleConfiguration parameters

Parameter name

From version

Description

Paremeter type

Default value

Field type

Comments and restrictions

Variables Element to setchange*  List of variables to setArray of variablesform variable names to be changedVariable array Editable field fieldParameters appear when the action is placed on the form.

New name* ValuesThe values with which we set individual variablesAn array of text values List of new names for items from the Element to change listString array Editable field 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
New button name*  New form button nameText Editable fieldParameter appears when the action is placed on the form button and table button.
New table title name*  New value for table titleText Editable fieldParameter appears when the action is placed on the table.
New variable name*  New value for variable nameText Editable fieldParameter appears when the action is placed on the variable.
New label name*  New value for label nameText Editable fieldParameter appears when the action is placed on the label.
New description1.0.123New element (tooltip) description.Text / Text array Editable field

Parameter is of the type of an array of text values in case the action is placed on the form. In the case of placing the action on form or table button, the parameter is of the text type. The parameter only occurs when the action is dragged onto a form, variable, or table button. The parameter is optional. Leaving it empty or passing an empty string by means of a variable or function will result in the element description not being changed.

Warning

Parameter is available only in the PlusWorkflow 4.0.

Parameter*- mandatory field

Panel
titleConfiguration example

Image Removed

Action placed on the form:

Image Added

 

Action placed on the table:

Image Added

 

 

Action placed on the button:

Image Added

 

Panel
titleChange log

x1.x0.81

1.0.123

  • Adding a parameter "New description"
Panel
titlePackage with an example form

View file
nameTesty komponentów - akcje - [AKCJA] Zmiana nazwy elementu 2020-06-10 13 03 59.zip
height250