This documentation relates to the 5.2 release of Comala Workflows

 Documentation for other versions of Comala Workflows is available too.

Screen Location: Confluence Administration → Workflows section → Configuration

Overview

This screen is used to set Global configuration options.

Configuration

Note: Some of these settings can be overridden at Space Level, on a space-by-space basis – see: Configuration - Space Tools

Setting

Options

Notes

Ver

Workflow Activity and Drafts Visibility

Who can see workflow activity and unpublished drafts?

See also:

Space Administrators and Page Editors

Recommended for most use cases.

Unpublished drafts and activity reports will not be visible to users who would otherwise normally be able to view the content.

3.3+
Anybody

Anyone who could normally view the content will be able to view drafts and activity reports. They will also be able to take part in Content reviews (v4.6+).

Default Tasks Mode

Who can complete tasks?

See also:

StrictOnly the task assignee or task creator.3.1+
Lenient

Recommended for most use cases.

Any user who can edit the page/blog.

State's Task Behaviour

What happens to incomplete tasks from the current state if the workflow transitions to a new state?

See also:

If the page state changes, open tasks will be closed

Incomplete tasks will be closed.


If the page state changes, open tasks will be moved to new state

Recommended for most use cases.

Incomplete tasks will be copied to the new workflow state.

Default Approval Workflow

??

List of workflows?

Approval Comment

Mandate reviewer comment when Approving or Rejecting content?

See also:

Optional

Recommended for most use cases.

Comment is optional.

4.9+
RequiredA comment must be added during content reviews.

Page Update Reset Approval

If an approval (content review) is in progress, what effect does editing the content have?

See also:

ResetAny existing Approve/Reject decisions will be reset.4.7+
IgnoreExisting Approve/Reject decisions will be retained.

Published View Macro Transform

Which version of content should the {include} and {excerpt-include} macros show?

See also:

Enabled

Recommended in most use cases.

Use published version if available, otherwise use latest version regardless of workflow state.

4.4.2+
DisabledShow latest version, regardless of workflow state.

Send Usage Statistics

CheckboxWhen enabled, anonymous usage statistics will be sent to Comalatech to help improve the product.4.3.4+

Security

SettingOptionsNotesVer

Space Workflows

Which spaces can use Space Mode?

List of spacekey

A list of comma-separated space keys

Leave empty for no spaces, or specify ANY to indicate all spaces


Page Workflows

Which spaces can use Page Mode?

List of spacekey

A list of comma-separated space keys

Leave empty for no spaces, or specify ANY to indicate all spaces


Workflow Importer Group

Space admins in the specified group are allowed to import workflows.

See also:

User group

Set as confluence-users to allow all space admins to import workflows.

Note: After a workflow is imported, it can be used just like any other workflow; the restriction only applies to the action of importing, not subsequent use.

(warning) Make sure you enter a valid user group name.


Email Any Address

Which email addresses can be used in the {send-email} macro?

See also:

Disabled

Recommended in most use cases.

Only email addresses associated with a registered user account



EnableAny email address can be used

Loop Watchdog

These settings are used to detect infinite loops and terminate any offending workflows. It's recommended to leave the default values.

Likely causes of infinite loops include:

SettingOptionsNotes

Maximum Events

If this amount of events is exceeded on a single page by a single user, the threshold timer will start (see below).

NumberDefault: 20

Time Threshold (seconds)

If Maximum Events is exceeded for this amount of time, it will be treated as an infinite loop and the process will be terminatd.

NumberDefault: 20