Creating Drop Down Lists for Constant Mapping
  • 09 Dec 2024
  • 3 Minutes to read
  • Dark
    Light

Creating Drop Down Lists for Constant Mapping

  • Dark
    Light

Article summary

Feature Details
Introduced in Version--
Modified in Version8.15
Modification DetailsAdded a new setting: "Is Lock" on the Add String Suggestion List dialog box.

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 System > Designers > Lookup Lists and Constants.
  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.

    NameFunction
    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".

Folder Actions on the String Suggestion List

Right-click on the newly created suggestion list to view the Folder Actions. The following table describes all the folder actions.

Action NameDescription
Edit Suggestion List
Allows to re-configure the Suggestion List.
Add > Setup > Manage Tags
Opens a drop-down list that may create new tags or select pre-existing tags to be attached to the object.
Import Export
Allows to add the Suggestion List to an already created Designer Project or to Export it.
Manage
Allows to Add a comment, Delete, Retrieve the ID, and Show the details of the Suggestion List.


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.

Feature Changes

DescriptionVersionDateDeveloper Task
Added a new setting, "Is Lock," that will not allow the designers to update or unhook the List during design time.8.15October 12, 2023[DT-038672]

Was this article helpful?