Overview
A workflow can be added to pages in a space configured as a target space for publishing using one of the Comala Document Management family of apps.
Publishing a page to the target space creates a new page version in the target space.
The publishing action does not include any properties for a workflow applied to the source space content.
When a Comala workflow is enabled and applied as a space workflow for all the pages in a target space
Publishing a page for the first time | The page in the target space is set to the initial state of the target space applied workflow |
|---|---|
Publishing a previously published page | If the current state of the workflow on the target space page includes an Updated transition
If the current state of the workflow on the target space page does not include an Updated transition
|
Publishing sync status and workflow state
The publishing sync status for a published page does not change when the following workflow events occur on the target space page with the applied workflow:
changes state (unless this is as a result of an Updated transition)
reviewers are assigned or unassigned to an approval
reviewers approve or reject the page
state due date expires or is changed by a user
Publishing a page does not remove document activity on the target space page.
When a Comala workflow is applied to the target space, you may need to disable the copying of content properties in the source space publishing dashboard.
Example - target space page workflow and sync status behavior
For example, we have a source space A that publishes to an empty target space B.
Space B - the target space
has a workflow applied (this can be a workflow from any of the three Comala Document Management family of apps)
The following custom workflow (created in Comala Document Management) is active for the space.
When publishing a page from source space A to target space B, we are initializing the state of the target page to the initial state of the workflow applied to that target page.
For each subsequent publishing of a source page, the workflow state of the target page will remain as it was when first published unless the current workflow state at the time of the publishing action has an Updated transition.
In our example workflow, the Review state and the Approved state each have an Updated transition.
Changes in the target space page applied workflow state and page publishing status
Example actions | Example target space page workflow activity and publishing status | |
|---|---|---|
| 1 | A new page is created in source space A, named Page
Page is published to target space B. | Publishing status
Workflow state
In our example, the Draft state  |
| 2 | Target space page Page in target space B is submitted for review to workflow state Review | Publishing status
Workflow state
 |
| 3 | Page in target space B in workflow state Review is approved by one assigned user (out of three assignees) | Publishing status
Workflow state
|
| 4 | Edit source space page Page in space A | Publishing status
Workflow state
Publishing changes in status do not affect the workflow unless there is a page update on the target space page, for example, publishing a page from the source space. |
| 5 | Page in target space B in workflow state Review is approved by all assigned reviewers | Publishing status
Workflow state
|
| 6 | Edit target space page Page in space B in Approved state | Publishing status
Workflow state
|
| 7 | Publish source space page Page from space A to target space B | Publishing status
Workflow state
Publishing is recognized as a page update in the target space, but the workflow does not have an updated transition in the draft state. |
| 8 | Target space page Page in target space B is submitted for review again to workflow state Review | Publishing status
Workflow state
|
| 9 | Edit source space page Page in space A | Publishing status
Workflow state
|
| 10 | Publish source space page Page from space A to target space B | Publishing status
Workflow state
Publishing is recognized as a page update in the target space. The workflow has an Updated transition in the Review state that listens to this event and transitions the workflow. |
Publishing the source space page only causes a change in the workflow applied to a target space page when the current applied workflow state includes an Updated transition.
In our example above, only the Review state and the Approved state have an Updated transition.
A Comala workflow can be applied in the source space and can be used together with Comala Publishing to publish pages using a workflow event - on transition to the final state or on a workflow trigger event.