approve-children macro

Overview

The approve-children macro is used to approve a specific approval, where active, on all child pages of the page where the action was triggered.

Where to use it?

Optional.

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

Parameters

Parameter	Required	Default	Notes

Parameter

Required

Default

Notes

unnamed first parameter

Name of the approval to approve.

Only applies to child pages where there is an active approval of that name.

comment

Approval comment

plain text

Able to use any character set supported by your Confluence server except for some reserved characters.

state

State in which the child page must be in order to be approved.

The approve-children macro does not work if the page is using also using the K15t Scroll Versions app.

Events

The following events are associated with approvals

newsapproved
pageapproved

Example

{workflow:name=Approve Children}
   {state:Editing|submit=Content Review}
   {state}
   {state:Content Review|approved=Published|rejected=Editing}
   {approval:Review}
   {state}
   {state:Published}
   {state}
   {trigger:pageapproved|approval=Review}
      {approve-children:Review|comment=Parent approval approved|state=Content Review}
   {trigger}
{workflow}

Events with anonymous users

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