Fields

This property box determines which field values the Retrieve Business Process Variables activity will make available as tokens and as collections available to the For Each Row and For Each File activities.

To configure Fields

  1. Add the Retrieve Business Process Variables activity to your workflow definition by dragging it from the Toolbox Pane and dropping it in the Designer Pane.
  2. Select the activity in the Designer Pane.
  3. Under ClosedFields in the Properties Pane, use the drop-down menu to choose the Forms process from which you want to retrieve values.
  4. Click in the box below the drop-down to select fields.
  5. The ClosedChoose Fields dialog box lists the fields, their Closedtype, the form they are associated with (if the process has more than one form), and the name of token that stores the field's value. Select the fields you want to retrieve values from.
  6. Each field is of one of the following types and the token that stores the field's value has a token tag appropriate to its type:

    • The text, drop-down, radio button, and checkbox field types are stored as strings and have the String token tag. Checkbox field types also produce a token for each option. These tokens can have one of two values: True or False. If the checkbox has an "Other" option, another string token is produced that contains the value entered for this option.
    • The e-mail field type is stored as a string and has the String and Email token tags.
    • The address field type is stored as a string and has the String and Address token tags.
    • The date field type is stored as a date/time and has the Date token tag.
    • The number and currency field types are stored as numbers and have the Numeric token tag. Currency also has the Currency token tag.
    • The file upload field type does not produce a useful token. However, you can use a For Each File activity to perform activities on each uploaded file.
    • The table and collection field types do not produce any tokens, but the columns in a table and the fields in a collection are available as multi-value tokens. You can also use the For Each Row activity to perform activities on each item in a table or collection field and to access all columns in a table for a specific row or all fields for a specific item in a collection.

  7. Optional: To find a particular field or fields, you can narrow the list of fields shown with the following options:
    • Name: Begin typing a field name to look for field variables by name.
    • Forms: If the forms instance has more than one form associated with it, use the drop-down menu to display fields associated with a specific form.
    • Only show selected field variables: Select this option to see only the field variables you have selected.
    • Show deleted fields: This option will appear if any fields were deleted from one of the forms associated with the instance, after the form was submitted. You can still retrieve values from deleted fields. Select this option to only see the deleted fields.
  8. Optional: Select or clear all fields by choosing Select/Clear all at the bottom of the dialog box.
  9. Optional: Sort the contents of this dialog box by clicking a column header.