Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
hiddentrue

Learn how you can configure Workflow Rules -

Status
colourRed
titleAvailable from CRM.COM R9.0.0

Status
colourRed
titleAvailable from CRM.COM R9.0.0

What does this section cover? 

Table of Contents
minLevel2

What are Workflow Rules ?

 Workflow Rules are used in order to apply actions on specific entities, triggered by specific events, considering that the specified conditions are fulfilled. Each configured Workflow Rules refers to a specific Entity. The supported entities are the following:

  • Activities
  • Jobs
  • Service Requests
  • Subscriptions

Creating, Editing & Deleting Validations & Restrictions

ActionValidationsRestrictionsAdditional Information
General You can have multiple Effective and Not Effective definitionsBoth effective and not effective Workflow Rules can be selected, but only Effective definitions are applicable
Create
  • Mandatory information is provided
  
Edit
  • Mandatory information is provided
  
Delete

Definition can be deleted only if the Approval Definition is not used by any effective or not effective workflow rules

  
Setting Approval Definition to Not Effective  If the Approval definition is used in at least one effective workflow rule then
  • The system throws a warning that the Approval definition is used by specific workflows and confirmation is required for setting it to Not Effective

Workflow Rules  attributes attributes 

NAMEDESCRIPTION

Name

The Workflow Rule's Name. Each Workflow Rule name should be unique

Alternative Code

The Alternative Code of the Workflow Rule. The Alternative Code is mandatory so if none is define its value will default to the first letter of the Workflow Rule's name

Description

A Description of the Workflow Rule

Life Cycle State

The life cycle state of the Workflow Rule which can either be Effective or Not Effective. Only effective workflow rules are applicable

Entity

The Entity for which the Workflow Rule is applied. Each Workflow Rule must be related to one and only one Entity and this related is defined at the Entity Type.

Entity Types

The Type of the Entities for which the Workflow Rule will be triggered, evaluated and applied. The Entity of the Workflow Rule defines which Entity Types will be available for selection. Multiple Entity Types can be defined

Processing Order

Defines the ordering of the Workflow Rule's actions. The Workflow Rule's actions are categorized as Updates and various Actions, so the Processing order defines whether the entity which triggers the rule will at first be updated and then actions will be performed based on its updated information or the other way around. The available options are:

  • Updates first and then any other actions.
  • Any other actions and then updates

Priority

A priority of the rule in case that multiple rules are applied on each entity. The available values are Low, Medium, High.

Triggers

A list of events that will be triggering the workflow rule. Multiple triggers can be selected. The triggers should include the following:

  • On Create
  • On Update
  • Through Web API

Conditions

A set of Conditions that should be fulfilled in order to apply the Workflow Rule. Multiple Conditions can exist per Workflow Rule. The Workflow Rule's Conditions are met either when at least one of the Conditions is met or if all Conditions are met and this option is available when setting up the conditions. Conditions always refer to the information of the entity related to the Workflow Rule. Each Condition might include more than one fields of the related entity and at least one of them should be bet in order for the condition to be met. Each Condition also has a specific type that indicates how the entity's information will  be evaluated.

The Conditions include:

    • Who performs the update: One or more of the following options can be selected. If Specific User or Specific Unit is selected, then a specific User or Unit must also be defined.
    • A specific field changes: One or more of the following options can be selected. The Condition is met if at least one of the defined entity fields has been updated to any value either during the entity's creation or on update.
    • When a field contains a specific value: One or more of the following options can be selected. The Condition is met if at least one of the defined entity fields has a specific value at the time that the Condition is evaluated. The entity field is not necessarily updated before the rule was triggered. The Condition is evaluated as long as a specific value is defined per entity field.
    • When a field changes from a specific value to a specific value: One or more of the following options can be selected. The Condition is met if at least one of the entity fields had a specific value prior the entity's update and the field was updated to another specific value after the entity's update. At least one of the two specific values should be specified per Condition, i.e. either the initial or the new specific value


  Each Entity Type has different  Workflow Rule Conditions described in the tables below

Actions

A set of Actions that should be applied according to the Workflow Rule but only as long as the Conditions are met. Multiple Actions can exist per Workflow Rule and all of them will be applied if the Conditions are met. The Workflow Rule's Processing Order setting defines the order in which the Actions will be applied. The Workflow Rule Actions include the following:

  • Updates information of the entity for which the Workflow Rule is applied. The information that can be updated should be different based on the entity and should include the following
  • Schedule Activities: Creates an activity and relates it with the entity itself or with the master entity
  • Send Communication: Sends a communication to the customer related with the entity
  • Send Alerts: Sends alerts to the users. Existing or new alerts can be used
  • Trigger Webhooks: Triggers Webhooks. Existing or new webhooks can be used
  • Request Approvals: Sets the approval settings. Existing or new approvals can be used

  Each Entity Type has different  Workflow Rule Actions described in the tables below

Activity Workflow Rule Conditions and Actions

ConditionsActions
NameDescriptionNameDescription
Who performs the update

Defines a set of Users or Units which either created new or modify an existing Activity. More than one options can be selected. If more than one options are defined then at least one of them should be met.  The available Condition options are:

  • Assign to User
  • Assign to Unit
  • Created by User
  • Created by Unit
  • Specific User
  • Specific Unit
Update Information

Defines how specific Activity fields should be updated and the new value that should be assigned to them as the result of successfully applying a Workflow Rule. Multiple fields can be selected to be updated within the set of actions of the same Workflow Rule, but only as long as they are not conflicting. The available fields to be updated are the following:

    • Status
    • Category
    • Assign to User
    • Assign to Unit
    • Owned by Group
    • Privacy Level
    • Key Dates
      • Estimated Completion Time
    • User Defined Fields
Specific Field Change

Defines a set of Activity fields for which the Condition is met if their value changes (change to any value). More than one fields can be selected. If more than one fields are defined, then at least one of them must change in order for the Condition to be met. The available fields are: 

  • Status
  • Life Cycle State
  • Category
  • Assign to User
  • Assign to Unit
  • Owned by Group
  • Privacy Level
  • Start Date
  • Estimated Completion Time
  • Estimated Completion Date
Send Alerts

Sends alerts to the users. Existing or new alert definitions related with activities can be used

Note that both effective and not effective definitions can be selected

Specific Field Change to Value

Defines a specific value that specific field should have when the Condition is to be evaluated. Only one value per field is allowed to be defined. Multiple fields along with their values can be defined within the same set of Conditions. If more than one fields are defined, then at least one of them should be evaluated to true in order for the Condition to be met. The available fields are:

  • Type
     
  • Status
  • Life Cycle State
  • Category
  • Assign to User
  • Assign to Unit
  • Owned by Group
  • Privacy Level
Trigger Webhooks

Triggers Webhooks. Existing or new webhook definitions related with activities can be used

Note that both effective and not effective definitions can be selected

Specific Field Change From Value to another ValueDefines a specific value that a specific field should initially have and the value that the same field should have after the entity's update. Multiple fields along with their values can be defined within the same set of Conditions. If more than one fields are defined, then at least one of them should be evaluated to true in order for the Condition to be met. The available fields are:
  • Status
  • Life Cycle State
  • Category
  • Assign to User
  • Assign to Unit
  • Owned by Group
  • Privacy Level
Request Approvals

Sets the approval settings. Existing or new approval definitions related with activities can be used

Note that both effective and not effective definitions can be selected

Job Workflow Rule

Conditions

Condition and

Actions

Action  Attritbutes

ConditionsActions
NameDescriptionNameDescription
Who performs the update

Defines a set of Users or Units which either created a new or modified an existing Job. More than one options can be selected. If more than one options are defined then at least one of them should be met.  The available Condition options are:

  • Assign to User
  • Assign to Unit
  • Created by User
  • Created by Unit
  • Specific User
  • Specific Unit
Update Information

Defines how specific Service Request fields should be updated and the new value that should be assigned to them as the result of successfully applying a Workflow Rule. Multiple fields can be selected to be updated within the set of actions of the same Workflow Rule, but only as long as they are not conflicting. The available fields to be updated are the following:

    • Status
    • Category
    • Assign to User
    • Assign to Unit
    • Owned by Group
    • Privacy Level
    • Key Dates
      • Estimated Completion Time
    • User Defined Fields
Specific Field Change

Defines a set of Job fields for which the Condition is met if their value changes (change to any value). More than one fields can be selected. If more than one fields are defined, then at least one of them must change in order for the Condition to be met. The available fields are:  

  • Status
  • Life Cycle State
  • Category
  • Billing Term Scheme
  • Price Plan
  • Agreement Date
  • Job Address
  • Requested Physical Goods
  • Expenses
  • Assign to User
  • Assign to Unit
  • Owned by Group
  • Privacy Level
  • Start Date
  • Estimated Completion Time
  • Estimated Completion Date
Send Alerts

Sends alerts to the users. Existing or new alert definitions related with jobs can be used

Note that both effective and not effective definitions can be selected

Specific Field Change to Value

Defines a specific value that specific field should have when the Condition is to be evaluated. Only one value per field is allowed to be defined. Multiple fields along with their values can be defined within the same set of Conditions. If more than one fields are defined, then at least one of them should be evaluated to true in order for the Condition to be met. The available fields are:

  • Type
  • Status
  • Life Cycle State
  • Category
  • Billing Term Scheme
  • Price Plan
  • Assign to User
  • Assign to Unit
  • Owned by Group
  • Privacy Level
Trigger Webhooks

Triggers Webhooks. Existing or new webhook definitions related with jobs can be used

Note that both effective and not effective definitions can be selected

Specific Field Change From Value to another ValueDefines a specific value that a specific field should initially have and the value that the same field should have after the entity's update. Multiple fields along with their values can be defined within the same set of Conditions. If more than one fields are defined, then at least one of them should be evaluated to true in order for the Condition to be met. The available fields are:
    • Status
    • Life Cycle State
    • Category
    • Billing Term Scheme
    • Price Plan
    • Assign to User
    • Assign to Unit
    • Owned by Group
    • Privacy Level
Request Approvals

Sets the approval settings. Existing or new approval definitions related with jobs can be used

Note that both effective and not effective definitions can be selected

  Schedule Activities

Schedule Activities to be performed for the entity which triggers the Workflow Rule by setting up the Activity Types of the Activities that will be scheduled. Multiple Activity Types can be configured.

For the automatic activity scheduling you must also configure activity assignments in Creating Automatic Collaboration Rules (ACR) as the assignment will be automatically done.

 

Service Request Workflow Rule

Conditions

Condition and

Actions

Action Attributes

ConditionsActions
NameDescriptionNameDescription
Who performs the update

Defines a set of Users or Units which either created a new or modified an existing Service Request. More than one options can be selected. If more than one options are defined then at least one of them should be met.  The available Condition options are:

  • Assign to User
  • Assign to Unit
  • Created by User
  • Created by Unit
  • Responded by User
  • Specific User
  • Specific Unit
  • Temporarily Resolved By User
  • Finally Resolved By User
Update Information

Defines how specific Service Request fields should be updated and the new value that should be assigned to them as the result of successfully applying a Workflow Rule. Multiple fields can be selected to be updated within the set of actions of the same Workflow Rule, but only as long as they are not conflicting. The available fields to be updated are the following:

  • Status
  • Category
  • Impact Level
  • Urgency Level
  • Priority Level 
  • Response Category
  • Responded by User
  • Response Date
  • Temporarily Resolved By User
  • Temporary Resolution Date
  • Temporary Resolution Category
  • Finally Resolved By User
  • Final Resolution Date
  • Final Resolution Category
  • Assign to User
  • Assign to Unit
  • Owned by Group
  • Privacy Level
  • Key Dates
    • Estimated Completion Time
  • User Defined Fields
Specific Field Change

Defines a set of Service Request fields for which the Condition is met if their value changes (change to any value). More than one fields can be selected. If more than one fields are defined, then at least one of them must change in order for the Condition to be met. The available fields are:

    • Status
    • Life Cycle State
    • Category
    • Impact Level
    • Urgency Level
    • Priority Level
    • Assign to User
    • Assign to Unit
    • Responded by User
    • Response Category
    • Response Date
    • Owned by Group
    • Privacy Level
    • Start Date
    • Estimated Completion Time
    • Estimated Completion Date
    •  Outward Relations
    • Inward Relations
    • Temporarily Resolved By User
    • Temporary Resolution Date
    • Temporary Resolution Category
    • Finally Resolved By User
    • Final Resolution Date
    • Final Resolution Category
    • Accepted by contact

Send Alerts

Sends alerts to the users. Existing or new alert definitions related with service requests  can be used

Note that both effective and not effective definitions can be selected

Specific Field Change to Value

Defines a specific value that specific field should have when the Condition is to be evaluated. Only one value per field is allowed to be defined. Multiple fields along with their values can be defined within the same set of Conditions. If more than one fields are defined, then at least one of them should be evaluated to true in order for the Condition to be met. The available fields are:

    • Type
    • Status
    • Life Cycle State
    • Category
    • Impact Level
    • Urgency Level
    • Priority Level 
    • Response Category
    • Responded by User
    • Temporarily Resolved By User
    • Temporary Resolution Category 
    • Finally Resolved By User
    • Final Resolution Category
    • Assign to User
    • Assign to Unit
    • Owned by Group
    • Privacy Level
Trigger Webhooks

Triggers Webhooks. Existing or new webhook definitions related with Service Requests can be used

Note that both effective and not effective definitions can be selected

Specific Field Change From Value to another ValueDefines a specific value that a specific field should initially have and the value that the same field should have after the entity's update. Multiple fields along with their values can be defined within the same set of Conditions. If more than one fields are defined, then at least one of them should be evaluated to true in order for the Condition to be met. The available fields are:
    • Status
    • Life Cycle State
    • Category
    • Impact Level
    • Urgency Level
    • Priority Level 
    • Response Category
    • Responded by User 
    • Temporarily Resolved By User
    • Temporary Resolution Category 
    • Finally Resolved By User
    • Final Resolution Category
    • Assign to User
    • Assign to Unit
    • Owned by Group
    • Privacy Level
Request Approvals

Sets the approval settings. Existing or new approval definitions related with Service Requests can be used

Note that both effective and not effective definitions can be selected

  Schedule Activities

Schedule Activities to be performed for the entity which triggers the Workflow Rule by setting up the Activity Types of the Activities that will be scheduled. Multiple Activity Types can be configured.

For the automatic activity scheduling you must also configure activity assignments in Creating Automatic Collaboration Rules (ACR) as the assignment will be automatically done.

 

Subscriptions Workflow Rule

Conditions

Condition and

Actions

Action Attributes

ConditionsActions
NameDescriptionNameDescription
Who performs the update

Defines a set of Users or Units which either created a new or modified an existing Job. More than one options can be selected. If more than one options are defined then at least one of them should be met.  The available Condition options are:

  • Created by User
  • Created by Unit
  • Specific User
  • Specific Unit
Update Information

Defines how specific Service Request fields should be updated and the new value that should be assigned to them as the result of successfully applying a Workflow Rule. Multiple fields can be selected to be updated within the set of actions of the same Workflow Rule, but only as long as they are not conflicting. The available fields to be updated are the following:

  • Owned by Group
  • Privacy Level
  • User Defined Fields
Specific Field Change

Defines a set of Subscription fields for which the Condition is met if their value changes (change to any value). More than one fields can be selected. If more than one fields are defined, then at least one of them must change in order for the Condition to be met. The available fields are:  

  • Life Cycle State
  • Contact Information
  • Accounts Receivable
  • Subscription Address
  • Billing Terms
    • Price Plan
    • Agreement Date
    • Binding Period
    • Binding Period Start Date
    • Binding Period End Date
  • Owned by Group
  • Privacy Level
  •  New services
  • Services Activated
  • Services Deactivated
  • Services Cancelled
Send Alerts

Sends alerts to the users. Existing or new alert definitions related with subscriptions can be used

Note that both effective and not effective definitions can be selected

Specific Field Change to Value

Defines a specific value that specific field should have when the Condition is to be evaluated. Only one value per field is allowed to be defined. Multiple fields along with their values can be defined within the same set of Conditions. If more than one fields are defined, then at least one of them should be evaluated to true in order for the Condition to be met. The available fields are:  

  • Life Cycle State
  • Owned by Group
  • Privacy Level
Billing Terms
  • Price Plan
  • Billing Term Scheme
  • Binding Period
Trigger Webhooks

Triggers Webhooks. Existing or new webhook definitions related with subscriptions can be used

Note that both effective and not effective definitions can be selected

Specific Field Change From Value to another ValueDefines a specific value that a specific field should initially have and the value that the same field should have after the entity's update. Multiple fields along with their values can be defined within the same set of Conditions. If more than one fields are defined, then at least one of them should be evaluated to true in order for the Condition to be met. The available fields are:
  • Life Cycle State 
  • Owned by Group
  • Privacy Level
  • Billing Terms
    • Price Plan
    • Billing Term Scheme
    • Binding Period
Request Approvals

Sets the approval settings. Existing or new approval definitions related with subscriptions can be used

Note that both effective and not effective definitions can be selected

  Schedule ActivitiesSchedule Activities to be performed for the entity which triggers the Workflow Rule by setting up the Activity Types of the Activities that will be scheduled. Multiple Activity Types can be configured.

For the automatic activity scheduling you must also configure activity assignments in Creating Automatic Collaboration Rules (ACR) as the assignment will be automatically done.

 

Defining your own Workflow Rules  tailored to your company's needs

  1. Navigate to  FOUNDATION > WORKFLOWS > SET UP WORKFLOW RULES
  2. Either search for an existing one or from the Top Menu click on NEW
    WORKFLOW RULESImage Added
  3. MAIN INFORMATION

    1. Provide the main information as explained in the table above
  4. SETTINGS

    Provide the following information
    1. Entity: Select from the drop down list the entity for which the alert will be created
    2. Requested Number of ApprovalsProcessing Order: Type how many approvals are required
    3. Subject: Type the subject
  5. AUTHORISED USERS

    Select the users that are authorised to approve, reject or cancel approval requests
    1. Assigned to User : Check the box if you would like the assigned to user, to be  authorised to manage approval requests
      Not available if the selected Entity in Settings is Subscriptions 
    2. Users Belonging to Assigned to Unit: Check the box if you would like the users that belong in the Assigned to Unit, to be authorised to manage approval requests
      Not available if the selected Entity in Settings is Subscriptions 
    3. Specific Users: Click on Add and using the search modal select the users to be authorised to manage approval requests
    4. Users Belonging in Specific Units : Click on Add and using the search modal select the Units whose users are to be authorised to manage approval requests
    5. Users Assigned to Specific Security Profiles: Click on Add and using the search modal select the Security Profiles whose users are to be authorised to manage approval requests
  6. WORKFLOW RULES

    1. This is a read only list of the workflow rules that include the alert definition
  7. LOG INFORMATION

    Include Page
    Log Information - Global
    Log Information - Global

  8. From the Actions Menu click on SAVE

Deleting Workflow Rules

Include Page
Deleting a record - Global
Deleting a record - Global

Changing the Life Cycle State of Approval Definition

  1. Navigate to FOUNDATION > WORKFLOWS > SET UP WORKFLOW RULES
  2. Either search for an existing one or from the Top Menu click on NEW
  3. From the Actions Menu click on ACTIONS > SET AS EFFECTIVE
    OR
  4.  From the Actions Menu click on ACTIONS > SET AS NOT EFFECTIVE
    CHANGING LIFE CYCLE STATE
Panel
namegrey

Related Areas

Filter by label (Content by label)
showLabelsfalse
spacesV4Manual
showSpacefalse
excerpttrue
labelsworkflows-basics-r7,workflows-advanced-r7,workflows-admin-r7

Panel
namegrey

Popular Labels

Popular Labels
spaceKeyV4Manual
styleheatmap