Select

​

Configuring the Select element

​

Select Settings

These allow you to customize the settings for the Select Field:

• General
• Properties
• Datasource
• Validators
• Expressions
• UI actions
• Select styling

​

General

• Process data key - creates the binding between form element and process data so it can be later used in decisions, business rules or integrations

​

Properties

• Label - the label of the select
• Placeholder - placeholder when the field has no value
• Empty message - text displayed for custom type when no results are found
• Search for options - displays a search to filter options
• Helpertext - additional information about the select field (can be hidden inside an infopoint)

​

Datasource

• Default value - autofill the select with this value. Going back to the example with Woman label with F value and Man with M to have a default value of Woman we need to configure here F
• Source Type - it can be Static, Enumeration, or Process Data
• Add option - label - value pairs can be defined here

​

Validators

There are multiple validators can be added to a select (more details here).

​

Expressions

The select field’s behavior can be defined using JavaScript expressions for hiding or disabling the element. The following properties can be configured for expressions:

• Hide - JavaScript expression used to hide the Select Field when it returns a truthy value
• Disabled - JavaScript expression used to disable the Select Field when it returns a truthy value

​

UI actions

UI actions can be added to the select element to define its behavior and interactions.

• Event - possible value: CHANGE
• Action Type - select the action type

​

Select styling

Styling the Select field using CSS properties allows you to customize the appearance of the dropdown list and make it more visually appealing and consistent with the overall design of the website or application.

For example, a FORM element with a layout configuration including direction of Horizontal and some inputs, and a select element will look like this:

​

Icons

When customizing the appearance of a Select UI element that includes an icon, you can utilize the following properties:

• Icon Key - the key associated in the Media library, select the icon from the Media Library
• Icon Color - select the color of the icon using the color picker

​

Example - dynamic dropdowns

As mentioned previously, you can create dropdowns including static data, enumerations, or process data. Let’s create an example using process data to create a process that contains dynamic dropdowns.

To create this kind of process, we need the following elements:

• a start node and an end node
• a start milestone and an end milestone node

• a task node (this will be used to set which data will be displayed on the dropdowns)

• a user task node (here we have the client forms and here we add the SELECT elements)

​

Creating the process

Follow the next steps to create the process from scratch:

1. Open FLOWX Designer and from the Processes tab select Definitions.
2. Click on the breadcrumbs (top-right corner) then click New process (the Process Designer will now open).
3. Now add all the necessary nodes (as mentioned above).

​

Configuring the nodes

1. On the start milestone node, add a page UI element.

2. On the task node, add a new Action (this will set the data for the dropdowns) with the following properties:

   • Action type - Business Rule
   • Automatic
   • Mandatory
   • Language (we used an MVEL script to create a list of objects)

3. On the user task node, add a new Action (submit action, this will validate the forms and save the date) with the following properties:

• Action type - Save Data
• Manual
• Mandatory
• Data to send (the key where the data will be sent) - application

Below you can find the MVEL script used in the above example:

output.put("application",
{
    "client": {
        "identity": [
        {
            "value": "001",
            "label": "Eddard Stark"
        },
        {
            "value": "002",
            "label": "Sansa Stark"
        },
        {
            "value": "003",
            "label": "Catelyn Stark"
        }
    ]},
    "contracts": {
        "001": [
            {
                "value": "c001",
                "label": "Eddard Contract 1"
            },
            {
                "value": "c007",
                "label": "Eddard Contract 2"
            }
        ],
        "003": [
            {
                "value": "c002",
                "label": "Catelyn Contract 1",
            },
            {
                "value": "c003",
                "label": "Catelyn Contract 2 ",
            },
            {
                "value": "c004",
                "label": "Catelyn Contract 3"
            }
        ],
        "002": [
            {
                "value": "c005",
                "label": "Sansa Contract 1",
            }
        ]
    }
});

​

Configuring the UI

Follow the next steps to configure the UI needed:

1. Select the user task node and click the brush icon to open UI Designer.
2. Add a Card UI element as a root component (this will group the other elements inside it) with the following properties:
   • Message - {"application": ${application}}
   • Title - Customer Contract
3. Inside the card, add a form element.
4. Inside the form add two select elements, first will represent, for example, the Customer Name and the second the Contract ID.
5. For first select element (Customer Name) set the following properties:
   • Process data key - application.client.selectedClient
   • Label - Customer Name
   • Placeholder - Customer Name
   • Source type - Process Data (to extract the data added in the task node)
   • Name - application.client.identity

6. For the second select element (Contract ID) set the following properties:
   • Process data key - application.client.selectedContract
   • Label - Contract ID
   • Placeholder - Contract ID
   • Source Type - Process Data
   • Name - application.contracts
   • Parent - SELECT (choose from the dropdown list)

7. Add a button under the form that contains the select elements with the following properties:
   • Label - Submit
   • Add UI action - add the submit action attached earlier to the user task node

8. Test and run the process by clicking Start process.