Overview
Workflow parameters, defined by the {workflowparameter} macro, can be referenced by their name wrapped in @ (at) symbols.
...
Changes in the workflow parameter value
If the value for an editable workflow parameter is changed by a user
- the new value may not be available for use by the workflow in the current state
- the new value will then only be available for use by the workflow after a transition occurs
If the value for an editable workflow parameter is changed by the space administrator in the Parameters dashboard
- the value will be used when the workflow is added to content
- the value is not updated on content where the workflow is already applied
The workflow parameter value may only be available for use by the workflow after a workflow process has occurred, for example, after a transition occurs from the initial workflow state.
In an approval
- if a parameter reference Editor is used to limit the assignees for a review, the value of the parameter reference is available in the initial state of the workflow
| Code Block |
|---|
{approval:Check Review|selectedapprover=@Editor@,admin} |
...
| Code Block |
|---|
{approval:Check Review|user=&@Editor@,admin} |
This occurs because when a workflow is first applied to a page in space mode
- only the link to the workflow is created (and any page restrictions, if using same-space publishing, are applied)
- the page (or blog post) itself won't actually transition into the initial workflow state, despite it appearing that way when you look at the workflow status bar.
If you look at the Activity Report - Content for the content, you'll see that there are no workflow-specific entries listed. These pages are referred to as "unprocessed".
- assigning a reviewer is a workflow process and it will use the workflow parameter value
- pre-assigned reviewers will not use the workflow parameter value until after a workflow process had occurred such as a transition
Example - using an initial state to add workflow parameter values for an approval pre-assigned reviewers
...
A space admin can also change the parameter value using the space tools Parameters dashboard before any workflow activity has taken place or a user has set up the parameter value.
...