Display Document Approvals on Confluence Pages with the SoftComply Change History app

July 28, 2022
Table of Contents

    REGULATORY REQUIREMENTS & THE CHANGE HISTORY APP

    You are all set up – your development team is working in Jira and your Quality Management System is set up in Confluence. You are getting input from your colleagues and your documents are being approved electronically. Everything is working perfectly.

    Time to audit your QMS. You export your documents into PDF to prepare them for the auditor. And you realise only then that the printed documents do not show all the necessary information that makes a Confluence page into a controlled document. Although the approval information is electronically stored and accessible, it is not displayed on the page.

    One of the most important requirements of electronic signatures for safety critical industries is the need to report certain information on the document itself. This requirement extends to any PDF export for submission to the applicable regulatory agencies and Notified Bodies.

    In Confluence Cloud there are several apps that can be used for electronic signatures. We typically recommend Comala Document Management paired with Comala Publishing. They offer a good level of customisation and compliance, including a very detailed audit trail for each page. This audit trail is very comprehensive (as it should be) but not easily consultable after a few approval rounds and it cannot be easily exported.

    We are happy to introduce the SoftComply Change History app to you for capturing and displaying your document approval history from Comala Document Management onto your Confluence pages in order to make your documents audit-ready.

    This app adds a customisable Change History table to any Confluence page provided you are using the Comala Document Management app. This can then be exported using the built-in or any other PDF exporter.


    Excerpt from 21 CFR 11 & how the SoftComply Change History app meets these requirements:

    REQUIREMENTS DESCRIPTION COMPLIANCE
    § 11.50 Signature manifestations
    § 11.50 (a)Signed electronic records shall contain information associated with the signing that clearly indicates all of the following:

    (1) The printed name of the signer;
    (2) The date and time when the signature was executed; and
    (3) The meaning (such as review, approval, responsibility, or authorship) associated with the signature.
    The SoftComply Change History table includes all the required information:
    (1) The full name of the approver, as defined in the Atlassian account;
    (2) Each action is associated with the timestamp generated by the Comala workflow history;
    (3) The table includes the name of the Workflow State, the Approval name and the name of the Action.
    § 11.50 (b)The items identified in paragraphs (a)(1), (a)(2), and (a)(3) of this section shall be subject to the same controls as for electronic records and shall be included as part of any human readable form of the electronic record (such as electronic display or printout).The information used by the SoftComply Change History table comes from the Comala Document Management audit trail (workflow history), which is embedded in the Confluence page.The table appears in the PDF export from Confluence.
    § 11.70 Signature/record linking
    § 11.70Electronic signatures and handwritten signatures executed to electronic records shall be linked to their respective electronic records to ensure that the signatures cannot be excised, copied, or otherwise transferred to falsify an electronic record by ordinary means.The information used by the SoftComply Change History table comes from the Comala Document Management audit trail (workflow history), which is embedded in the Confluence page.Any additional data generated by the app is embedded into the Confluence page.When a page is copied using the Confluence copy feature, the data related to the electronic signatures remains with the original document. Exception is when the document is Published using the Comala Publishing function. In this case, the information is passed to the published document too.

    WHAT IS CHANGE HISTORY?

    The goal of keeping a change history is to highlight the main differences between the previous version(s) of the same document. It is also important to have the information about the date from which this instruction/procedure is valid or effective and who has signed it off and when. Change History summarises the evolution of a document throughout its lifetime (and even beyond as you will also mark the obsoletion in the Change History table).

    Until today, you had to fill in the Change History table manually on your documents in Confluence. Typing in the notes and the version numbers is relatively easy, but displaying your electronic signatures on the Confluence pages had not yet been automated. Now you can use the SoftComply Change History app to automatically display your document approval history on your Confluence pages.

    HOW DOES THE SOFTCOMPLY CHANGE HISTORY APP WORK?

    Install the Change History app

    First, install the SoftComply Change History app from Atlassian Marketplace.

    Configure the Change History app

    Next, configure the SoftComply Change History app to display the information from the Comala Document Management workflows that you wish to see in the Change History table on your Confluence page. Follow the user guide to get the most out of the configuration options.

    Add the Change History Macro to your Confluence Page

    Once the configuration is done, simply add the Change History table macro to a Confluence page (type in “/” followed by “SoftComply Change History”) and select the respective macro from a list. You will now have your document version and approval history from the Comala Document Management displayed on the Confluence page!

    WANT TO LEARN MORE?

    To learn more about the SoftComply Change History app, try it out for free for a month, schedule a demo call with us & check out the user guide of the app.

    Table of Contents

    Ready to get started?

    Contact us to book a demo and learn how SoftComply can cover all your needs

    13485 implementation guide
    Picture of Marion Lepmets

    Marion Lepmets

    CEO
    December 18, 2024

    The Internet is full of articles about the implementation of ISO 13485. They talk about “Getting management support”, “Obtain The Documents And Study The Requirements”, “Develop An Implementation Plan”, “Evolution of a Quality Management System”, and other seemingly complex topics. Although comprehensive, most of these articles are self-serving, aimed at...

    SaMD Guide to Compliance
    Picture of Matteo Gubellini

    Matteo Gubellini

    Regulatory Affairs Manager
    December 3, 2024

    Introduction The first contact with the Medical Device regulatory world is a shock for most startups. These companies usually have excellent technical and clinical ideas on how to improve the patient’s life, but little knowledge of the legal burdens required to bring the medical device to the market. The technical...

    e-signature
    Picture of Matteo Gubellini

    Matteo Gubellini

    Regulatory Affairs Manager
    November 26, 2024

    What is an “Electronic Signature”? Electronic signature means a computer data compilation of any symbol or series of symbols executed, adopted, or authorized by an individual to be the legally binding equivalent of the individual’s handwritten signature. (21 CFR 11.3) In other words, to Electronically Sign a document means to...