Publish a page on transition to a Comala workflow final state

Owned by
Robert Alexander Marshall
Last updated: Jun 28, 2024
3 min read

1 Overview | 2 Publish a page

Overview

Comala Publishing integration with the Comala Document Management supports publishing a page from a source draft space by transitioning the content to the final state in an applied Comala workflow.

In the cloud site, you need

You must have

  • configured a target space for the published pages in the space settings publishing dashboard of the source space

  • an active Comala workflow applied to a page

    • the applied workflow must include a final state

  • view and edit permission for both the draft space and the target space for publishing

Pages in any state can also be published using a Comala workflow by

The publish trigger option is only available when using the app with Comala Document Management for Cloud by editing the workflow to add the workflow trigger markup.

A page in any state can also be published using the Comala Publishing standalone publishing options.

Publish a page

Publishing a page occurs on a transition of the workflow on the page to the final 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 Review

  • publishing status NEW

cpc_sourcespace_page_draftstate_new_publishingstatus.png

Approving the page using the workflow popup

  • transitions the applied workflow to the final state - the Approved state

  • publishes the page to the target space

  • sets the publishing status to Synced

cpc_sourcespace_page_finalstatewf_synced_publishingstatus.png

A page refresh may be required to update the publishing byline. The progress of the publishing action is also displayed in the publishing popup.

On successful publishing

  • the publishing status update is Synced

  • publishing popup displays details of the last sync

  • an on-screen message also confirms the page is published to the target space

To view the published page in the target space View Published Version link options in the popup or message.

Where possible, the publishing of pages to the target 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 draft space warns the user that the current page has been copied to the root of the target space.