Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
absoluteUrltrue
excludeSee also
typeflat
separatorpipe

...

pOverview

Excerpt
hiddentrue

Approve an approval

The approve-page macro is used to instantly approve a specific approval.

Where to use it?

Optional.

One or more approve-page macros can be put in a trigger macrotrigger macro.

Parameters

Parameter

Required

Default

Notes

Ver

unnamed first parameter

(tick)


Name of the approval to approve.

(blue star) Only applies if there is an active approval of that name.


comment



Approval comment:

Plain
  • plain text

Can
  • can use any character set supported by your Confluence server – except some reserved characters

.


credentials



Status
subtletrue
colourRed
titleObsolete
This parameter is no longer available and should not be used.

The requirement for credentials is now defined for each approval. The method of credentials is configured at the global level.

Removed


in 5

from v5.0.8

Events

The following Eventsfollowing events are associated with approvals:

  • newsapproved

  • pageapproved

Example

Code Block
theme
languagetextRDark
{workflow:name=Approve Page}
   {state:Editing|submit=Content Review}
   {state}
   {state:Content Review|approved=Published|rejected=Editing}
      {approval:Review}
   {state}
   {state:Published}
   {state}
   {trigger:statechanged|state=Content Review}
      {approve-page:Review|comment=Instant approval}
   {trigger}
{workflow}

The trigger action will cause the workflow to transition using the approve-page macro.

  • the transition will be  approved=Published

  • the page activity will display the transition to the Content Review state and the immediate transition to the Published state

oImage RemovedImage Added

It is useful to include a comment in the approve-page macro. This will be displayed in the page activity report.

Events with anonymous users

The approve-page macro will not work with events that are ascribed by the workflow to an anonymous user. For example the stateexpired event.

oImage Modified

See also

Workflow Authoring Guide:

Reporting Guide: