.png?version=1&modificationDate=1697620298955&cacheVersion=1&api=v2&width=550)
| Info |
|---|
If a user has been disabled or deleted the workflow history will display the users username and the default avatar. The username name is the stored user display name for the instance. |
The current Workflow History Document Activity can also be viewed by
- choosing the page tools menu Attachments option
- choose the added Document Report tab
The Document Report tab will not be displayed if there is no active workflow on the content and workflow history was removed/no workflow had been previously applied.
If there is no active workflow on the content but workflow history was retained the page tools Workflow HistoryDocument Activity option will not be available but any previous workflow history can still be viewed in this Document Report tab after opening the page tools menu Attachments option.
A user with edit or admin permission can clear the workflow history for a page by deleting the Workflow HistoryDocument Activity attachment.
A space admin can choose to remove workflow history for all content in the space using the Clear workflow history document activity option in the space settings Document Control dashboard.
Document Control Workflow Report for the space
To see a report for the entire space choose the Workflow Report link on the left sidebar. This space report can be filtered by the current status or by approvals that are assigned to you as the current user.
My Pending Approvals
You can see the approvals that are assigned to you in the current space in the workflow report.
If there are multiple approvals in a state the reviewer avatars are replaced by the named approval avatar. Choose the approval avatar to view the assigned reviewers for an approval.
When there are multiple approvers assigned choose a reviewer to view details of all the reviewers for the approval.
The approver list is read-only. You can sort and filter the display.
You can also use a search filter on the Confluence search to find pages that are assigned to a specific person (see below).
Document state macro
Add the document state page macro to display one or more of the current workflow state, the date of change to the state and the state expiry date (if an expiry is added).
The document state macro is compatible with the Confluence page properties macro and page properties report macro.
Document approvals macro
Add the document approvals macro page macro to display information for approvals in a selected workflow stat. The macro can be configured to display the overall status of the approval; the approval assignees; the latest approval decision for each assignee; the date of the reviewer decision and the reviewer comment.
The document approvals macro is compatible with the Confluence page properties macro and page properties report macro.
Confluence Search Filters for workflow macros
Confluence provides some macros that support CQL filters, like the Content by label macro or the Page properties report macro. Comala Document Management adds a filter for "Workflow state".
REST API CQL fields
If you are searching with your own app using the Confluence REST API the following field names should be used.
| Field | Field name |
|---|---|
| Workflow state | cw_state |
| Assigned approver | cw_approver |
!NB cw_state search is case sensitive
| Code Block | ||
|---|---|---|
| ||
cql=cw_approver="John" and cw_state="Approved" |