How to Specify the Task Payload Data Structure

To specify the task payload data structure:

  1. Click the Data tab.
  2. Click the Add icon and select a payload type:
    • String

    • Integer

    • Boolean

    • Other

    The Add Task Parameter dialog box is displayed, as shown in Figure 29-14.

    Figure 29-14 Add Task Parameter Dialog

    Description of Figure 29-14 follows
    Description of "Figure 29-14 Add Task Parameter Dialog"
  3. Enter the details described in Table 29-5:

    Table 29-5 Add Task Parameter Dialog Fields and Values

    Field Description

    Parameter Type

    Select Type or Element and click the Search icon to display the Type Chooser dialog box for selecting the task parameter.

    Parameter Name

    Accept the default name or enter a custom name. This field only displays if Type is the selected parameter type.

    Editable via worklist

    Select this check box to enable users to edit this part of the task payload in Oracle BPM Worklist. For example, for a loan approval task, the APR attribute may need to be updated by the user reviewing the task, but the SSN field may not be editable.

    You can also specify access rules that determine the parts of a task that participants can view and update. For more information, see Specifying Access Policies and Task Actions on Task Content.

    Use Collections

    If a task uses collections, then define this parameter to use collections. Click the Add button to provide the collection name and the Xpath expression for the collection type. Use Expression Builder to look up the collection type from the schema.

    Note:

    You can only define payload mapped attributes (previously known as flex field mappings) in Oracle BPM Worklist for payload parameters that are simple XML types (string, integer, and so on) or complex types (for example, a purchase order, and so on). If you must search tasks using keywords or define views or delegation rules based on task content, then you must use payload parameters based on simple XML types. These simple types can be mapped to flex columns in Oracle BPM Worklist.

  4. Select the type, as shown in Figure 29-15.
  5. Click OK to return to the Human Task Editor.

    Your selection displays in the Data section.

  6. To edit your selection, select it and click the Edit icon in the upper right part of the Data section.