All values of a dynamic enumeration
See also: Dynamic enumerations, Any dynamic enumeration
Value resolver – Abstract
Purpose: Returns all values of a dynamic enumeration statically defined in the configuration as a list.
The All values of a dynamic enumeration resolver returns a list of all values of a dynamic enumeration defined by static selection in the configuration (see Dynamic enumerations).
►NOTE◄ Dynamic enum filters applicable in the execution context do not restrict the returned list. The value resolver always returns all values (values) that are configured in the definition of the dynamic enumeration.
Configuration
Any existing input value is ignored.
The Type required field parameter requires the static single selection of a dynamic enumeration via a Combobox element. This has a search function that takes into account both the localizations and the internal (class) names for predefined and custom Dynamic enumerations. |
|
As soon as a selection for the Type has been made, a list of values of the relevant type (here: volume unit[]) is assumed as the type for the return value in the context of the configuration, for which specific fields may be offered. |
|
Examples
Simple use case: 'List' values of an enumeration
In the context of event handling, the user should be asked to enter the 'Economic region' per User prompt (as a text value) under certain conditions.
A custom dynamic enumeration 'Economic region' (REGIONS) has been created that specifies permissible values for this entry. The 'Name' (name) of the respective value should be decisive.
The 'prompt' in the User prompt specifies all permissible text keys ('Name' values) from the underlying enumeration.
Runtime example:
Configuration:
The screenshot on the right shows how the User prompt resolver can be used within an Execute with event action to provide the 'Economic region' identified by text input as a reference object for the action block below (still empty in the image on the right)
►NOTE◄ This configuration example solves the task of a selection decision more simply than a portal with a Combobox element. When using the User prompt resolver in a productive workflow, however, it should always be borne in mind that the server thread for the workflow is interrupted at runtime and remains occupied until the 'queried' user confirms their input, cancels the dialog or the Time out expires. The User prompt resolver should not be used if the input has to be queried more often and possibly by many users at the same time. |
|
More complex use case: 'Reverse search' in a dynamic enumeration
A given text value (String) should specify either the two or three-digit text key for a specific Country (ISO 3166 ALPHA-2 or ALPHA-3).
The corresponding value from the associated dynamic enumeration (Country) is transferred as user data to a portal that displays details for the Country.
Text key |
(ALPHA-3) |
(ALPHA-2) |
|
Configuration:
The screenshot on the right shows the configuration for a section from an event handling in which the text key is available as an external reference object of an Execute with event action:
The 'found' Country is the reference object for the Open portal (Action) event action in the action block. |
|
►NOTE◄ No 'error handling' is provided here in the event that the ALPHA-3 reverse search does not return a result.