Versions Compared

Key

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

Overview

A workflow codifies a business or compliance process into...

Table of Contents
minLevel3
maxLevel3
outlinefalse
typelist
printablefalse
Image Removed
Child pages (Children Display)
pageCreating Workflows

States and Transitions

Excerpt
nameworkflow_statestransitions
Image Modified

These define the milestones (states) and routes between them (transitions) of your process. Transitions can take place based on content change, a content review, or a trigger action.

Image Added
Child pages (Children Display)
pageCreating Workflows

Content reviews

Excerpt
nameworkflow_contentreviews

Content reviews (known as approvals) are key events in the content production lifecycle, where reviewers check the content and decide whether to approve or reject the content. Based on this decision the workflow moves the content to a new workflow state - a content review transition. For each review, you can assign one or more users as reviewers.

Events → TriggersActions

Excerpt
nameworkflow_triggers

As users interact with content and the workflow, events are sent, such as a state change, an approved review decision, or a task assigned.

One or more workflow triggers can be set to listen for an event such as a state change to a specific state.

When the event occurs, the trigger can set one or more actions. These include sending a custom email, setting a message, or changing the state.

Info

You can use these triggers to augment the content production process and automate workflow transitions.

Workflow Parameters

Excerpt
nameworkflow_parameters

Workflow parameters can be used as placeholders for the values of users who are reviewers for approvals; duration periods for the expiry of your content or labels to be added to your documents.

Using workflow parameters in your workflow allows you to create a workflow that can be used for different teams or projects but with these values set elsewhere.

One or more workflow parameters can easily be added to a workflow using workflow builder visual editor.

A workflow parameter can be set to use one of the following data types

  • character string

  • Confluence username(s)

  • Confluence groupname(s)

  • duration

  • a list of set values

The parameter value can be accessed in the workflow by their name wrapped in @ (at) symbol and used in a range of macros including the approval macro, the state-selection macro and trigger macros.

Workflow Template

A Comala workflow is stored as a JSON template. The available workflows in a space are listed in the space document management dashboard.

cdcm_spacedocumentmanagment_bun dledworkflows_narrow.pngImage Added

Three workflows are included on installing Comala Document Management. These are appended with a

Status
titleTEMPLATE
lozenge in the dashboard.

The included workflows cannot be overwritten but can be copied in the space document management dashboard and edited to create a custom workflow.

You can also create a new custom workflow using the visual builder or import a workflow template as JSON code using the code editor.

Custom workflows are added to the space document management dashboard.

cdmc_documentmanagemrntdashboard_3customworkflows_extract.pngImage Added

The workflows in the space document dashboard are displayed in the workflow picker when choosing the Add Workflow breadcrumb on a page and applying a workflow to an individual page or blog posts as a page workflow.

Excerpt
nameworkflow_template

A Comala Document Management workflow can easily be edited or created and edited using the workflow builder visual editor.

cdmc_wfbuilder_cew.pngImage Removedcdmc_wfbuilder_copycontentexpiryworkflow.pngImage Added
Info

The visual editor can also be used to inspect an exist workflow.

The Each workflow is scripted using JSON code and is stored in a template. This The workflow template can be edited in the code editor.

cdmc_wf_codeeditor_inbuilder_baw.pngImage Removedcdmc_codebuilder_copybasicapproval.pngImage Added
Info

Changes in one editor are automatically updated in the other.

A workflow template can be added and applied to an individual page, or more usually in production mode, a workflow is added and applied to all content across a space by the space administrator.