Different-space publishing
- Robert Alexander Marshall
Overview
Different-space publishing allows you
to edit draft pages in one space on a cloud site
then publish these pages to another space (in the same cloud site)
Comala Document Management manages the review and approval of your documentation, ensuring only approved content is published. The integration with Comala Publishing then lets you control where and when approved pages are published in a different space.
When using Comala Publishing to publish pages to another Confluence Cloud space, there are two ways to action the publication process through a Comala Document Management workflow. You can publish a page by either:
final state publishing using the applied workflow transition to the final state
workflow trigger publishing - using a workflow trigger containing the publish-page trigger macro
Final state publishing
Once the page reaches the final state of the applied workflow, it is published. The approved page is published automatically.
The workflow must contain a final state, but no other setup is required.
Publishing using a workflow trigger
You can use this to publish a page at any stage in the workflow. It can be configured with a number of conditions. The page is published automatically using the trigger but requires the workflow to be edited to add the trigger. It is useful for creating staged publishing actions and publishing the page at different milestones in your documentation process.
For example, the following workflow trigger publishes a page on the state change to the First Publish state in an applied workflow:
"triggers":
[
{"event": "on-change-state",
"conditions":
[
{"state":"First Publish"}
],
"actions":
[
{"action": "publish-page"}
]}
]If the workflow includes a final state, the page is also published on the transition to this state.
The Comala Publishing for Cloud app must be installed to enable different-space publishing. Comala Publishing Cloud can only be used to publish Confluence Cloud pages. Comala Publishing cannot publish blog posts. |
Activating different-space publishing
There are two steps to setting up different-space publishing:
Configure the Comala Publishing app to connect the draft (source) space and the public (target) space – see also: How Comala Publishing for Cloud works
apply a Comala workflow to the pages in the source space
With an applied workflow containing a final state, publishing of a page automatically occurs on the workflow transition to the final state. No other setup is required.
Publishing on a different applied workflow event, such as a change of state, requires a workflow trigger to listen for the event and publish the page. The page is automatically published when the event occurs. The publish-page workflow trigger must be created in JSON code and added to the custom workflow.
Related pages
Comala Document Management
Comala Publishing Cloud