Page Comparison

...

Table of Contents

maxLevel	2
minLevel	2
absoluteUrl	true
exclude	Overview
type	flat
separator	pipe

Overview

Excerpt

hidden	true

Add tasks to workflow states

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 state macro.

Within a {state}, each {task} must be uniquely named.

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

Parameters

Parameter	Required	Default	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 (Content by label)

showLabels	false
max	6
showSpace	false
sort	title
cql	label = "macro-task" and label = "parameter-assignee" and label = "example" and space = currentSpace ( )

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.

Filter by label (Content by label)

showLabels	false
max	6
showSpace	false
sort	title
cql	label = "macro-task" and label = "parameter-duedate" and label = "example" and space = currentSpace ( )

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 (Content by label)

showLabels	false
max	6
showSpace	false
sort	title
cql	label = "macro-task" and label = "parameter-note" and label = "example" and space = currentSpace ( )

3.2.7+

Deprecated

The following parameters are no longer supported.

type

Status

subtle	true
colour	Red
title	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 automatically transition once all tasks are completed via its completed parameter.

Events

The following Events relate to tasks:

taskcreated
taskassigned
taskcompleted
taskexpired

Example

Code Block

language	text	theme	RDark

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

All examples

Filter by label (Content by label)

showLabels	false
max	500
showSpace	false
sort	title
excerptType	simple
cql	label = "macro-task" and label = "example" and space = currentSpace ( )

Versions Compared

Old Version 3

New Version Current

Key

Overview

Where to use it?

Parameters

Deprecated

Notes

Events

Example

All examples

See also