This site has moved to the integrated Appfire documentation and information site for our apps.

From February 2024 this site is no longer updated.

Take a look here! If you have any questions please email support@appfire.com

Publish a whole space using the applied Comala workflow latest approved final state version

publishinglogo.png

Overview

Using Comala Publishing and an app from the Comala Document Management family a space administrator can choose to publish only the latest approved workflow final state version of content with an applied Comala workflow when publishing a whole space.

If the current source space page version is in a draft workflow state, only the latest approved version is published.

Content without an applied Comala workflow or content without any previous workflow transition to the final state is not published

The workflow latest approved version (or published version) is created on the last transition that occurred to the final state of an applied Comala workflow. Only one state in a Comala workflow can be a final state, all other workflow states are considered as draft.

When a Comala workflow is applied, publishing of a single page or blog post also occurs on the transition to the applied workflow final state (the latest approved version).

Requirements

In the instance, you need

You must have

  • added a target space for the published content in the space settings of the source draft space

  • an active Comala workflow on the content

The workflow must include a final state

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

Publishing configuration

To publish only the latest approved workflow final state version of content when publishing the whole space the Use final state version option must be checked in the the space publishing options settings.

In the source space publishing dashboard (with the target space added)

  • choose Configure

  • scroll down to Settings

  • expand Space Sync Conditions

  • check Use final state version option

  • Save

Whole space publish

A Comala workflow is added to a space, enabled and applied as a space workflow to all the content in the space by a space administrator in the space tools Document Management dashboard (or the space Document Control dashboard for the Comala Document Control app or the space Document Approval dashboard for the Comala Document Approval app).

With space publishing configured to use the final state version and a Comala workflow applied, both the publishing status and the workflow state breadcrumb are displayed on a document in the space.

A space administrator choosing Publish in the space publishing dashboard would not publish the above page, UX Specifications to the target space

  • the page is currently in a workflow draft state, Draft

  • a workflow transition to the final state has not yet been actioned and there is currently no approved workflow final state version

The workflow popup is used to transition the workflow to the final state, Published.

On the transition to the final state in the applied workflow, the workflow creates an approved final state version.

The page is also published when the space administrator chooses to publish the whole space using the Publish option in the space tools publishing dashboard.

The space publishing action publishes the latest approved final state version for each page and blog post in the space with an applied workflow.

For our applied workflow, editing a published and synced page in the final state, Published, transitions the workflow to a draft workflow state

  • the publishing status is updated to Out of Sync

  • the workflow state is a draft state, Draft

  • the workflow breadcrumb in the page subtitle now includes a link, (view “Published”), to the latest approved version created on the last transition to the final state

A space administrator choosing to publish the whole space again will publish the latest approved final state version.

  • choose the (view “Published”) breadcrumb to view the latest approved final state version in the source space

  • choose View published version to view the published page in the target space

The space publish does not publish the current draft state version of any page

A document is not published when the whole space is published if there is not an approved final state version.

If single-page publishing is enabled then a page or blog post in a draft workflow state can be published by a page editor using the Publish button on a page effectively by-passing the space Use final state version publishing option setting that uses the applied Comala workflow final state for publishing to the target space.

Disabling the single page publish option limits publishing to a whole space publish by the space administrator or the approval transition of an applied workflow on a page or blog post.

Related pages

Comala Document Management

Atlassian Marketplace