This site has moved to the integrated Appfire documentation and information site for our apps.

From February 2024 this site is no longer updated.

Take a look here! If you have any questions please email support@appfire.com

task macro

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.

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

Parameters

Parameter

Required

Default

Notes

Ver

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

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.



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

Notes

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

Events

The following Events relate to tasks:

  • taskcreated

  • taskassigned

  • taskcompleted

  • taskexpired

Example

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

All examples

See also

Workflow Authoring Guide:

User Guide:

Reporting Guide: