Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
hiddentrue

Publish pages and blog posts using Comala Document Management and Comala Publishing

Table of Contents
maxLevel2
minLevel2
absoluteUrltrue
excludeSee also
typeflat
separatorpipe

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.

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

Insert excerpt
AHP:Using publish and sync with the Comala Document Management family of appsAHP:
Using publish and sync with the Comala Document Management family of apps
namesinglepagewftriggerpublish
nopaneltrue

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 buildebuilderr.

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

  • statechanged

  • pageapproved

  • stateexpired

Insert excerpt
CDML:publish-page macro
CDML:publish-page macro
namecomalapublishing_wf_example
nopaneltrue

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

Filter by label (Content by label)
showLabelsfalse
max2
sorttitle
showSpacefalse
cqllabel = "comala_wf" and space = currentSpace ( )

Comala Document Management

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel = "space-publish-wf" and space = "CDML"

Atlassian Marketplace