Administration - Global Configuration

Comala Document Approval global configuration options are found under the Confluence global administration console.

From Comala Document Approval v1.11, a global administrator can choose the Document Activity Upgrade option to run pre-upgrade data checks for spaces to use document activity for workflow events and activity in Comala Document Approval 2 (Data Center Only).

Configuration Screen

Choose one of the Edit buttons on the screen to display the configuration options.

cdadc_globalconfiguration_new_impersonationuser.png

Setting

Options

Notes

Setting

Options

Notes

Configuration

For the visibility of approval activity and draft and final content

Approval Activity and Drafts Visibility

Who can see approval activity and unpublished drafts?

Space Administrators and Page Editors

Recommended for most use cases.

Unapproved drafts and activity reports will not be visible to users who would otherwise normally be able to view the content only. (Not edit)

Anybody

Anyone who could normally view the content will be able to view drafts and activity reports.

Page Update Reset Approval

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

Reset

Any existing Approve/Reject decisions will be reset.

Ignore

Existing Approve/Reject decisions will be retained.

Published View Macro Transform

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

Enabled

Recommended in most use cases.

Use the approved version if available, otherwise use the latest version.

Disabled

Show the latest version content, regardless of the approved state version.

Document Dashboard Actions Component

Should the Document Actions Report be displayed for the current user on the Confluence dashboard?

Enabled

This shows for the current user, the document actions report for pending assigned approvals on the Confluence dashboard.

Disabled

Document actions report is not displayed on the Confluence dashboard.

User Onboarding

Provides a user tour and tips for new users

Enabled/Disabled

Default Enabled provides a tour and tips for new users.

Usage Statistics

Enable Usage Statistics

Checkbox

When enabled, anonymous usage statistics will be sent to Comalatech to help improve the product.

User Onboarding

Enable onboarding

Checkbox

When enabled introductory information and tips will be shown to new users: User Onboarding.

Security

Setting the spaces where page approvals can be added and applied

Space Approvals

Which spaces can have space wide approvals enabled.

List of spacekeys

Check buttons

  • Allowed

  • Restricted

A list of comma-separated space keys.

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

If

  • Allowed - when checked, space scope workflows can be added to content in the spaces listed

  • Restricted - when checked, space-scope workflows cannot be added to content in the spaces listed

Page Approvals

Which spaces can use page-level approvals

List of spacekeys

Check buttons

  • Allowed

  • Restricted

A list of comma-separated space keys.

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

If

  • Allowed - when checked, page-level workflows can be added to content in the spaces listed

  • Restricted - when checked, page-level workflows cannot be added to content in the spaces listed

Impersonation group for Refresh Data

This user group is used to impersonate a Confluence admin when running the refresh data process in a space. It lets a space administrator successfully refresh the workflow data for a space, including pages with page-level edit restrictions.

Edit the settings to add a Confluence user group with global administrator permissions.

Admin user group

Select a Confluence administrators group to impersonate when space admins run the data refresh process

Default: Not set

Accepted value: Confluence user group

  • requires a group with Confluence global administrator permission

When set, a user from the user group is used to impersonate a Confluence admin when running the refresh data process in a space.

This ensures the process has access to restricted pages in the space.

Notifications Screen

Setting

Options

Notes

Setting

Options

Notes

Workflow Notifications

Notifications for given workflow events

Approval - Assignee

Checkbox

Send notification emails to approval assignees when they are assigned an approval on a page.

Read Confirmation

Checkbox

Send notification to read confirmation assignee(s) for all read confirmation events for a read confirmation added to a page

Upgrade Activity

Comala Document Approval 2 is data center only and uses a new, improved capability called Document Activity instead of the Page Activity.

  • existing spaces with applied workflow (or workflow activity) will need their workflow data upgraded to use the capabilities of document activity

  • new spaces created after installation of Comala Document Approval 2.0+ (and existing spaces without workflow activity) will automatically use document activity when a workflow is applied

Global administrators can undertake an upgrade check process using the Document Activity Upgrade screen options.

In the Document Activity Upgrade screen, choose one or more spaces to run upgrade checks prior to an upgrade to Comala Document Approval 2 (Data Center Only).

This upgrade check identifies any errors in the existing data prior to the upgrade and provides an estimate of the time for the upgrade on a space-by-space basis.

In Comala Document Approval 2.0, the console is used to run the upgrade and pre-upgrade checks together.

Upgrading the data requires Comala Document Approval 2.0+ to be installed and Read Only Mode to be enabled in your data center instance.