Page Comparison

...

Space Admins – Parameters - Space Tools when your workflow is applied in space mode or page mode
For a workflow parameter to be added to the space tools Parameters tab, a default value must have been added to the workflow.
The value set in space tools Parameters will be retrieved by the workflow only on initial application of the workflow.
Users – via the Workflow Popup workflow popup (in both space mode and page mode)
If the workflow parameter is configured as editable, a user can edit the parameter value using the ellipsis menu option in the workflow popup.
Users – via the Workflow Popup workflow popup (in both space mode and page mode)
If the workflow parameter is configured as editable, a user can edit the parameter value using the page tools menu option.
Users – Workflow setup via the Workflow Popup workflow popup (in both Space Mode and Page Mode space mode and page mode)
If the workflow parameter is configured as editable, a user will be prompted to add or confirm the workflow parameter value(s) when adding the workflow to content

...

Parameter

Required

Default

Notes

Ver

unnamed first parameter
or name

Name of the parameter.

3.0+

macro body

The default value for the parameter

can use any character set supported by your Confluence server – except some reserved characters
can be overridden in Parameters - Space Tools if the template is used in Space Mode space mode
can be overridden at page or blog post level, via Workflow Popup workflow popup, in both Page Mode and Space Mode page mode and space mode, if edit=true is set

3.0+

description

The description for the parameter

plain text
can use any character set supported by your Confluence server – except some reserved characters

Filter by label (Content by label)

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

3.0+

edit

false

Should this parameter be editable at the page or blog post level?

true – yes, make it editable via the Workflow Popup workflow popup
false – no, it can only be edited via Parameters - Space Tools

Tip: If set to true, the value of the parameter can be used as a normal Value Reference value reference and can be accessed via the get-metadatamacro.

edit=true can also be required to be set upon transition to a state by setting them in the requiredparams list for that state.

Filter by label (Content by label)

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

3.0.3+

type

string

Parameter type

string – text
- Usually plain text, but can contain wiki notation depending on where the parameter value will be used
user – a single username or comma separated list of usernames
duration – an ISO 8601 duration
group – a single Confluence group or comma separated list of group names
list – a list of values to choose from – see: options parameter below

Filter by label (Content by label)

showLabels	false
max	6
showSpace	false
sort	title
cql	label = "macro-workflowparameter" and label in ( "parameter-type" , "type-duration" , "type-user" , "type-string" , "type-group" , "type-list" ) and label = "example" and space = currentSpace ( )

3.0+

options

string

Required if the parameter type is list.

List options

comma-separated list of values
can use any character set supported by your Confluence server – except some reserved characters
supports Value References value references

Filter by label (Content by label)

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

3.0+

Panel

bgColor	#DEEBFF

Parameter values and unprocessed content

When adding a space workflow, a parameter reference value may only be available for use by the workflow after a workflow process occurs - such as a transition. For example, the initial state should not include the use of the parameter reference value for a duedate or pre-assigned reviewers for approvals to avoid blocking your workflow as these values may not be available until after a workflow process has taken place

To process content and ensure parameter values are set up, a space admin can also choose to Initialize states on applying a space workflow. This action will process the pages and the workflow parameter value will be available for use by the workflow in the initial state.

Events

The following Events events are generated when page-level parameters are updated

pageparameterupdate

Examples

When the following workflow is first added to a space or page in a space, then a space admin can edit the value via Parameters - Space Tools.

...

Adding edit=true allows end-users to edit the value at the page or blog post level, both in Page Mode and Space Mode page mode and space mode.

Code Block

language	text

{workflow:name=Parameters}
	{workflowparameter:Review Group|type=group|edit=true}
      confluence-users
   {workflowparameter}
   {state:Test}
	  {approval:Review|group=@Review Group@} 
   {state}
{workflow}

...

Versions Compared

Old Version 7

New Version 8

Key

Events

Examples