Akcja wstawia do zmiennej unikatowy numer, wygenerowany z wykorzystaniem sekwencji, w oparciu o podane formatowanie i nazwę sekwencji. Akcję wywołuje się na polu nagłówkowym.
Panel
title
Wywołanie akcji
Info
Pozostawienie pustego pola wykonania warunkowego jest jednoznaczne z ustawieniem go na "prawdę".
Umiejscowienie akcji
Działanie parametru "Wykonanie warunkowe"
Warunek wywołania akcji
Przycisk
Uaktywnia akcję
Naciśnięcie przycisku
Zmienna
Wywołuje akcję
Parametr "Wykonanie warunkowe" zwróci "prawdę"
Panel
title
Parametry konfiguracyjne
Nazwa parametru
Od wersji
Opis
Typ parametru
Wartość domyślna
Rodzaj pola
Uwagi i ograniczenia
Format wygenerowanego numeru*
1.0.0
Format na podstawie którego zostanie wygenerowany numer. Typowy format składa się z trzech elementów: znacznika numeru, symbolu oddzielającego i znacznika roku. Cyfry w znacznikach numeru i roku oznaczają ilość cyfr, które mają zostać wygenerowane. Rok może być dwu- lub czterocyfrowy, ale może również zostać pominięty, podobnie jak symbol oddzielający.
Tekst
[N4]/[R2]
Pole edytowalne
Format musi posiadać znacznik numeru.
Formatowanie może również zawierać stałe tekstowe.
Przykładowy, domyślny format [N4]/[R2] pozwala, np., na wygenerowanie numeru 0001/17
Nazwa sekwencji*
1.0.0
Nazwa nowej lub istniejącej już sekwencji w bazie danych systemu.
Tekst
Pole edytowalne
Jeśli chcemy zadbać o resetowalność numeru z nowym rokiem, wystarczy, że nazwa zawierać będzie aktualny rok. Dynamiczne pobranie bieżącego roku umożliwia funkcja currentYear().
Przykładowa nazwa wykorzystująca funkcję może być zdefiniowana w następujący sposób: #concat(test_,toString(currentYear())).
Zmienna docelowa*
1.0.0
Zmienna, w której zapisany zostanie numer.
Zmienna
<zmienna na którą przeniesiono akcję> ( w przypadku umieszczenia na zmiennej)
Pole edytowalne/pole nieedytowalne ( w przypadku umieszczenia na zmiennej)
Zmienna powinna być typu tekstowego i umieszczona na formularzu (nie w tabeli dynamicznej).
Zamiana znaków specjalnych*
1.0.37
Określa czy znaki specjalne w nazwie sekwencji mają zostać zamienione na "_" (jedyny akceptowalny znak specjalny we wszystkich bazach oprócz MSSQL).
Logiczny
Nie
Pole edytowalne
Nazwa sekwencji w bazie Oracle nie może zaczynać się od żadnego znaku specjalnego (nawet "_")!
Przy włączonej opcji zmiany znaków jeden symbol zostaje zamieniony na jeden podkreślnik. Dla przykładu "T$.st" = "T__st", a "T@#$e%st" = "T___e_st".
Parametr*- pole wymagane
Panel
title
Przykładowa konfiguracja
Image Modified
Panel
title
Change log
1.0.0
Dodanie komponentu
1.0.1
Dodanie możliwości generowania unikatowego numeru pod przyciskiem
1.0.37
Dodanie parametru "Zamiana znaków specjalnych" i naprawa błędu
1.0.56
Modyfikacja dynamicznego formularza
Panel
title
Pakiet z przykładowym formularzem wykorzystującym akcję
Leaving an empty conditional field is equal to setting it to "true".
Action location
Conditional execution parameter action
Action call-up condition
Variable
Call-up action
The "Conditional execution" parameter will return "true"
Button
Activates action
Pressing the button
Panel
title
Configuration parameters
Parameter name
From version
Description
Paremeter type
Default value
Field type
Comments and restrictions
Format of generated number*
1.0.0
The format based on which the number will be generated. A typical format consists of three elements: a number marker, a separating symbol and a year marker. The numbers in the year and number markers indicate the number of digits to be generated. The year can be two or four digits, but it can also be omitted, as can the separating symbol.
Text
[N4]/[R2]
Editable field
The format must have a number marker.
Formatting can also contain text constants.
The sample default format [N4] / [R2] allows, for example, to generate number 0001/17
Sequence Name*
1.0.0
The name of the new or existing sequence in the system database.
Text
Editable field
If we want to ensure that the number is reset with the new year, it is enough that the name contains the current year. The currentYear () function can dynamically retrieve the current year.
An example name using the function can be defined as follows: #concat (test_, toString (currentYear ())).
Target Variable*
1.0.0
Variable in which the number will be saved.
Variable
<variable to which the action was moved> (if placed on a variable)
Editable field (Uneditable if on variable)
The variable should be of the text type and placed on the form (not in the dynamic table).
Replacing special characters*
1.0.37
Specifies whether special characters in the sequence name are to be converted to "_" (the only acceptable special character in all databases except MSSQL).
Boolean
No
Editable field
The sequence name in the Oracle database cannot start with any special characters (even "_")!
When the character change option is enabled, one symbol is replaced by one underscore. For example, "T $ .st" = "T__st" and "T @ # $ e% st" = "T___e_st".
Parameter*- mandatory field
Panel
title
Configuration example
Image Added
Panel
title
Change log
1.0.0
Adding a component
1.0.1
Adding the ability to generate a unique number under the button
1.0.37
Addition of the "Convert special characters" parameter and error correction
