Define the Value List for a Prompt (Text Prompts Only)

To define a list of values that Users can select in the Prompt:

  1. In the Value List drop-down, define whether to display a list of values that a User can select from in the Prompt window:
    OptionDescription
    None Select this option to have no list of values displayed for the User (User must type a word or phrase into the Prompt).
    List Values from a Table and Field Select this option to have a list of values displayed from a Business Object and field you select.
    List Values from a Collection Select this option to have values displayed from an XML or JSON collection in a web service lookup table. Then, select a collection (example: A result from a web service call saved as a variable). You can use all fields from the collection, or select (and order) specific fields to display. The prompt can return an entire row of JSON or XML, or a value from a single field that can be stored for later use. See the web service lookup example for more information.

    The selected collection must be a JSON or XML data type.

    Valid Values for a Field Select this option to have a list of valid values displayed from a field in the associated Business Object (example: Incident).

    This option is only available if the context of the Prompt (example: One-Step Action, Query, or Expression) is associated with a Business Object.

  2. If you select List Values from a Table and Field, select the Business Object that contains the fields with the values a User can select from in the Prompt window from the Table drop-down. You can choose to see Lookup Tables or all tables in the list.

    You can only select a table if you choose List Values from a Table and Field from the Value List drop-down. If you select Valid Values for a Field, the Business Object associated with the Prompt's context (example: One-Step Action, Query, or Expression) is shown. To change the table, you must change the Business Object association for the One-Step Action, Query, or Expression where the Prompt is being used.

  3. In the Field drop-down, select the Business Object Field that contains the values the User can select from in the Prompt.
  4. Select the User Can Only Choose Values from the List check box to prevent any values that are not in the list from being used in the Prompt. If not selected, Users can type any value into the Prompt.
  5. Select the Return Value from Different Field check box to have the Prompt return values from a field other than the one selected in the Field drop-down. Then, select the Field in the drop-down.

    This option is available only if you select List Values from a Table and Field in the Value List drop-down, and select User Can Only Choose Values from the List.