1. Developing SOA Applications with Oracle SOA Suite
  2. XPath Extension Functions
  3. Workflow Service Functions
  4. dynamicTaskAssign

dynamicTaskAssign

This function selects an assignee of the specified type from the input, using the specified pattern, in the context of the current task.

This function can only be used in the context of a human task.

Signature:

hwf:dynamicTaskAssign(patternName, participants, inputParticipantType, targetAssigneeType, isGlobal, invocationContext, parameter1, parameter2, ..., parameterN)

Arguments:

  • patternName: (Mandatory) Name of the pattern to use. The patterns ROUND_ROBIN, LEAST_BUSY, and MOST_PRODUCTIVE are automatically provided. It is possible to configure the SOA server with custom patterns.

  • participants: (Mandatory) The participant or participants from which to select the assignee. This can be a string or element containing a participant name or a comma-separated list of participant names, or a set of elements containing participant names or comma-separated lists of participant names. Participants must all be of the same type.

  • inputParticipantType: (Mandatory) The type of the input participants (user, group, or application_role).

  • targetAssigneeType: (Mandatory) The type of assignee to select (user, group, or application_role). The value must match the context in which the function is used (for example, it must be a user if dynamically selecting an owner user. Note that if inputParticipantType is the user, the only valid value here is the user.

  • isGlobal: A boolean value that indicates to access the pattern using tasks of all types or tasks of the same type as the current task. This is optional. It defaults to false.

  • invocationContext: The string to uniquely identify where this function is used. If not specified, a default context is assigned.

  • parameterN : Some dynamic assignment patterns enable parameters to be specified. The parameter values can be specified as name-value pairs, using an ?=? character as a delimiter (for example, ?TIME_PERIOD=7?).

Examples:

hwf:dynamicTaskAssign(?LEAST_BUSY?,?jcooper,jstein,mtwain?,?user?,?user?,?true?,?ErrorAssignee?)

hwf:dynamicTaskAssign(?ROUND_ROBIN?,?LoanAgentGroup?,?group?,?user?,?false?,?OwnerUser?)

hwf:dynamicTaskAssign(?MOST_PRODUCTIVE?,task:task/task:payload/task:users,?user?,?user?,?false?,?OwnerUser?,?TIME_PERIOD=7?)

hwf:dynamicTaskAssign(?LEAST_BUSY?,?DeveloperRole?,?application_role?,?group?)