Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Wiki Markup
{repository-workflow:dm.workflow|name=Quality Management System workflow|categories=sample,docmanagement|chart=qms-workflowqmsworkflow.jpegpng|version=52000}
{repository-description:name=Quality Management System workflow}
{note}This workflow performs publishing to a different space, which requires our [Comala Publishing App|https://marketplace.atlassian.com/plugins/com.comalatech.remotepublishing].{note}

* This workflow implements a QMS workflow for document management.
* The workflow works in pages with the "qms_approval" label. The label cannot be removed (stickylabel).
* Remember to create a group "controlled_documents_approvers" and ensure that the the source space is linked to a publishing space
{repository-description}
{workflow-body}
{workflow:name=Quality Management System|label=qms_approval|stickylabels=qms_approval}
    {description}
        Basic quality management workflow that includes states for both publishing and page obsolescence, and restricts the approval process to a specific Confluence group. Publishes approved pages to a separate space (Comala Publishing App required)
    {description}
    {state:Draft|approved=In Approval|rejected=Obsolete}
        {approval:In Approval or Obsolete|credentials=2|assignable=true|group=controlled_documents_approvers|rejectlabel=Make Obsolete}
    {state}
    {state:In Approval|approved=Published|rejected=Draft|updated=Draft|taskable=true|colour=#6554c0}
        {approval:Approval|credentials=2|assignable=true|group=controlled_documents_approvers}
    {state}
    {state:Obsolete|updated=Draft|taskable=true|hidefrompath=true|colour=#ff5630}
    {state}
    {state:Published|final=true|approved=In Approval|rejected=Obsolete|updated=Draft}
        {approval:In Approval or Obsolete|credentials=2|assignable=true|group=controlled_documents_approvers|approvelabel=In Approval|rejectlabel=Make Obsolete}
    {state}
    {trigger:attachmentschanged}
        {set-state:Draft}
    {trigger}
    {trigger:statechanged|state=In Approval}
        {set-restrictions:type=Edit|group=confluence-users}
    {trigger}
    {trigger:statechanged|state=Draft}
        {remove-restriction:type=Edit|group=confluence-users}
        {remove-label:qms_obsolete}
        {set-message:style=error}{set-message}
    {trigger}
    {trigger:statechanged|state=Published}
        {publish-page}
    {trigger}
    {trigger:statechanged|state=Obsolete}
        {set-restrictions:type=Edit|group=confluence-users}
        {set-label:qms_obsolete}
        {set-message:style=error}This page is *obsolete*{set-message}
        {publish-page}
    {trigger}
{workflow}


{workflow-body}
{repository-workflow}

Draft state

...


In the updated QMS workflow, e-signature process (if enabled) has been amended to require a user email and a one-time password token generated using a third party 2-Factor Authorization app.


QMS Workflow StateOutline Description

Draft

  • only members of the group controlled_documents_approvers can approve, using user

...

  • email and a one-time password token (if enabled).
  • if more than one member assigned to the group, all they all must approve.
  • if approved, transitions to In Approval.

...

  • if rejected, transitions to Obsolete.

...

  • page can be edited.

In Approval

...

...

  • same approval, only members of the group

...

  • can approve, using user

...

  • email and a one-time password token (if enabled for the workflow).
  • if more than one user is assigned as members of that group, they all

...

  • have to approve.

...

  • page cannot be edited.

...

  • if approved, transitions to Published.

...

  • if rejected, transitions to Draft.

...

  • editions transition to Draft.

...

  • tasks can be added.
Published

...

...

  • the page is published to the target space using Comala Publishing.

...

  • restrictions still apply.

...

  • editions transition to Draft.

...

  • it could transition to In Approval or to Obsolete.
Obsolete

...

...

  • qms_obsolete label is added.

...

  • page cannot be edited.

...

  • page is published to the target space using Comala Publishing to transfer the new Obsolete state to the published space.

...

  • restrictions and labels are copied to the page in the target space. 

...

  • tasks can be added.

...

  • on-screen message is displayed "This page is obsolete". 

An alternative to

...

including an on-screen message also in the published page in the target space, is to use the macro include-segment.