View and edit workflow definition settings

The workflow definition settings are additional parameters that help you manage the workflow behavior and accessibility inside Collibra Data Intelligence Cloud.

(missing or bad snippet)

You must have the Sysadmin global role or a global role that has at least the Workflow Administration global permission to access this page:

1. In the main menu, click , then Settings.
   The Collibra settings page opens.
2. Click Workflows.
   The Workflows settings page appears on the Definitions tab page.
3. Select a workflow to view the definition settings.

1 Description

The description is a brief overview of the workflow. You can edit the description by:

• Changing the diagram process properties.
• Editing the workflow XML directly in Collibra Data Intelligence Cloud

2 Applies To

This section defines the scope of the workflow. This includes the type of resource the workflow applies to, optional restriction rules and where you can start the workflow from.

Click Edit to change the scope to any of the following:

• Asset
• Community
• Domain
• Global

Note  When you change the scope, the rules are removed. If you are changing from or to the Global scope, the roles are also removed.

A global workflow is not restricted to any particular resource and can be added to dashboards.

When you defined the resource that the workflow applies to, you can add restriction rules to finetune the scope of the workflow.

3 Variables

These are configuration variables, a list of process variables that you can edit here.

Click Edit to edit the variables.

Note You can only edit configuration variables that have the Writable property set to true (default).

Note If you redeploy a workflow, the configured variables remain the same. If you delete a workflow and then deploy it again, the variables revert to the default values.

4 Start Label

The start label is the name of the workflow when it is visible as a button on a resource page or in the drop-down list when you add it as a button on a dashboard. Click Edit to edit the label.

5 Start Event

A start event is an event that triggers the workflow, for example starting the workflow when an asset is created. Click Edit to edit the start event list.

Combine the Start Event with Applies To settings to refine when the workflow is triggered.

Setting	Description
Asset Added	The workflow starts when a new asset is created.
Asset Removed	The workflow starts when an asset is deleted.
Asset Status Changed	The workflow starts when the status of an asset is changed.
Asset Domain Changed	The workflow starts when an asset is moved to another domain.
Asset Type Changed	The workflow starts when the type of an asset is changed.
Asset Attribute Changed	The workflow starts when an attribute of an assets is changed.
Asset Name Changed	The workflow starts when the full name of an asset is changed. This is the fully qualified name that must be unique within a domain. To learn more, see Identical asset names per domain.
Asset Display Name Changed	The workflow starts when the name of an asset is changed. This is the regular name that is used by default in most places in the user interface.
Asset Attribute Added	The workflow starts when an attribute is added to an asset.
Asset Attribute Removed	The workflow starts when an attribute is removed from an asset.
Domain Added	The workflow starts when a domain is added to a community.
Domain Removed	The workflow starts when a domain is removed from a community.
Role Granted	The workflow starts when a user or a user group is assigned a resource or a global role.
Role Revoked	The workflow starts when a user or a user group is removed from a resource or a global role.
Workflow Started	The workflow starts when a workflow is manually started. Note Manually starting a workflow configured with this option also triggers the workflow.
Workflow Canceled	The workflow starts when a workflow is manually canceled. Note Manually canceling a workflow configured with this option also triggers the workflow.
Workflow Escalation	The workflow starts when a workflow user task is escalated. Note The packaged Escalation Process workflow is configured to start with this option.
Workflow task completed	The workflow starts when a workflow user task is completed.
User Added	The workflow starts when a new user account is created.
User Removed	The workflow starts when a user account is removed.
User Disabled	The workflow starts when a user account is disabled.
Commend Added	The workflow starts when a new comment is added to a resource.
Comment Removed	The workflow starts when a comment is removed from a resource.
Comment Changed	The workflow starts when a comment is edited.
Relation was added on an asset as head	The workflow starts when an asset becomes the head of a relation.
Relation was removed from an asset as head	The workflow starts when an asset is no longer the head of a relation.
Relation was added on an asset as tail	The workflow starts when an asset becomes the tail of a relation.
Relation was removed from an asset as tail	The workflow starts when an asset is no longer the tail of a relation.
Asset Tag Event	The workflow starts when a tag is either added to or removed from an asset.
Data Classification Accepted	The workflow starts when a result of the data classification process is accepted.
Data Classification Rejected	The workflow starts when a result of the data classification process is rejected.
Data Classification Added	The workflow starts when a new data class is added to a column asset.
Data Classification Removed	The workflow starts when a data class is removed from a column asset, for example when the data class entry is deleted.
Data Classification Updated	The workflow starts when a data classification changes, for example when the confidence of a suggested match changes value.
Database Registration Completed	The workflow starts when a database is successfully registered.
Database Registration Failed	The workflow starts when the registration process of a database fails.

Note If you select multiple start events, they use the logical OR function.

6 Roles

The roles define the permissions to manage the workflow. For example, if a certain tasks must be urgently executed but the responsible person is on sick leave, a user with the defined role can reassign that task to somebody else.

You can enter roles for starting and stopping workflows or reassigning workflow user tasks. The roles you can enter depend on the Applies To settings:

• If the scope is Global, you can only specify global roles in these fields.
• In all other cases, only resource roles are allowed.

Note  When specifying resource roles, only users that have the role for the specific resource can start and stop the workflow or reassign tasks.

Click to edit the roles:

• Start Workflow: The button with the start label is available to users with these roles.
• Stop Workflow: The option to cancel the workflow is available to users with these roles.
• Reassign Tasks: The option to reassign the task is available to users with these roles.

Note The roles are removed when you are changing from or to the Global workflow scope.

7 Other

The section contains additional settings that determine who can start the workflow, how the workflow behaves in relation to the resource it applies to and if the workflow can be started from the global Create button.

Setting	Description
Any guest user can start the workflow.	Indicates if guest users can start the workflow. If selected, users who are not signed in can start the workflow. When guest users start a workflow, some basic information, such as first name, last name and email address, is requested of them. That information can then be used to contact the user again, if needed. Note This check box overrides any roles that are specified in the Roles section. If you select this check box, you cannot select the Any signed in user can start the workflow check box.
Any signed in user can start the workflow.	Indicates that any user who is signed in can start the workflow. Note This check box overrides any roles that are specified in the Roles section. If you select this check box, you cannot select the Any guest user can start the workflow check box.
Perform candidate user check on workflow start.	Checks if all workflow user tasks have a candidate user expression that can be resolved to at least one Collibra Data Intelligence Cloud user. If the check fails, you see an error message when the workflow starts.
This workflow can only run once at the same time on a specific resource.	Determines if you can start a workflow multiple times, simultaneously for the same resource. If selected the workflow can only be started once for a given resource. If any user tries to start the same workflow for the same resource, an error message is displayed. However, users can still start the same workflow for a different resource or another workflow for the same resource
	If Lock resource is also selected, no other workflow can start on the same resource while this workflow is running neither can this workflow start if any other workflow is running on the same resource.
Show in global create.	Only valid for workflows where the scope is set to Global, allows users to start the workflow from the global Create button.