task macro

Overview

The task macro is used to automatically create tasks when a workflow state is entered.

Optional.

One or more task macros can be put in a state macro.

Within a state, each task must be uniquely named.

Tasks can be added for each workflow state using the Edit states panel in workflow builder

Parameter	Required	Default	Notes	Ver

Parameter	Notes	Ver
unnamed first parameter or `name`	Name of task: Within any `state` macro, each `task` macro must have a unique name The name can use any character set supported by your Confluence server – except some reserved characters.	3.0+
`assignee`	Task assignee: Username – must have edit permission on the associated content Supports Value References If no assignee specified, any user with edit permission on the associated content can assign or complete tasks. Filter by label There are no items with the selected labels at this time.	3.0+
`duedate`	Due date for task completion: Format can be either: Explicit date in the format: `YYYY-MM-DD HH:mm` (v4.12+) ISO 8601 Duration Period See Expiry Dates for more information Supports Value References If specified, the task, if not completed, will eventually expire and trigger a taskexpired event. Page: Expiry Dates
`note`	Note to associate with the task: Plain text Can use any character set supported by your Confluence server – except some reserved characters. Logged in activity report and sent in notifications Filter by label There are no items with the selected labels at this time.	3.2.7+
Deprecated The following parameters are no longer supported.
`type`	Obsolete Task types are no longer supported – use {approval} macros instead, with customised button labels.	3.0 ↓ 3.2

You can add one or more workflow tasks to each state using the workflow builder:

Added tasks are listed in the state panel for the workflow state.

A state can be configured to automatically transition once all tasks are completed using its completed parameter.

You can add this transition using the workflow builder:

The following Events relate to tasks:

{workflow:name=Task example}
   {state:Tasks|completed=Done}
      {task:Some task}
   {state}
   {state:Done}
   {state}
{workflow}

Page:

Expiry Dates — States, tasks, and messages can be set to expire on a certain date or after a certain amount of time
Page:

Make tasks disable a review — Two ways to use tasks to disable a review. The first way uses a precursor task state where the tasks can be set and completed. The second example uses a Value Reference as a condition to check that all tasks are complete. For the value reference method, you will need the Reporting for Confluence app in addition to Comala Document Management.