Menu selection input

This guide will take you through how to set up a menu selection input.

Prerequisite data

No connectors will be used in this example, but data from table steps will be utilized. Please download the file below; it will be used to import into the required table steps

181B

List selection.csv

Add a menu selection input

1. Open an existing application or create a new one in an application package and open it in the Designer.

   1. Add a User step.

   2. Add a Table step.

   3. Open the Table step and select Import File.

   4. Choose the semicolon separator and click OK.

   5. Select the "List selection.csv" file downloaded in the prerequisite section above.

   6. Set the table variable name to "Articles" and click OK.

   7. Change the step name to "Articles". It's good practice to name steps after their content.

   8. Right-click on the "Articles" step, select Add data arrow, and connect it to the User step created in step 1.

1. Open the User step.

   1. Add a Menu Selection input.

   2. In the Target Variable, write "article".

   3. Under Data Source, in Table Variable, choose the table "Articles".

   4. Under Appearance, in Prompt, write "Choose an article".

   5. In Large Row Text, write "{Name}".

   6. Under behaviour, set the Field to Select to "{Name}".

2. Click the Play button in the top right-hand corner to run the application in diagnostic mode.

The Large Row Text shows the articles names. The table is displayed in a drop down menu.

All articles displayed.

Add configuration

The Menu selection input enforces a selection by not giving an empty option. If you wish to leave the variable empty, you need to add an Empty Option.

1. Go back to the Designer.

   1. Under the Empty Option section, check the "Show Empty Option" checkbox.

   2. Set the Text of Empty Option to "Not applicable".

   3. Check the "Allow Empty Option Selection" checkbox.

   4. Run the application in diagnostic mode again.

   

   There is now a Not applicable option, allowing the user to not choose one of the articles to move forward.

2. You can also set a default value to display the value you wish to highlight.

   1. Under Behaviour, in Default Value, write "{"Small box"}".

   2. Click the Play button in the top right-hand corner to run the application in diagnostic mode.

The small box is now shown as chosen value.

1. Condition to hide

   1. In the Condition To Hide, write “{userId = “your user id”} (the user Id you log in to Connect with)

   2. Run the application in diagnostic mode again.

The list is now hidden since the condition is fulfilled.