Page Comparison

Overview

When a Comalatech workflow is added to a page using Comala Document Management for Confluence Cloud you can use a workflow trigger event to action the publication of the page to the destination space.

Comala Publishing can be used with Comala Document Management for Confluence Cloud to publish content using a Comala workflow trigger event.

...

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 page 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

...

...

Content A page in any state can also be published using the standalone publishing option 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 JSON markup for a trigger using workflow builder. 

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

...

We could apply this workflow to a page 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 publication publishing of the content on a transition to the In Approval First-Publish state instead of the transition to the final state (the Published Second-Publish state).

[
	{
		"event": "on-change-state",
		"conditions":
		[
			{"state": "In ApprovalFirst-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 will be is published to the target destination space on each occurrence of the trigger event .

Image Removed

In our example, the page is published on the transition to the In Approval state.

The individual page is copied to the target destination space.

Image Removed

With the trigger publish action in the workflow, the transition to the workflow final state will not cause the content to be published.

Possible error when amending a workflow state name

If a workflow state name is changed using workflow builder or editing the JSON code markup the publishing trigger may not work in earlier versions of Comala Document Managemen for Confluence Cloud. 

• the trigger will still be set to listen for the event linked to the previous state name.

Any change in the state name will need to be updated in the JSON code for the trigger- 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 page is published to our configured target space Human Resources 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