approve-page macro

Overview

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 macro.

Parameters

Parameter

Required

Default

Notes

Ver

Parameter

Required

Default

Notes

Ver

unnamed first parameter



Name of the approval to approve.

Only applies if there is an active approval of that name.



comment





Approval comment:

  • plain text

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



credentials





Obsolete 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 from v5.0.8

Events

The following events are associated with approvals:

  • newsapproved

  • pageapproved

Example

{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

o

 

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.

o

See also

Workflow Authoring Guide:

Reporting Guide: