Page Comparison

Overview

When a Comalatech workflow is added to a page using Using the Comala Document Management for Confluence Cloud you Management for Confluence Cloud app you can use a Comala workflow trigger event to action the publication of the page to the destination space.If 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 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 add a JSON markup for a trigger using workflow builderedit a custom workflow and add a /wiki/spaces/CDMCD/pages/13929807873. 

In the Quality Management Systems workflow , the 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 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 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