Problem

Information for same topic can exist in different spaces
Users might not know about key terms / available terms that they can use to look for help with
It takes a lot of time to collate information from all sources and place them in a single page

The image below shows a simplified scenario whereby a page containing several key terms can be quickly created and can benefit from usage of CQL Search Macro.

Canned Search for Confluence > How to use CQL Macro to build a corporate encyclopedia > key_summary.png

Proposed Solution

Create template containing CQL Search Macro (using $self as Default Query Term).
Use template to create the individual pages for each key term quickly to present collated information on each key term.

Note: $self is recommended to be used so that pages can be created quickly as the page title will be used to as default query term

Example

The image below shows how the template can be used to collate all information on “Macro”.

Similar page can be created quickly for other terms (E.g. tutorial, testing, setup) presented in a main page.

Canned Search for Confluence > How to use CQL Macro to build a corporate encyclopedia > using_title_as_search.png

For the above page, the template is configured as follows:

Create template with name “Collate for Confluence”
- Add CQL Search Macro in Template
- For macro,
  - Set CQL to label = ‘confluence’ AND type IN (blogpost, page) AND text ~ $$query*$$
  - Set Default Query Term to $self