| Table of Contents | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
...
The document approvals macro information for a workflow state is shown as a table, with one header row per approval and one row per assignee reviewer of each approval.
...
The macro can be configured to display
the state for the required approvals
the approval in the specified state (or in the case of a state with multiple approvals a list of approvals)
the overall
status of the approval
the list of assignees that belong to reviewers for each approval including the
assignee reviewers (name and avatar)
status of the approve/reject action that this specific assigneeeach reviewer has undertaken for that specific approval
date of when that action has taken place
comment added, if any, to that action
...
Adding the macro to a page
Edit the page and type /doc and select the document approval macro option.
...
Choose Document Approvals to add the macro to the draft page.
...
By default the macro displays the current workflow state name and the approvals in the state.
Select the macro and choose the pencil icon to open the macro editor.
...
If the The State dialog box is left empty by default and the macro will display the approval information for the current workflow state. state
a separate row is added for each approval in the state
With no checkboxes completed the macro only lists the name of the approvals for the state.
...
Select the Show status checkbox in the macro editor to display the overall status of the approval.
...
...
a separate row is added for each approval in the state
...
If a reviewer has been assigned, the information for each reviewer will be displayed in a separate row.
A separate column is added for each selected checkbox
...
in the macro editor to display information for each approval.
...
If the
...
approval has a minimum number of reviewers required, a separate unassigned reviewer row is displayed in the report for each required reviewer. These are populated as users are assigned or undertake review decisions.
Transitioning the content
The information displayed by the macro is dynamic.
No state specified
If a state is not specified in the macro editor, transitioning the workflow to a different state will display the approval information for the new current state.
...
No approval in state
If there is no approval in the current state the document approvals macro will display the following message for the state.
...
State specified
Setting a state in the document approvals macro editor displays the approval information for that state, irrespective of the current state. On a transition from the specified state, the macro table displays the individual approval status with a separate row displaying the overall status for the approval in the specified state.
...
If there is no approval in the specified state the document approvals macro will display the following message for the state..
...
Configuring the macro
The overall status is displayed
...
Configuring the macro
The macro can be configured to display approval information on the page.
Display approvals in a named state
Approvals information can be displayed for a single named state added to the macro editor.
...
The macro will display the current approval information for this state irrespective of the current workflow state for the content.
...
Display approvals reviewer and status information
...
Check the boxes to display one or more of the following
the overall status for each approval in the state (Pending, Rejected, Approved or Approved and Signed)
...
If there is more than one approval in the state, add the name of the approval to be displayed in the Approvals order option. Multiple approvals in a case will be listed in the comma separated order (with no spaces) that they are added to this option box.
Check the required boxes to configure the macro to display one or more of
the users assigned to each approval as reviewers - Show status
the reviewers for each approval by checking one or both
Show assignee reviewer avatar
Show assignee reviewer name
the current status of each reviewer’s decision for the approval (Pending, Rejected, Approved, Approved and Signed, Unassigned) - Show Statusstatus
the date each reviewer’s last action (if any) - Show date
any comment added by the reviewer on undertaking their last recorded action
Selected macro options are previewed in the macro on the draft page.
Publish the page to view the document approvals macro displayed in the page subtitle on the content.
...
...
If Show status is checked, both the status of the overall approval and (if reviewer avatar or reviewer name is checked) the current decision for each reviewer is displayed.
Multiple approvals in a state
...
If there is more than one approval in a state each approval is listed in a separate row.
...
Each reviewer for an approval is displayed in a separate row.
To limit the display for selected approvals in a state, add the name of each approval as a comma-separated list (with no spaces) in the Approvals order option.
...
Approvals are displayed in order they are appear in the comma-separated list.
...
Use with other macros
| Panel | ||||||
|---|---|---|---|---|---|---|
| ||||||
The document approvals macro is compatible with the Confluence Page Properties macro and the Page Properties Report macro. |
On the draft page, add the one or more document approvals macro as a table value values in the page properties macro.This is displayed on the published page in a table.
...
The page properties report macro can then be added to a page to report the value of the example page property we created - Comala Management App - Approvals detailson the added values.
...
Exporting pages to pdf and Word
The approvals macro table of information is included when exporting to pdf or Word.
...
Reviewer avatars are not exported.
In the pdf and Word export the date (if included in the macro configuration) is in UTC format.