Overview
The {task} macro is used to automatically create tasks when a workflow {state} is entered.
Where to use it?
Optional.
One or more {task} macros can be put in a {state} macro.
Within a {state}, each {task} must be uniquely named.
Parameters
Parameter | Required | Default | Notes | Ver |
|---|---|---|---|---|
unnamed first parameter |
| Name of task:
| 3.0+ | |
| Task assignee:
If no assignee specified, any user with edit permission on the associated content can assign or complete tasks.
Filter by labelThere are no items with the selected labels at this time. | 3.0+ | ||
duedate | Due date for task completion:
If specified, the task, if not completed, will eventually expire and trigger a
| |||
| Note to associate with the task:
Filter by labelThere are no items with the selected labels at this time. | 3.2.7+ | ||
DeprecatedThe 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 | ||
Notes
A {state} can be configured to automatially transition once all tasks are completed via its completed parameter.
Events
The following Events relate to tasks:
taskcreatedtaskassignedtaskcompletedtaskexpired
Example
{workflow:name=Task example}
{state:Tasks|completed=Done}
{task:Some task}
{state}
{state:Done}
{state}
{workflow}
All examples
-
Expiry Dates — States, tasks, and messages can be set to expire on a certain date or after a certain amount of time
-
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.