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 document using a Comala Document Management workflow trigger

Owned by Robert Alexander Marshall
Last updated: Apr 19, 2024
3 min read
1 Overview | 2 Requirements | 3 Workflow trigger | 4 Adding a trigger to a workflow | 5 Related pages

Overview

In addition to standalone publishing of content using Comala Publishing you can allow your editors to publish a single page or blog post from a source space using a Comala Document Management custom workflow with an added workflow trigger.

The workflow trigger listens for a workflow event, for example, a change of workflow state; a page approval or an expiry of a state. On this event, the publish-page action macro in the workflow trigger publishes the page or blog post.

Requirements

In the instance to set up different space publishing using a Comala workflow 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 Document Management workflow on the content

  • added a trigger with the publish-page action macro to the applied workflow

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

A space administrator can also configure the publishing dashboard to only publish the latest approved workflow final state version of a page or blog post with an applied workflow when publishing the whole space using the space publishing dashboard Publish option.

Workflow trigger

The publish-page trigger can be configured to listen to a workflow event.

This event can be a state transition - the statechanged event. Events can be filtered to be constrained to a specific occurrence of the event - the statechanged can be filtered to a specific destination state. For example, in a workflow with a Published state, state=Published.

{trigger:statechanged|state=Published} {publish-page} {trigger}

If the Published state is set as the workflow final state, this allows your page editors to publish the latest approved final state version and be used together with configuring whole space publishing to use the workflow final state version.

You may want to disable the option to Publish a single page for the space when using a Comala workflow to publish a page.

Adding a trigger to a workflow

A trigger can be added to a custom workflow as markup in either the Comala Document Management markup editor or the visual editing tool workflow builder.

The trigger can be set to listen for one workflow event. These events include

  • statechanged

  • pageapproved

  • stateexpired

An advanced Comala Document Management workflow can be created to manage the publishing process, for example, to include checking the success of queued publishing actions, setting and using trigger custom events, and error handling.

Related pages

Comala Document Management

Atlassian Marketplace