Design

Back Next

Human task XQuery utilities

If you use a Human Task step in a process, you can use human task utility functions when working with XQuery in Process Designer or in any field that uses a formula to set a value.

The human task utility functions are available under the

Human Task Utilities

section of the Expression Editor.

The following table describes the human task utility functions:

Function	Syntax	Description
getHumanTaskId	task:getHumanTaskId(humanTaskStepName)	Returns the ID of the human task associated with the specified Human Task step name. You can use the ID for other actions such as getting information about a human task, reassigning a task, or canceling a task.
getHumanTaskInfo	task:getHumanTaskInfo(humanTaskId)	Returns the following information about the human task based on the specified human task ID: Task ID Task name Status Priority Task initiator Stakeholders Potential owners Administrators Task owner Task creation date User who created the task Task activation time Task expiration time Skippable option value
reassignHumanTask	task:reassignHumanTask(humanTaskId, users, groups)	Reassigns a human task to the specified users and groups, and returns the task ID. If you reassign the task to a single user, the user becomes the task owner. If you reassign the task to a group or multiple users, a user must claim the task to become the task owner. To specify multiple users or groups, use a comma character as the delimiter. For example, use the following syntax: task:reassignHumanTask(humanTaskId, ('<user1>','<user2>'), ('<group1>','<group2>')) If you want to reassign the task to a specific user and not a group, use the following syntax: task:reassignHumanTask(humanTaskId, '<user1>',")
cancelHumanTask	task:cancelHumanTask(humanTaskId)	Cancels a human task and makes the task obsolete. Returns the task ID. The process continues to the next step after a human task is canceled.