List Builder Overview

Overview

The Create List Builder is a step that is used to create or manipulate List Data. This List Data is specified on the step by defining the desired ListType. Upon running Create List Builder, the step provides users access to additional steps that may be used to append and further edit the List through way of various Methods. The following document demonstrates how to utilize a Create List Builder step within a Flow to create a List. 

Summary of List Builder Steps

Example

The following example demonstrates how to utilize the Create List Builder step to create a String List. To do so:

1. From a DesignerProject, select the CREATE FLOW button from the Global Action Bar, then CREATE a new Flow. 
2. From the Flow Designer, attach a Create List Builder step from Steps > Data > List, to the Start and End steps. 
3. From the Properties tab of the Create List Builder step, under [Settings] > ListType, select the desired option (for this example String [Text]). 
4. Save the Flow, then run it in the Debugger via the Debug link. Then close the Debugger. 
5. Back in the Flow Designer, navigate to Steps > [Data in Flow] > List > [Metods]. Add an Add(item String) step after the Create List Builder step. 

6. From the Properties of the List Add step, Constant map the desired String value to item.

   
   

7. From the same [Methods] category, add an AddIfDoesNotExist step after the List Add step. Under Properties, Constant map a value for item.

8. Attach an Insert step after List AddIfDoesNotExist. From the newly added step's Properties tab, Constant map the desired index (for this example "2") and item values.  

   Additional Information on Index

   The index Input is an Int32 value used to determine where to insert the defined item value. The index number starts from 0 (representing the first place in the List) and cannot exceed the number that follows in the sequence of items within the List.

   
   

   

   
   

9. From the Favorite Steps category, add a Show Form step after the List Insert step. From the Properties tab, select PICK OR CREATE FORM, then CREATE a new Form.

10. From the Form Designer, add a List Box component from Form Controls > Data to the Form. Under Properties > Input Data, provide the desired List Items Data Name, and select the corresponding Type from the dropdown. From the Favorite Components category, add a Button component labeled "Done". Save and close the Form.

11. Back in the Flow Designer, attach the Done path to the End step. From the Properties tab of the Form step, Select From Flow map List.DistictList to String List and set selected String List to Ignore.

12. Save and if desired, close the Flow.

Debug 

1. From the Flow Designer, select the Debug link from the top Action bar. Then click FULL.
2. Upon reaching the Form step, compare the resulting List to the Input values. 
3. Select one of the List items, then click Done.