Publish a page on transition to a Comala workflow final state
Overview
Comala Publishing integration with a Comala workflow can automatically publish a page from a source draft space when the applied workflow transitions to the final state.
The integration with the Comala Document Management app also supports publishing pages using a workflow trigger to publish a page on a specific event in the workflow. This enables flexible publishing, automating publication at different workflow stages. Using a workflow trigger to publish a page does not disable publishing of the page on a transition to a workflow final state.
Prerequisites
In the cloud site, you need both of the following apps installed:
Comala Publishing app
You can also use the Comala Document Control or Comala Document Approval app.
You must have
Configured a target space in the publishing app space settings of the source space
An active Comala workflow applied to a page that includes a final state
view and edit permission for both the source space and the target space
Publish a page
Publishing a page occurs on the transition of the workflow on the page to the final state (the final approved state) in the workflow.
Only one state in a workflow can be set as the final state.
For example, a new page created in the source space and not yet published
Draft workflow state is Review
Publishing state is NEW
Approving the page using the workflow state dialog box
Transitions the applied workflow to the final state (in our example, the Approved state)
Publishes the page to the target public space
Sets the publishing state to Synced
A page refresh can be required to update the publishing state byline. The progress of the publishing action is also displayed.
On successful publishing of the page
The publishing state is Synced
The publishing state dialog box displays details of the last sync
An on-screen message also confirms the page is published to the target space
Use the View published version link option in the dialog box or message to view the published page version in the target space
To maintain approval and publishing integrity, the space administrator can disable the Comala Publishing standalone publishing option in the app space settings. Page editors can then only publish a page by transitioning to the workflow’s final state. The Publish option is not displayed in the publishing state dialog box on the page in the target space.
Where possible, publishing pages to the target published space maintains the hierarchy of the source space.
If the page is the first to be published in the target space, it is copied to the root of the target space.
An on-screen message in the source space warns you that the current page has been copied to the root of the target space.
If a child page receives approval before the parent page is published and the workflow triggers a page publishing action, the page might be published to the root folder of your target space instead of its expected location.
A Comala workflow can be applied to both pages and blog posts. However, Comala Publishing only publishes pages and a blog post with a Comala workflow applied.