During adding a component to the form or process, a window containing the basic description of the component is displayed as well as the parameter fields which have to be completed. These fields can be of different types to facilitate work and, depending on that, they have different functionalities. They have two working modes:
- edit mode - active after clicking on the field, allows to introduce a value
- preview mode - displays the current field value, allows to go to the edit mode or delete the value with one click
Ways of transferring values
- Constant value
Constant value is entered directly from the keyboard into the field in edit mode.
- Process variable
You can enter the process variable after ealier entering the "$" character or using the button on the right of the field. A list is displayed that allows to filter the results. It is possible to navigate with the help of the arrows, the selection you confirm by the ENTER key.
After selecting the variable the parameter value is presented in the label form, which allows to delete the selected value by clicking the "x" or editing by clicking on the label.
- Function
Function can be entered into the field after entering the "#" character or using the button on the right of the field. A table is displayed with available functions that allows filtering results. It is possible to navigate with the help of the arrows, the selection is confirmed by the ENTER key.
After selecting the function, a window of function parameters appears, which have to be completed in the same way.
Parameters types
Type: Basic types
Basic types allow to enter fixed values, process variables or functions that calculate the parameter value based on their own parameters. Entering variables or functions can be done directly in the field in edit mode or through the buttons placed on the right. There are following basic types:
- text value
- total value
- decimal value
- date value
- date value with time
- logical value
Type: Function
Function type has only value in the function form.
Type: Variable
Variable type has only value in variable form.
Tabular field
The tabular field allows to enter any number of values. It consists of the same multifunctional fields. Subsequent fields can be added or removed using the buttons on the right of the field.
In a table field element, you can specify both a table variable, a header variable and a function that returns table or a single value.
If in the parameter you give, eg.: 2 table elements (eg two tabular variables), they will be flattened (summed up) to one table. Suppose you transfer to the parameter a table variable with values ["a", "b"], header variable with the value "c" and the next table variable with values ["d", "e"] then in the component this parameter will be summed value ["a", "b", "c", "d", "e"].
Preview of values
Depending on the selected value, the corresponding preview is displayed. Navy blue - variable, green - function, gray - fixed value.
- tryb edycji - aktywny po kliknięciu w pole, pozwala wprowadzać wartość
- tryb podglądu - wyświetla aktualną wartość pola, pozwala przejść do trybu edycji lub usunąć wartość jednym kliknięciem
Sposoby przekazywania wartości
Wartość stała
Wartość stałą wprowadzamy bezpośrednio z klawiatury do pola w trybie edycji.Zmienna procesu
Zmienną procesu możemy wprowadzić do pola po wcześniejszym wprowadzeniu znaku "$" lub za pomocą przycisku z prawej strony pola. Wyświetla się lista, która umożliwia filtrowanie wynikiów. Możliwa jest nawigacja za pomocą strzałek, wybór zatwierdzamy klawiszem ENTER.Po wybraniu zmiennej wartość parametru jest prezentowana w formie etykiety, która umożliwia usunięcie wybranej wartości poprzez kliknięcie znaku "x" lub jej edycję poprzez kliknięcie w etykietę.
Funkcja
Funkcję możemy wprowadzić do pola po wcześniejszym wprowadzeniu znaku "#" lub za pomocą przycisku z prawej strony pola. Wyświetla się tabela z dostępnymi funkcjami, które umożliwia filtrowanie wyników. Możliwa jest nawigacja za pomocą strzałek, wybór zatwierdzamy klawiszem ENTER.Po wyborze funkcji pojawia się okno parametów funkcji, które należy uzupełnić w taki sam sposób.
Typy parametrów
Typ: Typy podstawowe
Typy podstawowe pozwalają na wprowadzanie wartości stałych, zmiennych procesu lub funkcji, które wyliczą wartość parametru na podstawie własnych parametrów. Wprowadzanie zmiennych lub funkcji może odbywać się w bezpośrednio w polu w trybie edycji lub poprzez przyciski umieszczone z prawej strony. Wyróżniamy następujące podstawowe:
- wartość tekstowa
- wartość całkowita
- wartość dziesiętna
- wartość datowa
- wartość datowa z czasem
- wartość logiczna
Pole typu podstawowego przyjmie zmienną pod warunkiem, że przetrzymuje ona wartość tego samego typu! Podobnie z funkcjami - jeżeli chcemy ich użyć, to musi ona zwracać ten sam typ!
Czasami potrzebujemy przekazać wartość, której typ jest inny niż typ docelowy. Istnieje możliwość zmiany typu przez użycie funkcji konwertujących, np. toFloat, toString, więcej w temacie: Dostępne funkcje
Typ: Funkcja
Typ funkcyjny przyjmuje tylko wartości w postaci funkcji.
Typ: Zmienna
Typ zmienna przyjmuje tylko wartości w postaci zmiennej.
Pole tabelaryczne
Pole tabelaryczne pozwala podać dowolną ilość wartości. Składa się z takich samych pól wielofunkcyjnych. Kolejne pola mogą być dodawane lub usuwane za pomocą przycisków z prawej strony pola.
W elemencie pola tabelarycznego możemy podać zarówno zmienną tablicową, zmienną nagłówkową oraz funkcję zwarcającą tablicę lub pojedynczą wartość.
Jeżeli w parametrze podamy np.: 2 elemnty tablicowe (np.: dwie zmienne tabelaryczne), to zostaną one spłaszczone (zsumowane) do jednej tabliczy. Załóżmy, że przekazujemy do parametru zmienna tablicową z wartościami ["a", "b"], zmienną nagłówkową z wartością "c" oraz kolejną zmienną tablicową z wartościami ["d", "e"] to w komponencie parametr ten będzie mieć zsumowaną wartość ["a", "b", "c", "d", "e"].
Podgląd wartości
W zależności od wybranej wartości wyświetlany jest odpowiedni dla nich podgląd. Granatowy - zmienna, zielony - funkcja, szary - stała wartość