Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
maxLevel3
minLevel2
absoluteUrltrue
excludeSee also
typeflat
separatorpipe

Overview

Excerpt
namewf_parameters_overview

A workflow parameter reference can be used to allow an applied workflow to indirectly access a value that can be set elsewhere, for example in the

...

Parameters

...

- Space Tools or a workflow parameter value set by a user on the page.

One or more workflow parameters can be added to a workflow using workflow builder.

...

Image Added

The workflow parameter can be set to use one of the following data types

  • character string

  • Confluence username(s)

  • Confluence groupname(s)

  • duration

  • a list of set values

Workflow parameters can be referenced in the workflow by their name wrapped in @ (at) symbols.

In the workflow markup the workflow parameter is defined by the workflowparameter macro.

Where can they be used?

You can use parameter references in the following situations

...

Code Block
{approval:Check Review|user=&@Editor@,admin}

This occurs because when a workflow is first applied to a page as a space workflow

  •  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

In the Document 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

Use an initial state to set workflow parameter value for 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.

...