remoteremove-page macro

Overview

The {remoteremove-page} macro is used as an Action to remove previously published content from a space on a different Confluence Server, Data Center or Cloud instance.

• Content is developed in a space on the source server
• Published content is pushed to a space on a remote server
• The {remoteremove-page} macro can remove the published content from the remote server

This is generally only required when content becomes obsolete and should be removed from the remote published content.

For more information, see: Remote-space publishing

Requirements

Before using this macro, you must ensure both the source and target Confluence instances are properly configured. For more information, see Remote-space publishing.

Where to use it?

Optional.

One or more {remoteremove-page} macros can be put in a {trigger} macro.

Parameters

Basic example

This example will remote-publish to a remote Confluence instance defined by the "MyDestination" publishing configuration. Once published, the user will have an option to unpublish the page (submit=Unpublish) at which point the published page will be removed from the remote Confluence instance. From the Unpublished state, they can either republish it, or make it obsolete.

{workflow:Remote-space publishing}
   {state:Editing|submit=Review}
   {state}
   {state:Review|approved=Published|rejected=Editing}
      {approval:Review}
   {state}
   {state:Published|updated=Editing|final=true|submit=Unpublish}
   {state}
   {state:Unpublish|approved=Published|rejected=Obsolete|hidefrompath=true|updated=Editing}
      {approval:Page Unpublished|approvelabel=Republish|rejectlabel=Make Obsolete}
   {state}
   {state:Obsolete|submit=Editing|updated=Editing}
   {state}
   {trigger:statechanged|state=Published}
      {remotepublish-page:MyDestination}
   {trigger}
   {trigger:statechanged|state=Obsolete}
      {remoteremove-page:MyDestination}
   {trigger}
{workflow}

Note: The final=true parameter on the Published state is not required for remote-space publishing, however it helps to clarify which versions of content are published in the source space.

All examples

• Page:
  Advanced remote-space publishing

See also

External links:

• Remote Publishing for Comala Document Management app

Workflow Authoring Guide:

• {remotepublish-page}
• Remote-space publishing