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

From February 2024 this site is no longer updated.

Take a look here! If you have any questions please email support@appfire.com

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 20 Next »

Overview

Snapshot publishing allows you create static versioned documents from your dynamic Confluence content, freezing content from Confluence macros that display live content in the snapshot document.

Snapshot Publishing can be used as a standalone feature of the Comala Publishing app to create a snapshot of a document but a snapshot of a Confluence document can also be created using a workflow trigger.

Once a snapshot is created, it can be organized and managed in one or more themed groupings of snapshot documents - called collections - to create manuals, static records for audit.  View permissions for each collection can be added outside space permissions.

A global collections viewer in the Confluence header allows users to view snapshots in PDF or HTML format.

The Comala Publishing (Snapshot Publishing) app v3.0+ must be installed to enable snapshot publishing.

Requires Comala Document Management v6.17.6+

Activating snapshot publishing

There are three steps to setting up snapshot publishing to take place on a Comala workflow event:

  1. Install Comala Publishing to your instance and enable snapshot publishing for a space

  2. Set up snapshot publishing in your space tools snapshot publishing dashboard

  3. Update your workflow to trigger the snapshot publishing process and apply to your documents(see below)

Publishing a snapshot using a workflow trigger

A snapshot can be published using

  • the snapshot-page macro to create a snapshot that is added to a specified snapshot collection

  • the pdf-export macro to create a snapshot that is added to the page as an attachment

Both action macros can be used in the same trigger.

Snapshot-page action trigger workflow markup

The publishing is triggered by an action macro, snapshot-page, which must be used in a trigger.

{workflow:name=Snapshot Publishing}
   {state:Editing|submit=Review}
   {state}
   {state:Review|approved=Published|rejected=Editing}
      {approval:Review|assignable=true}
   {state}
   {state:Published|final=true|updated=Editing}
   {state}
   {trigger:statechanged|state=Published}
      {set-metadata:lastapprover}
      @user@
      {set-metadata}
      {snapshot-page|collection=@collectionname@|editor=@lastapprover@}
   {trigger}
{workflow}

The example markup above based on the example from same-space publishing, but we've added the trigger at the bottom.

When the state changes to Published, the trigger is activated and the snapshot-page macro instructs the Comala Publishing app to create a snapshot document from the Confluence document.

  • the collection parameter is required to add the snapshot to a named collection. The example uses a workflow parameter value reference @collectionname@ for the value of this parameter

  • the editor parameter adds the user who be set as the creator of the snapshot. The example uses a metadata value set on transition to the Published state for the value of this parameter

The user must have been added as a collection contributor to the collection permissions by the user who created the collection.

For snapshot publishing all the work is done by the snapshot-page macro. The snapshot-page macro can be used to publish the content from any state using an appropriate trigger event. 

pdf-export action trigger workflow markup

With Comala Publishing installed, the pdf-export macro can be used as an action to export a snapshot of page or blog post in PDF format and adds the pdf to the page as an attachment.

The pdf is added with a filename in the following format:

  • <confluence_filename>_<document_version>_<date_pdf_file_created>_<time_pdf_created>.pdf

{trigger:statechanged|state=Published}
      {pdf-export}
{trigger}

There are no macro parameters to configure.

The pdf-export macro can also be used with Scroll PDF Exporter 4.10.11 or higher.

Macros

Examples

Filter by label

There are no items with the selected labels at this time.

See also

Comala Publishing


  • No labels