Creating Drop Down Lists for Constant Mapping

Overview

The String Suggestion List is a feature that allows Admin users to create and manage multiple string values within a variable. This variable can be used in the "Create Data" step of a Flow and in configuring Input Data for Rules.

When a Designer user sets an input mapping to "Constant," the respective field transforms into a drop-down menu, presenting all the pre-configured strings for selection. Moreover, the suggestion list dynamically offers suggestions as the user begins typing, ensuring a smooth and efficient text input experience. This streamlines the process for Designer users and helps speed up workflow development.

Note:

• Only Admin users can add a String Suggestion List to the platform.
• Suggested Value Lists are used to control the design-time experience. They are not used to manage the content of drop-down lists on Forms or Pages. For more information on drop-down lists, refer to Creating Drop-Down Lists article.

Adding a String Suggestion List in the Platform

1. Navigate to the desired Designer Folder > Settings > Configuration > Variables > Suggestion Lists.
2. Click on the ADD STRING SUGGESTION LIST button from the top Action bar.
3. Configure the fields referring to the following table and click Save.
   
   

   Name	Function
   List Name	The name used to identify the Suggest Value List.
   Property Matches	This is the Variable name the value list will be tied to and is case-sensitive. This Variable can be passed to Create Data Step in Flows and Input Data for Rules, respectively.
   Values	The user declared String Values that will be suggested in a drop-down list
   Sort List	This will sort the List by ICU order from the drop-down view. This will sort items in order of items leading with special characters, items leading with numbers, and items leading with letters, in ascending order.
   Is Lock	Enabling will not allow the designers to update or unhook the List during design time.
   Suggest Add New Value	Allows the user to add a new Value to the List or to create a new list during design time.

In the following image, we have added a String Suggestion List named "Priority List".

Folder Actions on the String Suggestion List

Right-click on the newly created suggestion list to view the Folder Actions. 

Using String Suggestion List in a Rule

1. Create a Statement Rule.
2. From the Rule Designer, select SETUP INPUT DATA > DEFINE INPUT DATA. 
3. Under Name, type in the exact text entered in the Property Matches field while setting up the Suggestion List. Set the data type to String [Text] Type. The following image shows that the input is set to "Priority".
4. Define the Rule by inputting If Priority is, then notice how the Priority drop-down contains the previously created Suggested Value List.
   
   
5. Select the pencil icon to edit the Suggested List or unhook the Suggested List and Pick or Define a new Suggested Value List.

Using String Suggestion List in a Flow

1. Create a Flow, and add a Create Data step.
2. Navigate to the Properties tab of the Create Data step and select SHOW EDITOR. 
3. Under Name, type in the exact text entered in the Property Matches field while setting up the Suggestion List. Set the data type to String [Text] Type. The following image shows that the input is set to "Priority".
4. The values from the previously created Suggested Value List can be mapped via the drop-down menu. 
5. Select the pencil icon to edit the Suggested List or unhook the Suggested List and Pick or Define a new Suggested Value List.