Add and edit workflow parameters in workflow builder

Owned by Robert Alexander Marshall
Last updated: Dec 19, 2024
2 min read

You can add and edit workflow parameters in the workflow builder visual editor for a custom workflow in the app space settings.

Choose the Parameters option in the workflow panel.

cdmc_workflowbuilder_workflowpanel_one_workflowparameter_added.png

Any existing workflow parameters are listed.

cdmc_workflowbuilder_parameters_listing_cew_copy.png

Choose  + Add Parameter to add a new parameter (or select an existing parameter to edit).

The Add parameter dialogue box is displayed.

Create the workflow parameter by

  • adding the parameter Name

  • selecting the Type of parameter data using the dropdown menu

  • optionally set a Label to use as a friendly name for the workflow parameter

  • adding a Description

The type of parameter data determines the options for adding the value. For example, a user parameter expects one or more Confluence usernames as the value.

A duration parameter provides options to set the value using a specific Period of time, a specific Fixed Date, or an ISO_8601 duration value. You can also use value reference as the data type. You can then, for example, use another workflow parameter for the value.

The Period and ISO_8601 duration are relative time periods set from the workflow event. For example, when used for the value of a workflow state expiry, the duration is set from the transition date to the state.

Examples of the use of an IS0 6081 duration string are

  • P6M1D - a period of six months and one day

  • P1Y - a period of one year

  • PT6H30M - a period of time of six hours and thirty minutes

Choose

  • Apply to update the workflow parameter