Remote Publishing Workflow

Importing workflows

Find out how to Import Workflows

Remote Publishing workflow

_{requires v3.0.2+}

_{com.comalatech.workflow.repository.categories.label: Document Management|Sample}

-

This workflow allows one-way synchronization of a remote confluence instance.

You must set up the private and remote instances - see Workflow and Remote Space.

Content that is Published can be removed using the Remote Publishing app

when content is removed from the remote published instance, the Remote Publishing app transitions this content to the Removed state in the workflow.

Remote Publishing Workflow Markup

{workflow:name=Remote Publishing}
	{description}
	This workflow allows one-way synchronization of a remote confluence instance. Please visit the [workflow's page|https://wiki.comalatech.com/display/WORKFLOW/Remote+Publishing+Workflow] for instructions on how to set up the _private_ and _remote_ instances.
	{description}
    {state:Draft|submit=For Review}
    {state}
    {state:For Review|approved=Published|rejected=Draft}
        {approval:Publish}
    {state}
    {state:Published|final=true|updated=For Review}
    {state}
    {state:Remove|hidefrompath=true}
    {state}
    {trigger:statechanged|state=Published}
        {set-message:type=note}Page publishing pending...{set-message}
    {trigger}
    {trigger:statechanged|state=For Review}
        {set-message}{set-message}
    {trigger}
    {trigger:statechanged|state=Published|queue=true|newevent=pagepublished}
        {remotepublish-page:remote}
    {trigger}    
    {trigger:newsstatechanged|state=Published}
        {set-message:type=note}Page publishing pending...{set-message}
    {trigger}
    {trigger:newsstatechanged|state=For Review}
        {set-message}{set-message}
    {trigger}
    {trigger:newsstatechanged|state=Published|queue=true|newevent=pagepublished}
        {remotepublish-page:remote}
    {trigger}
    {trigger:pagepublished|success=true}
        {set-message:style=info}Page Published!{set-message}
    {trigger}
    {trigger:pagepublished|success=false}
        {set-state:For Review}
        {set-message:user=@user@|style=warning}publishing failed: @errormessage@ />{set-message}
    {trigger}
    {trigger:statechanged|state=Remove}
        {remoteremove-page:remote} 
    {trigger}
{workflow}

Workflow and remote space

You must have set up

a remote public Confluence instance for publishing the approved content
a private Confluence instance for the content that will be published

Both Comala Document Management and Comala Remote Publishing must be installed in the private source instance.

Once remote publishing is set up and content published, any content removed in the published instance will transition to the Remove state in the private source instance.

Setting up the remote instance

To setup the remote instance you are publishing to, you need to enable "Remote API" setting in Administration > General Configuration > Feature Settings.

You also need to have a user that has access to the general space.

We recommend you set up a user on the remote instance that only has access to the spaces you are publishing to for security purposes. This will also help to prevent accidental overwrites of other spaces.

Setting up the source instance

To set up the remote instance credentials, you have to set the parameters in the source instance:

-

The name of the Remote Configuration must match that of the workflow. In this case make sure you name it remote as this is the name used in the workflow. You can always change it and even have different configurations

Test the settings to make sure that the source instance can connect properly to the remote/public instance:

-

Publishing content

Content will now be published to the public instance when the page's reaches the Published state.

Publishing requires connection and transmitting data to the other instance, and this could take some time.

because we want to minimize any chance of error or session expiration we queue the request

A pending message is shown when the page is submitted for publishing:

If a published page is update, the state is changed to for renew and would have to be re-approved to get it republished.

Publishing all pages in the Space

If you want all the existing pages in the space to be published remotely, then you need to set the state of all pages to the Published state.

You can do this through the Initialize states feature available for each workflow in space tools Document Management dashboard.

-

Depending on the size of the space, publishing the entire space will take a few minutes.

Removing content remotely

To remove published content remotely, all you have to do is to change the state to Remove and the page will be removed in the remote instance.

This site has moved to the integrated Appfire documentation and information site for our apps.