Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Image Removed
Table of Contents
minLevel1
maxLevel6
outlinefalse
typeflat
separatorpipe
printablefalse
Image Added

Overview

ConceptTemplates

Before we can do anything, we need somewhere to build our workflow – a workflow template. That's the dashed box in the diagram above – it will contain our simple content production process.

All workflows are stored in workflow templates, and a workflow template can only contain one workflow. Because of this, we generally refer to a "workflow template" as just a "workflow".

Table of Contents

Create a page

Go to your personal space (or some other space where you can create content), and Create a blank page.

It doesn't matter what you call the page, or what's in it. It's just somewhere for us to build our workflow.

Space vs. Page mode

Before we continue, you need to know about the two modes the Comala Document Management app provides at the space level.

One of them is called Page Mode

, and it

  • page mode allows every page in the space to have it's own unique workflow

. It
  • it's great for developing workflows, but it makes managing workflows harder because every page has a separate copy of the workflow

.

The other mode is called Space Mode

, and it

  • space mode allows you to apply centrally managed workflows to the entire space – all pages and blog posts – although you can filter the workflow application by content label or content type (page or blog post) if required

.

If you want to see a side-by-side comparison, see: Page vs. Space Mode

For now, we'll use Page Mode, as it's a bit easier to get started that way.

Add workflow

In Page Mode, the process of creating a workflow is to simply add one to a page. Here's how...

From the Page Tools Menu, choose Add Workflow...

Image Removed
Image Added

Note: If you don't see that option, make sure that the space is running in page mode and that there are no active space workflows.

You'll now see the Add Workflow dialog, like this

:Image Removed

.

Image Added
Info

This is the workflow picker dialog box.

You'll see a scrollable list of existing workflows that you can

apply –

apply - if you were to choose one of those (don't, as we're going to do something else) it would make a completely new copy of that workflow on your page. If the original workflow was changed, it wouldn't affect the copy of it on your page.

Custom states workflow

There's a special workflow in that list called Workflow with custom states.

Scroll

  • if required scroll right to the bottom of the list and choose

it:
  • this workflow

Tip

This is where most workflows are born.

When you choose the Workflow with custom states, a text box appears with some default states.

Let's use these default states for the moment, we can change them later.

  • choose the Apply & Customize button

.

This opens the workflow builder visual

workflow

editor

, workflow builder

.

Image Removed
Image Added

The custom states workflow is displayed

  • as a flow chart in the right-hand panel

.
  • graphically on the left-hand panel

.
Info

How does this workflow appear and work on our content?

  • choose Exit to view the content with the workflow applied

.

Workflow added to the content

The content will have two breadcrumbs added to the page

Workflow icon

Image Removed

Comala Document Management icon.

  • link to visual diagram and name of current workflow
Image Added

The workflow icon is a link to a simple workflow inspector.

Image Added

Workflow state breadcrumb

Image Removed
Image Added

Workflow

The state

name

breadcrumb and

state

status indicator circle

.
  • Link to workflow popup.
The state breadcrumb

is a link to open the workflow popup

:

.

Image Removed

The workflow icon is a link to a simple workflow inspector:

Image Removed

Image Added

Test it

Head over to the User Guide and familiarise yourself with the following:

Status Bar Popup Popup

After you've done that, we'll continue with the second lesson

: