publish-page trigger action

Contents:

1 Overview
2 "publish-page"
3 Example trigger code

Overview

Use the publish-page trigger action when you need greater flexibility and control over when and where a page is published to another space in your Confluence Cloud site. It’s ideal for complex workflows and staged content releases, publishing your pages automatically at different workflow stages.

You can use the Publish Page action in a workflow trigger to publish a page when a specific workflow event occurs.

Adding a Publish Page trigger action does not disable the default Comala Publishing behavior on the transition to the final state. If both publishing actions are configured, publishing occurs on both the trigger event and the transition to the final state.

You should avoid using the Publish Page trigger action on a transition to the final state to prevent duplicate publishing of the same page version and publishing errors.

When the workflow trigger event occurs, the trigger checks that any required conditions are met, and if they are met, the Publish Page action publishes the current page to a different space in the same Confluence Cloud site using the Comala Publishing for Cloud app.

`"publish-page"`

When added to a workflow trigger, publishes a single page on a workflow event to a different space using Comala Publishing for Cloud app.

action (publish-page)

This trigger action is only available when Comala Publishing Cloud is installed, and the current space has been enabled as a source space for publishing to the target space.

For the workflow shown below:

cdmc_custom_wf_visualflowcart_withFirstPublish_state.png

You can add the following workflow trigger using the visual editor:

cdm_visualeditor_addtriagger_first-publishstatechange_firtspublish_state_publishpage_action.png

This publishes the page on the state change to the First Publish state in the applied workflow.

The Publish Page action (the “publish-page” macro) publishes the content in the target space on the state change event.

The content bylines are updated on the source space page.

cpc_publishingbyline_synced_interimpublishingworkflowstate_publishingdialogbox.png

The target space for publishing the page is configured in the Comala Publishing space settings. Publishing can also occur based on the configuration of the Comala Publishing app, such as a space publishing action or a single-page publishing action, including publishing on a transition to the workflow final state.

Adding a workflow trigger with a Publish Page action does not prevent the page from being published by the Comala Publishing app when the workflow transitions to the final state.

Example trigger code

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

Workflow triggers can also be added and edited in the code editor.