Automatic Publishing

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 can define and manage several publishing configurations.

For each publishing configuration you have to

• Add a unique ID for this publishing configuration

• 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 Save configuration button gets available, as soon as all needed inputs have been added. By clicking Save configuration the publishing configuration is saved for later usage.

Delete configuration removes this publishing configration block.

The Publish button gets available, as soon as all needed inputs have been added. By clicking Publish 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.

Additional publishing configuration blocks can be added by clicking on Add configuration.

Archiving

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.

note

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.

Now you can add ADONIS Process Manager Model Viewer or Properties macros to the template.

note

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.

note

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