Approvals for Document Changes

[Tyler Ford]

Hello,

I am wondering how users/admins are handling documents that you want to have approved before the final version is submitted? We have many policies that adhere to various compliance standards that I would want to go through an approval workflow and then have that approval documented within the document being approved. Is there an addon that achieves this or some workflow within Confluence?

[Mikael Sandberg]

Hi @Tyler Ford,

Welcome to Atlassian Community!

I have used Comala Document Control and Comala Publishing in the past for this. Currently I have created our own process were you from within Confluence can start the review process, this will create a ticket in JSM, and once approved automations will copy the page to an external space that is linked to JSM. It will also link the external page to the internal. 

[Tyler Ford]

Can you provide details on this automation you are using? That might be ideal with my organization.

[Mikael Sandberg]

So the automation in Confluence is making a web request to an automation in JSM that creates the ticket and adds information about the page, like the title, page Id. I also have a Rovo agent that generates a summary and keywords that is added to the ticket. Then it is up to the user to fill out who should approve, and once the form is submitted it goes to an approval status. Once approved, the information collected in the ticket is stored in Assets. Then I have an automation in JSM that adds a comment on the page, this triggers an automation in Confluence to copy the page to the external space, then it will call back to JSM to trigger another automation that will link the external page to the internal page by adding a banner on the internal page, and then update the object with the page Id and URL for the external page.

I am also reusing a lot of these automations for the process of updating the page, the only difference from the initial publish is that I remove the external page and then create a new one.

[Mikael Sandberg]

All in all I have ~30 automations on the JSM side, most of them do specific tasks like adding the banner to the internal page, and then I have a couple that acts as dispatchers and calling the specific automations based on what is needed.

[Matteo Gubellini _SoftComply_]

SoftComply Document Manager for stricter controls, depending on what standards you need to comply to. Ours focuses on MedTech industry and adjacent ones.

Matteo

[Kris Klima _K15t_]

Hi @Tyler Ford 

On top of what @Mikael Sandberg mentioned, there are these apps.

• Workflows for Confluence by Appfox
• Capable for Confluence by Capable
• Breeze by B1nary

Back in the day I tested them all and they'd all work in your environment. Each takes a slightly different approach to workflows and approvals, and comes with its own set of extra features, so one or the other may resonate better with your specific environment.

But they're all easy to set up and vendors are great to work with.

Method 2

A different method would be using a two-space approach. More on this in my Community article, but TL:DR is that you have one space (Source) where authoring and approving takes place and another space (Target) to which you synchronize the content. The idea is that only a selected few have access to Source, while Target is read-only for a wide audience.

The apps that I mention above actually can combine approval workflows with the two-space approach so you can have a really watertight control over both workflows and who can access what and when.

Method 3

If you want to deploy workflows on a SPACE level and create trackable versions of your documentation, there's Scroll Documents by K15t. Basically, once you approve content in the entire space, you can create a snapshot of it (think 'virtual space') and publish it to another space as a version. (This can be useful if you need to, for example, keep your documentation versions for audit purposes).

Method 4

And, of course, you can mix and match the native Confluence approach that @Danno recommended with the apps that I mentioned :) 

Disclaimer: I work for K15t, maker of Scroll Documents.

[Danno]

@Tyler Ford if you are limited in purchasing add-ons you can try creating your own. Here is a walk through.

Restrict who can Approve Pages in Confluence CliffsNotes Edition 469