Screen Location: Space Tools → Document Management → Parameters tab
Overview
This screen allows space administrators to edit the values of parameters defined with the {workflowparameter}
macro in templates which are applied in space mode.
A workflow parameter will ONLY be added to the space tools Parameters screen if it has been defined with a default value in a workflow .
For example, across the workflows added to the space above there are three workflow parameters with defined default values.
- Due Date with a default value of P5M (5 Months)
- Editor-in-Chief with a default value of user Suni Conn
- Expiration Period with a default value of P7D (7 days)
If a workflow parameter is not displayed then the workflow may need to be edited to add a default value for the parameter
- if the workflow is copied to the space as a space workflow (space scope) you can edit the workflow in space tools Comala Document Management dashboard to add a default value for a workflow parameter.
- if the workflow is added to the space but remains linked to a global template (global scope) a global Confluence admin needs to add the default value to the workflow in the Global Workflows dashboard.
Editing workflow parameter values
To edit a parameter value just choose the current value it and it will go in to edit mode.
This value will then be used in the workflow
- the updated value will be used when first applying the workflow to content
- content with the workflow already applied will not have the parameter value updated
If a {workflowparameter}
macro has the edit=true
setting users will be able edit the value at page-level via the workflow popup.
The edited value for the parameter may only be available for use in the workflow after a transition occurs from the state in which it was changed.
See: Workflow setup
Deleting values
You can also delete the value, however it might cause problems if the associated workflows are still active.
By default
- using Delete to remove the parameter value in the space tools Parameters screen will not delete the parameter defined in the workflow
- removing the workflow from the space that was the source of the added parameter does NOT remove the parameter value from the space tools Parameters screen
When adding a space workflow, a parameter reference value may only be available for use by the workflow after a workflow process, such as a transition, occurs.
For example, the initial state should not include the use of the parameter reference value for a due date or pre-assigned reviewers for approvals to avoid blocking your workflow. Alternatively, you can choose to Initialize states when applying a space workflow.