Adding a list field

You can add several different types of list fields to your app:

Step 1: Open the Create or Edit Apps window and select the section.

1. To create a new app, or copy or edit an existing one:
   • To create a new app or workflow from scratch, open the Apps window, click Apps on the toolbar for an app or Workflow for a workflow, and then click Create New.
   • To create your own version or edit one you already published, select the app or workflow in the Public Apps folder, click either Apps or Workflow, and then click Copy.
   • To edit an unpublished app or workflow you are working on, select the app or workflow in your Apps under development folder, click either Apps or Workflow, and then click Edit.
2. Click the section header to expand the section into which you want to add the list field.

Step 2: Select the list type to add

List, Integer List, and Decimal List fields

1. Select the list type to use, either List, Integer List, or Decimal List.
2. Click and drag the list object from the Lists section on the left to the expanded section in the middle.
3. Click in the Label field to display its details on the right.
   • Label: Edit the label as you want it to be displayed in the app.
   • Default item to display: After entering the list in the step below (Edit list button), select the default item for the list.
   • Make this field required: Select to require the user to select at least one item in the list.
   • Exclude this item if nothing is entered: Click this option if you want to skip this list when nothing is entered in the app.
   • Tool tip text: Enter text to inform the user about how to use the field when viewed in the app.
4. To add a list item:
   1. Click Edit list.
   2. In the Edit list window, click Add.
   3. Double-click in the Display column, edit the display name of the list item, and click Save.
   4. Double-click in the Argument column, enter the command-line command according to the tool's requirements, and click Save.
   5. Double-click in the Value column, enter the value for the list item, and click Save.
   6. Repeat for each item in the list.
   7. Click Done.

List Tree (hierarchical lists) fields

1. In the Lists section on the left, click and drag the List Tree item to the location in the selected section.
2. Click in the List Tree Label field to display its details on the right.
3. In the Details section on the right:
   • Tree List label: Edit the label as you want it to be displayed in the DE.
   • Make this field required: Select to require the user to select at least one item in the list.
   • Exclude this item if nothing is entered: Skips the item if no item is selected.
   • Tool tip text: Edit as needed.
4. Click Edit hierarchical list to open the Edit list window:

   • Check Cascade determines how the list functions when a user takes action upon a section or field. By combining the cascade option with the Single selection only option, you can allow the user to select only one list item, one or more list items, or all list items. Select the cascade option to use:

     Cascade type	When parent is selected	When only a child	With Single Selection Only option
     Both	Selects parent and all its children (default)	Selects only the checked child or children; highlights parent to indicate a selected child	Able to select only one child
     Parent	Selects only the parent	Selects both that child or children and its parent	Selects only the checked child and its parent
     Children	Selects both the parent and all its children	Selects only the checked child	Able to select only one child
     None	Selects only the parent	Selects only the checked child	Able to select only the parent or only one child

   • Single selection only: Allows the user to select only one item in the list. When used in combination with the Check Cascade method, it is possible to specify the list items that may be selected.
   • To add a group:
     1. Click .
     2. Click in the Display cell to edit the group name.
     3. Click in the Argument cell to enter the argument, according to the tool's requirements.
     4. Click in the Value to enter the value of the folder.
     5. Click in the Tool tip text cell to enter the tool tip text for the group.

     6. Repeat for each group to add.

        To add a new group after you have added a list item, click Command+Click (Mac) or Control+Click (PC) to deselect the group, or you can drag the new group out to the desired level.

   • To add an argument (list item):
     1. Select the group into which you want to add the list item.
     2. Click .
     3. Click in the Display cell to edit the list item name.
     4. Click in the Argument cell to enter the argument, according to the tool's requirements.
     5. Click in the Value cell to enter the value of the item.
     6. Click in the Tool tip text cell to enter the tool tip text.
     7. Repeat for each argument to add.
   • To set the default group or argument, select the item and then click the checkbox in the Default column.
   • To delete a group or argument:
     1. Click the group or argument to delete.
     2. Click .
     3. Repeat for each group or list item to delete.
5. When done entering list tree items, click Done.
6. Click Preview and then click Preview UI. When done, close the Preview window.
7. Click Save.

Deleting a list field

1. In the middle section, hover over the item to delete until you see a blue border around the object:
   
2. Hover over the the gray icon at the top right until it turns red:
   
3. Click the icon to complete the deletion.
4. Click Save.