Show TOC

Procedure documentationCreating Entry Lists Locate this document in the navigation structure

 

The Entry List wizard enables you to create predefined lists of entries to be used as input for certain controls. Each entry list can be used as input for a single control.

You can create the following types of entry lists:

  • Static: An entry list in which you predefine each item as a static value.

  • Dynamic: An entry list that is populated dynamically from a data service at runtime, according to the input fields selected and the corresponding values that you assign.

You can also create global entry lists for reuse in multiple models and controls. For more information, see Working with Global Entry Lists.

Prerequisites

On the Layout board, you have added a control with a bound field to a view or container element.

Procedure

  1. Right-click the control and choose Entry List from the context menu. The Entry List Wizard is displayed.

    Note Note

    The Entry List option is available only for certain controls that support entry lists.

    End of the note.
  2. Enter a name for the entry list, select the entry list type (Static or Dynamic) and click Next.

  3. If you selected Static:

    1. Click the Add Row (Add Row) button to add entries to the list.

    2. Define a unique value and display text for each entry. The unique value is the field value that is transferred to the data service at runtime. The display text is the value that is displayed in the control for selection at runtime.

    3. Select entries and use the Move Up (Move Up) and Move Down (Move Down) buttons to reorder the entries if required. This defines the order in which the entries are displayed in the list at runtime.

  4. If you selected Dynamic:

    1. Use the Search in, Search for, and Type fields to locate and select the data service from which you want to retrieve the entries at runtime, and click Next. For more information about searching for a data service, see Discovering Data Services.

    2. If you chose a data service with multiple or clustered input ports, you need to map the output port of the view element to the input port(s) of the data service. You do this by dragging from the icons on the left to the icons on the right. A mapping line is created between the two items. You can delete the mapping by right-clicking the line and choosing Delete Mapping from the context menu. For more information, see Mapping Data.

    3. The Target Field column displays the fields channeled through the input port that you selected. The Assigned Value column enables you to define the mandatory values that you need to send to the data service to get the output values you want in your list. Specify the values in the Assigned Values dropdown list using the following methods:

      • Assign a field from the dropdown list. The fields in the dropdown list are fields in the current form view that are of the same type as the input field type.

      • Use the Dynamic Expression Editor (choose Define expression from the dropdown list) to create a formula defining different values according to input value, such as IF('US','United States','Other'). For more information, see Working with Dynamic Expressions.

      • Enter a different field found in the form (using the Dynamic Expression Editor). For example, for BANK_CTRY, you might assign a field @BANK_REGION. For more information, see Working with Dynamic Expressions.

      • Enter a fixed value, such as United States for the BANK_COUNTRY input field.

    4. Click Next. From the Output port dropdown list, choose the data service port that returns the values used to populate the entry list.

    5. If the output port contains a clustered dataset, from the Cluster node dropdown list, select the source node that contains the field whose values you want to use for the entry list.

    6. In the table, map each field: In the VALUE row, specify the source field from which the field value should be taken. In the TEXT row, specify the source field from which the display text should be taken (the value displayed in the entry list at runtime). You specify output values in the same way as input values, described previously.

      Note Note

      If you are defining a dynamic entry list for a stored procedure, the output port can be OUTPUT (usually a single record value) or _RESULT) a record set, or table). Usually, you will select _RESULT. The system will automatically determine the probable output fields of the stored procedure. These are the same fields that are displayed in the results pane of the Test Data Service dialog box.

      End of the note.
      • You can use the Additional entries checkbox below the output table to add static items to the entry list. Items defined in this way are displayed at the top of the entry list at runtime; they are not displayed alphabetically with the dynamically added items.

  5. Click Finish.

Result

The entries in the list are displayed in the control at runtime.

Note Note

You can modify the entries in an entry list at a later stage by right-clicking the control for which the entry list was defined, and choosing Entry List from the context menu. In the displayed Edit Entry List dialog box, you can modify the entry list definitions as required.

You can delete an entry list by clicking the Delete Entry List button in the Edit Entry List dialog box.

End of the note.