SOP Training & Attestation for Confluence
Documentation
Publish a revision of a procedure page, add an optional quiz, and keep a record of who read, passed and attested each revision.
Install
A site administrator installs it into your Confluence Cloud site from the app's listing on the Atlassian Marketplace.
Add training to a procedure page
- Edit the procedure page.
- Type
/SOPand choose SOP Training & Attestation. - Publish the page. The macro shows that no revision has been published yet, and a Manage training button.
Publish a revision
Only people who can edit the page can publish a revision; the app checks this with Confluence when you click Manage training.
- Due in (days). When people should have attested by. Use 0 for no due date.
- Audience. Type at least two letters of a Confluence group name and choose one or more groups (up to 20). With an audience, reports show who is pending and who is overdue. Without one, reports list only the people who attested.
- Quiz (optional). Up to 10 multiple-choice questions with 2 to 6 options each. Write one option per line and start the correct one with
*. Set a pass mark (0–100%) and the number of attempts (0 means unlimited).
Publishing records the page's current version number and a SHA-256 fingerprint of its content. Every new revision needs a new attestation, even from people who attested an earlier one.
What readers do
- Read the procedure.
- If the revision has a quiz, answer it and submit. The app shows the score; it never sends the correct answers to the browser and does not reveal which answers were wrong.
- After passing (or right away, if there is no quiz), click I have read and understood revision N.
The record keeps who attested, when, which revision, the page version and content fingerprint at that moment, and the quiz score.
Reports and CSV export
Open Apps → SOP Training Reports in Confluence. The list shows the procedures with a published revision that you can view. Opening a report requires permission to edit that page.
- Group membership is loaded in the background the first time a report is opened and refreshed at most once a day. Small groups take a few minutes; large groups are loaded in parts, about 400 people per hour, and until a refresh finishes the report keeps using the last saved membership. The report shows the date of the membership it used.
- CSV export takes two clicks: Prepare CSV export, then Download. Columns: Account ID, Name, Status, Attested at (UTC), Quiz score, Revision, Page version attested and Content fingerprint (SHA-256). A cell that starts with
=,+,-or@is prefixed with an apostrophe so spreadsheets treat it as text.
What the records are, and what they are not
The records show what happened in Confluence: which Atlassian account attested which revision, when, and against which version of the page. They are not electronic signatures, and the app has not been validated for any specific regulation. If your quality system requires validation, it is done by your organization.
Platform limits
The app runs on Atlassian Forge and is subject to the Forge platform quotas and limits and to Confluence API rate limits. Confluence counts the app's API use across all of its customers in one hourly quota, so the app also limits its own use per site and per hour. Group membership refreshes use only part of that limit, so that the rest stays available for opening reports and publishing revisions. When the limit is reached, a group refresh continues in the next hour, a report or CSV export may contain account IDs without names, and other actions that need Confluence wait until the next hour; the app says so on screen.
Licensing
Billing is handled by Atlassian through the Marketplace. If a site's license is not active, existing records stay visible and can still be exported, but new quiz attempts, attestations and revisions are paused until the license is renewed. The free trial works with every feature.
Data and privacy
- Records are kept in Atlassian's Forge hosted storage, in the same location as your Confluence site's data. The app contacts no service outside Atlassian.
- Stored: Atlassian account IDs, dates, quiz attempts and scores, page IDs, revision and version numbers, content fingerprints, the questions and answers of each quiz, and a cache of the members of audience groups. Not stored: names, email addresses or page content. Names are looked up when a report is shown or exported.
- When an Atlassian account is closed, Atlassian tells the app in its weekly report, and the app erases that person's records.
- When the app is uninstalled, Atlassian keeps its data for 28 days and then deletes it. If you reinstall within 21 days, we can ask Atlassian to re-link the previous data at your request. Export your reports before uninstalling if you need them.
- If your organization needs one person's records erased while their account is still active, an administrator can write to support@nordikaapps.com. We confirm the request with the license contact that Atlassian gives us, and erase the records within 30 days.
Details are in the privacy policy and in our data processing agreement with customers.
Support
Write to support@nordikaapps.com. Include your Confluence site URL and, if you can, the page where the problem happens. Support is by email only, and we answer in writing.
Response times. Requests that Atlassian identifies as critical: within 24 hours. Every other request: within five business days.