Activating snapshot publishingThere are three steps to setting up snapshot publishing to take place on a Comala workflow event: Install Comala Publishing to your instance and enable snapshot publishing for a space Set up snapshot publishing in your space tools snapshot publishing dashboard Update your workflow to trigger the snapshot publishing process and apply to your documents (see below)
Publishing a snapshot using a workflow triggerA snapshot can be published using Both action macros can be used in the same trigger. Snapshot-page action trigger workflow markupThe publishing is triggered by an action macro, snapshot-page, which must be used in a trigger. Code Block |
---|
| {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=mycollection|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. In the example above, the value for the collection parameter must be the name of a snapshot collection that has been linked to or created in the space by the space administrator the value for the editor parameter is a metadata value set in the workflow trigger prior to the snapshot-page macro action .The user who is added as the value for the metadata must have been added as a collection contributor to the collection permissions by the user who created the collection. Info |
---|
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 markupWith 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: Code Block |
---|
{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. |