Overview
Comala Document Management adds several new filters to Confluence search, allowing you to quickly locate workflow-managed content.
This feature requires Confluence 5.8 or above.
Adding filters
Navigate to the Confluence search page by typing something in the search box at the top of the page, then hit the Enter key.
Look for the Add a filter link in the sidebar and click it.
Type "work" or "workflow" to list options for Comala Document Management workflow-managed content filters
Choose the workflow-managed content filter required and a search item to filter your search.
You can add as many filters as you want.
Example
Here's an example of several filters in use.
Those filters would have the following effect.
|
Available filters
The following workflow-related search fields are available if you are using Confluence 5.9 or above:
| Filter Name | CQL Field | Type | Notes | Ver |
|---|---|---|---|---|
| Has Workflow | awphasworkflow | TEXT | Filter to content which has a workflow applied Use | 5.1 |
| Workflow Approval Assignee | approvalassignee | USER | Filter by assigned reviewer See also: Assigning reviewers | 4.12+ |
| Workflow Approver | approver | USER | Filter by user who approved content during a review See also: Content reviews | 4.12+ |
| Workflow State | state | TEXT | Filter by current workflow State | 4.10+ |
| Workflow State Change | statechange | DATE | Filter by date of last workflow state Transition | 4.11+ |
| Workflow State Expiry | stateexpiry | DATE | Filter by current workflow state Expiry Date See also: State expiry date | 4.11+ |
| Workflow Task Assignee | taskassignee | USER | Filter by workflow Task assignee See also: Assign a task | 5.1 |
| Workflow Name | workflowname | TEXT | Filter by workflow name | 6.0 |
Read Confirmation Status | readAckStatus | TEXT | Filter by the read confirmation status. Possible values: pending, acknowledge, overdue | 6.0 |
These fields can be used in Confluence Search, any macros that support CQL and the CQL REST API.
Search results
The Confluence search only indexes the latest versions of content, so the search results will always show the latest version regardless of workflow state.
If you are using Same-space publishing, which distinguishes between "Published" and "Draft" versions of content
- the search results will continue to show the latest version
- but content excerpts will be removed if that version is not published
This will happen regardless of whether you use the workflow search filters or not.
If this is a problem, use Different-space publishing or Remote-space publishing instead.
If you are using metadata values created with the Comala Document Management {set-metadata} macro, these are only indexed by Confluence and appear in the Confluence Search if the Comala Metadata app is installed.
See also
Atlassian documentation