Use a Comalatech workflow trigger event to publish a page

Overview

Using the Comala Document Management for Confluence Cloud app you can use a Comala workflow trigger event to action the publishing of content to a target destination space.

In the instance you need to have installed

• the Comala Publishing app

• the Comala Document Management for Confluence Cloud app

You must have

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

• an active Comala workflow on the draft content that includes a workflow trigger that includes the publish-page action

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

 If a publish trigger is added to the workflow, a workflow transition to the workflow final state (if present) will not publish the page.

Content in any state can also be published using the standalone publishing option.

Adding a trigger event to publish a page

If a user wants to publish using a different workflow event than "when reaching the workflow final state" the user can edit a custom workflow and add a /wiki/spaces/CDMCD/pages/13929807873. 

In the workflow below, the Second-Publish state is the workflow final state.

We could apply this workflow to a document in a draft space Human Resources Draft and Comala Publishing would publish and sync the document on each workflow transition to the Second-Publish state.

The workflow can be edited to add the following trigger markup. This would action publishing of the content on a transition to the First-Publish state instead of the transition to the final state (the Second-Publish state).

[{"event": "on-change-state",
		"conditions":
		[
			{"state": "First-Publish"}
		],
		"actions":
		[
			{"action": "publish-page"}
		]
}]

The trigger markup can be added to a custom workflow using the Comala Document Management visual editing tool workflow builder.

Once the updated workflow with the trigger is added and applied the content is published to the target destination space on each occurrence of the trigger event - the transition to the First-Publish state.

On the page, a popup allows a user to approve the content to action the workflow transition to the First-Publish state.

The workflow publish-page trigger action occurs on the change of workflow state.

The document is published to our configured target space Human Resources Published.

When a publish-page trigger is added to a workflow, the publish action on the workflow transition to the final state is not actioned. In our example, the Second-Publish state is the final state and a transition to the Second-Publish state would not cause the document to be published.

Details of Comala JSON trigger events and the publish-page trigger action are available in the Comala Document Management product documentation including

• an overview of JSON Triggers

• a list of JSON Trigger Events

• details of the publish-page trigger action

• adding JSON markup for a trigger using workflow builder

Related Links

• Publish a page on transition to a Comala workflow final state
• Single-page publishing