This site has moved to the integrated Appfire documentation and information site for our apps.

From February 2024 this site is no longer updated.

Take a look here! If you have any questions please email support@appfire.com

Getting started with Comala Document Control

Overview

Workflows help you manage the review and approvals process for a document. 

 

The Basic Approval Workflow above consists of three states - Review, Rejected and Approved - and one or more transitions from a state to one or more of the other states.

The workflow manages the document approval process with content moving from one state to another.

In our example

  • the Review state is a state for draft content and allows one or more users to approve or reject the page or bog post content

  • the Approved state is our final content that has been approved and if this content is updated the workflow moves back to the Review state

Each Comala Document Control workflow has different workflow states and approval process but all these workflows allow you to

  • ensure that page content is reviewed and signed-off

  • assign specific users as reviewers for the content review in a workflow state

Only one workflow can be active on an individual page or blog post at any one time.

Workflows in Comala Document Control

Comala Document Control for Cloud has the choice of at least three bundled workflows available on installing the app.  Each of these workflows has different states, transition routes between states and content review activities.

Each installed workflow builds on the basic approval workflow - adding more states and transitions, setting an expiry period for approved content and automatically assigning content reviewers to provide greater control of your document development and management.

Adding a workflow to content

You can add a workflow to your content in two ways

A user must have admin permission in a space to apply a workflow to all content in the space.

Applying a workflow to all space content using the Comala Document Control dashboard allows greater central management of your content and is the recommended use of a Comala Document Control workflow in a production environment.

Space workflows

A space admin can configure a space to add and apply a workflow to all content in the space using the space settings Comala Document Control dashboard.

The space admin simply enables the current workflow. Once enabled it will be added and applied to all existing content in the space. The workflow will also automatically be added to any new documents created in the space.

Comala Document Control only allows one space workflow to be applied to content in the space at any one time. This maintains the requirement that only one workflow can be active on a document at any one time.

Workflow added and applied to a page

Once a workflow is added and applied to content

  • automatically defines content as approved or draft depending on the state

Content with an added workflow will have a breadcrumb for the current workflow state added to the content page sub-title.

If the content has previously been approved an added View approved byline link to the last approved version.

Choose the View approved to view the last approved version.

When viewing this last approved version of the content

  • the byline  Approved (Compare versions) is displayed confirming this is an approved version

  • and a link View pending approval to the current draft content version.

A user's key interaction with the workflow added to content is through the workflow popup accessed this breadcrumb.

Workflow states can be hidden from the progress tracker path.

In the example, the Rejected state is hidden. The hidden state will be displayed in the workflow popup if it is a destination for a content review decision.

The hidden state will also be displayed in the popup progress tracker path when the workflow content is in that state.

For the Quality Management Systems workflow, the In Approval state content review has assigned reviewers and the requirement for reviewer credentials using an e-signature.

The workflow popup will have the available options for moving the workflow from the current state to one or more destination states.

The popup progress tracker bar can be used to view the states in the workflow and will display the next state available.

The movement between these states is called a transition - these transitions occur based a user approving content, rejecting content or updating content.