The Automatic Publishing feature of the ADONIS Process Manager for Confluence enables you to publish ADONIS objects or models found with saved ADONIS search queries as pages in Confluence (one page per object or model). These pages are created according to custom Confluence Page templates.
Changes in the result of the search query trigger changes in the published pages automatically (adding / removing / updating pages). This makes it possible to instantly make all desired BPM information available in Confluence and keep it up-to-date.
With Automatic Publishing you can:
- Use saved ADONIS search queries to define the content to be published
- Automatically publish an individual Confluence page for each object or model of a saved ADONIS search query result
- Use Confluence Page templates to customize the layout and content of your published pages
- Use the Properties macro or the Model Viewer macro in page templates to pull in the latest data and models
- Automatically archive pages for objects or models that are not in the search query result anymore
How to use Automatic Publishing
Save your personalized search query in ADONIS
On the toolbar at the top of the screen, click "Find".
Execute a search with your keywords and filters. Click the "Save" button above the search bar to save your search query.
Name and describe your search query and click "Save" again. Your query is now saved and can be used again in ADONIS.
To make the saved query available in the ADONIS Process Manager for Confluence it has to be published. To do this, click the "My Searches" button.
Find your search query and click the "Public" button to publish it. Close the dialogue.
Configure Automatic Publishing in Confluence
Open the publishing configuration
The Automatic Publishing feature can be configured and run in the Space Settings of your Confluence space.
Choose Space Settings from the sidebar. Open the ADONIS Process Manager - Space Settings from the Manage pages section.
Open the tab Publishing to access the configuration options for publishing.
Here you have to
Select an ADONIS instance
Select an ADONIS repository
Select an ADONIS query
Select a target page in this Confluence space
Select a Confluence template
Select a target page for archived pages (only if Archiving is activated)
The Submit button gets available, as soon as all needed inputs have been added. By clicking Submit the configured publishing is executed. After completion, an information dialog displays the number of created pages and lists the pages that have not been created.
Per default Archiving is active. This optional feature moves all published pages that are no longer part of a saved search query result to the selected archive target page.
Additionally archived and a timestamp is added to the name of the archived page.
If a page that already contains published pages is selected as target page, the existing pages that are not in the search query result are moved to the archive folder. Therefore, it is not recommended to publish different search queries to the same target page with active archiving.
Create a Confluence page template
The Select template field defines, which Confluence page template should be used when a new page is created. The templates allow you to produce a consistent documentation of your ADONIS content across multiple pages in this Confluence space.
Custom page templates can be created from within the Confluence Space Settings. Choose Space Settings and open Templates in the Look and feel section.
To create a new template, click on the Create New Template button.
The selected ADONIS models and objects of the Model Viewer and Properties macros in templates will be overwritten during the Automatic Publishing actions. Thus, you can randomly select models or objects during macro creation.
Pages created by Automatic publishing are optimized for the new editor. Thus, you might want to enable the configuration option Convert pages automatically in the Space settings.
Detailed information about creating templates can be found in the Confluence documentation: Create a template | Confluence Cloud | Atlassian Support