This tag locates a list of tasks that match the specified criteria and saves those tasks to a result object named by the var attribute. None of this tag’s attributes, other than var, are required. However, if you indicate that you want inactive as well as active tasks (by setting active="false") or unclaimed as well as claimed tasks (unowned="true") to be returned, you must also specify a process ID. When you know the specific task ID for the task you want returned, it’s best to enter that ID directly in the taskElementId attribute.

Attributes

The following attributes are defined for the pws:getTasks tag:

Attributes

Description

Required?

var

Names the result object to contain a list of tasks.

yes

userOnly

Indicates whether only tasks assigned to the current user (true) or all tasks for the current process (false) are located. The default value is false.

no

unowned

Indicates whether unclaimed (true) or all (false) tasks are located. The default value is false.

no

active

Indicates whether active (true) or all (false) tasks are located. The default value is true.

no

processId

The ID for the process that has tasks you want to locate.

yes, if unowned is set to true or active is set to false.

index

The number that designates where, in the context of the accessed tasks, the list of returned tasks should begin. The default value is 0.

no

taskElementId

The ID for a particular task that you want to locate.

no

count

The total number of tasks that are saved to the result object.

no

Result Object Properties

The following properties are defined for the result object produced by the pws:getTasks tag:

Property

Description

processSize

Contains the number of tasks in the project workflow’s parent process.

processTasks

Contains the list of located process tasks.

projectSize

Contains the number of tasks in the project workflow.

projectTasks

Contains the list of located project workflow tasks.

size

Contains the number of located tasks.

tasks

Contains each located task.