Business Rule Configuration for IM Tahoe SP1

How to Configure a Business Rule?

To configure a Business Rule, perform the following steps:

Select Admin >Basic > Infrastructure > Business Rule.
On the BUSINESS RULE page, click ADD NEW on the ACTIONS panel. The following page is displayed.

Figure: BUSINESS RULE page
Select the Tenant and fill in the required details. For more information, see Field Description.
1. Fill in the other required details under RULE DEFINITION, TRIGGER, CONDITION, and ACTION sections.
2. Click SUBMIT. A new Business Rule is configured.

Field Description

The following table describes the fields on the BUSINESS RULE page:

Field

Description

RULE DEFINITION

Name

Type in a name for the business rule.

Description

Type in a detailed description.

Execution Order

By default, the execution order number is blank. Each Business Rule can be assigned an execution order number. The order number is the deciding factor when same field is updating from different Business Rules. Rule with higher order number is processed first and given precedence over rules with lower order number.

Note: If the execution order number is same, then the business rule executed based on the created date.

BR Processing Logics:

Execution Order - Highest to Lowest
Creation date - Earliest to Latest

Active

If selected, the Business Rule becomes active.

TRIGGER

Module

Select the Module from the drop-down list. As of now you can create Business Rules only for Incident Management Module.

When

You can define when this business rule should execute.

After: If selected, the business rule will trigger once the Incident is created or updated. Also, the incident will be frozen i.e. no update will be allowed for the incident until the Business Rule is processed.
Async: If selected, the business rule will trigger once the Incident is created or updated or scheduled. In case of Async, the Incident will not be frozen and the Business Rules will be processed asynchronously.

Trigger Type

Create: Select this check box to execute the business rule when a record is created.
Update: Select this check box to execute the business rule when a record is updated.
Schedule: Select this check box to execute the business rule when a record is scheduled.
Note:
If Schedule check box is selected, then When must be selected as Async.
- icon is displayed if the schedule job is configured for this business rule. A sample screenshot is shown below:
- icon is displayed if the scheduler is not configured for this business rule and displays the following message:
  "A scheduler does not exist for this business rule in the custom scheduler." A sample screenshot is shown below:
  
  Click icon, CUSTOM SCHEDULER page is opened in a new tab to configure the custom scheduler.
- Once u click SUBMIT to create the business rule when Trigger Type is Schedule. The following pop-up is displayed:
  
  Click OK to create the schedule for the defined business rule. The CUSTOM SCHEDULER page is displayed with a new tab with created Business Rule.
  
  Screenshot: CUSTOM SCHEDULER
  
  On CUSTOM SCHEDULER page Job Options will be displayed as Business Rule Processing and Business Rule field value will contain the business rule from where the navigation happens.

CONDITION

When a Request Arrives

(When Trigger Type is selected as Create or Update)

When the scheduled business rule runs

(When Trigger Type is selected as Schedule)

Use the condition builder to determine when the business rule actions should be executed.

Conditions based on criteria: Select this radio button to specify the conditions based on which the action would be executed.
No Condition: Select this radio button, if there are no conditions.

Adding Conditions:

A condition consists of the following parts:

Field: The fields related to incident management module are populated in the drop-down list. Select the required option.
Operator: Based on the selected field value, the operators are displayed. Select the required operator from the drop-down list. The Possible values for Operator are: Contains, Does not contain, Equals, Not Equals, Is one of, Is not one of, Greater Than, Less Than, Less than or equal to, Greater than or equal to, and Between.
Value: Based on the selected Field type and Operator the options are populated in the Values field.
Click icon to add a new condition.

Figure: CONDITION (Create or Update)

Figure: CONDITION (Schedule)

The following are the three scenarios w.r.t to AND and OR operators if Trigger Type is Schedule.
- Logical operator will be default to AND operator
  
  Example: Consider that you want to trigger a business rule when an incident has Server Category with Impact as High. In this case, AND will be the only operator between these two single conditions.
- Logical operator within a condition group will be AND operator
  
  Example: Consider that you want to trigger a business rule when an incident has Server Category and with Impact as High. In this case, you can set these two conditions as single condition as shown below using Group Conditions and AND will be the only operator within the conditions of a group.
- Logical operator between a condition groups will be OR operator
  
  Example: Consider that you want to trigger a business rule when an incident has Server Category and with Impact as High or when an incident has Priority as P2 and Status as In-Progress. In this case, you can set all the conditions as two group conditions as shown below using Group Conditions. In this case OR will be the only operator between any two group conditions.
You can define multiple conditions with AND/OR operator.
You can add a condition by clicking on the icon present at the end of every condition.
You can delete a condition by clicking on the icon present at the end of every condition.

Group Conditions ():

Using the Group Conditions option, you can define multiple conditions as a single condition using AND/OR.

Example: Consider that you want to trigger a business rule when an incident is created for Network Category with a Priority as P2 or Impact as Low. In this case, you can set the all the conditions as single condition as shown below using Group Conditions.

To create a Group of Conditions, select the check boxes of respective condition rows and click (Group Conditions) icon.

Note: Only adjacent conditions can be grouped. Already grouped condition rows cannot be used for another Group.

To Ungroup Conditions, click (Ungroup Conditions) icon as shown below.

ACTION

Time Zone for Notification and API

Caller Time Zone: If selected, values for date and time fields in notification template and API will be based on the Caller Time Zone.
Analyst Time Zone: If selected, values for date and time fields in notification template and API will be based on the Analyst Time Zone.

UPDATE FIELDS

Under this tab, you can configure update field values. You can update the both standard and custom field values.

Update Action Type

Update values first time: If selected, will update the fields only for the first time when the record is updated.
Update values every time: If selected, will update the fields every time when the record is updated.

Note:

The Update Action Type field displayed only when the Trigger Type is selected as Update.
There are few mandatory fields based on status value selection. Based on the selected status value the following mandatory fields are displayed.

The following fields become mandatory based on status value selection. Also, the for the mandatory fields the icon will not displayed at the end of every row.

Status Value	Mandatory Fields
Assigned	Workgroup/ Assigned Workgroup, Category, Classification, Impact, Urgency, Priority, SLA Service Window, Symptom and Description.
In Progress	Workgroup/ Assigned Workgroup, Category, Classification, Impact, Urgency, Priority, SLA Service Window, Symptom, Description, Target Completion Date, Response SLA Violation Reason, and Analyst/Assigned To.
Pending	Response SLA Violation Reason, Analyst/Assigned To, Workgroup/ Assigned Workgroup, Target Completion Date, Symptom, Description, Category, Classification, Impact, Urgency, Priority, SLA Service Window, and Pending Reason.
Resolved	Response SLA Violation Reason, Analyst/Assigned To, Workgroup/ Assigned Workgroup, Target Completion Date, Symptom, Description, SLA Service Window Category, Classification, Impact, Urgency, Priority, Solution, Resolution Code, Closure Code, and Resolution SLA Violation Reason.

Incident Closing Mode: Select the mode in which the Incident can be closed after resolving the Incident.

Auto: If selected, the status of an Incident is changed from Resolved to Closed after the configured number of days.
Manual: If selected, the Analyst needs to manually close the Incident.

Auto Closing Mode: Type in the number of days after which the status of the Incident should automatically change to Closed from Resolved.

Select one of the following options from the drop-down box:

Business Days - Business days will be considered based on SLA Service Window configuration (Incident > Configuration > SLA Configurations > SLA Service Window).
Calendar Days - Calendar days will include Holidays for auto closure.

Note:

When you select the Incident Closing Mode as Auto, you need to provide a value for this field (Auto Closing Days). Also, the application will not consider the weekends (Saturday and Sunday) for Auto closure.
Incident Closing Mode configuration done at Business Rule Designer will override the incident closure configuration done at Tenant, Category and Workgroup level.

By default, the option Business Days is selected.

A sample screenshot is shown below:

Delete Fields

You can delete an update field row by clicking on the icon present at the end of every row.

Override Values

If the Override Values = YES, then the values defined for the field in the Business Rule will override the values set for that field in the record.
If the Override Values = NO, then the values defined for the field in the Business Rule will be applied only if the value is not set for that field in the record. As stated otherwise, if there is a value already available for a particular field in the record, then the Business Rule Value will not be applied.

NOTIFICATION

Under this tab, you can configure the notification templates for the business rule. You can create new notification template or use the existing notification template to send a notification to users.

You can configure the following notification types:

E-mail Notification
SMS Notification

E- Mail Notification

To create E-Mail Notification, perform the following steps:

Under the Notification tab, click ADD NOTIFICATION. The NOTIFICATION pop-up is displayed.

Figure: BUSINESS RULE - ACTION

Figure: NOTIFICATION pop-up
Fill in the required details. For more details, see Field Description.
Note:
Use Dollar ('$') and type a character to trigger suggestions for Incident Attributes in Email Subject and Email Body.
Click SAVE. A new E-mail Notification is created and displayed under the Unlinked Notifications section.

Figure: NOTIFICATION pop-up - Unlinked Notifications
Click SAVE AND SELECT to save and select the template under the Notification tab of ACTION section.

Note:
Send notification first time: If selected, will send notification only for the first time when the record is updated.
Send notification every time: If selected, will send the notification every time when the record is updated.
Click CANCEL to close the NOTIFICATION pop-up.

Field Description

The following table describes the fields on the NOTIFICATION pop-up:

Field

Description

Notification Name

Type in the name for the e-mail notification template.

Medium

Select the medium as E-mail to configure E-mail notification.

To

Add the main recipients of the email.

Group	Members
By Caller Group	Caller Caller's cc book Caller's Customer SPOC Caller's Line Manager Caller's Reporting Manager
By Analyst Group	Analyst Incident Vendor SPOC Incident Workgroup Incident Workgroup -Additional Owners Incident Workgroup Owner
By Designation	Search and select the required Designations
By Workgroup	Search and select the required Workgroups
By User Type	Search and select the required User Types
By Customer	Search and select the required Customers
Custom E-mail ID	Type in required e-mail id
By Custom Attribute	The custom attributes configured in Form Builder for Tenant is displayed here. The entries specified in the custom attributes in the specific incidents are considered as mail recipients and mail is initiated when business rule executes. Earlier Business rule designer was configured to initiate email to a configured set of audience. The custom attributes of type Text Area, Text Box and Email Id will be listed when user selects Custom attributes option in the To and CC sections of Notification designer. Only valid email IDs will be taken as recipients and can receive notification when business rule executes.

CC

Add the recipients to receive a copy of the email that you sent to the people listed in the To: field.

Group	Members
By Caller Group	Caller Caller's cc book Caller's Customer SPOC Caller's Line Manager Caller's Reporting Manager
By Analyst Group	Analyst Incident Vendor SPOC Incident Workgroup Incident Workgroup -Additional Owners Incident Workgroup Owner
By Designation	Search and select the required Designations
By Workgroup	Search and select the required Workgroups
By User Type	Search and select the required User Types
By Customer	Search and select the required Customers
Custom E-mail ID	Type in required e-mail id

Email Subject

Type in the subject.

Note: Use Dollar ('$') and type a character to trigger suggestions for Incident Attributes in Email Subject and Email Body.

Email Body

Type in the body content.

Note: Use Dollar ('$') and type a character to trigger suggestions for Incident Attributes in Email Subject and Email Body.

SMS Notification

To create an SMS notification, perform the following steps:

Under the Notification tab, click ADD NOTIFICATION. The NOTIFICATION pop-up is displayed.

Note:
Select Medium as SMS to create SMS notification.

Figure: NOTIFICATION pop-up
Fill in the required details. For more information, see Field Description.
Note:
Use Dollar ('$') and type a character to trigger suggestions for Incident Attributes in Description.
Click SAVE. A new SMS Notification is created and displayed under the Unlinked Notifications section.

Note
- Click (Edit) icon to edit the template details as shown above.
- Click (Delete) icon to delete a template.
Click SAVE AND SELECT to save and select the template under the Notification tab of ACTION section.
Click CANCEL to close the NOTIFICATION pop-up.
Note:
Send notification first time: If selected, will send notification only for the first time when the record is updated.
Send notification every time: If selected, will send the notification every time when the record is updated.

Field Description

The following table describes the fields on the NOTIFICATION pop-up:

Field

Description

Notification Name

Type in the name for the SMS notification template.

Medium

Select the medium as SMS to configure SMS notification.

To

Add the main recipients of the email.

Group	Members
By Caller Group	Caller Caller's cc book Caller's Customer SPOC Caller's Line Manager Caller's Reporting Manager
By Analyst Group	Analyst Incident Vendor SPOC Incident Workgroup Incident Workgroup -Additional Owners Incident Workgroup Owner
By Designation	Search and select the required Designations
By Workgroup	Search and select the required Workgroups
By User Type	Search and select the required User Types
By Customer	Search and select the required Customers
Custom E-mail ID	Type in required e-mail id

Message Expiry Time (Mins.)

Specify the message expiry time in minutes

Description

Type in the detailed description.

Search Notifications

You can search notifications using the Search Notifications search box.

Filter By

Select All to view both E-mail and SMS notifications.
Select E-mail to view only E-mail notifications under the Linked to this Business Rule, Linked to other Business Rules, Unlinked Notifications, and Existing Templates.
Select SMS to view only SMS notifications under the Linked to this Business Rule, Linked to other Business Rules, Unlinked Notifications, and Existing Templates.

Linked to this Business Rule

Under this section, you can view the list of notification templates linked to this Business Rule. Also, you can edit and delete the notification templates available under this section.

To edit a notification template, perform the following steps:

Click (Edit) icon adjacent to template name. The preview of the notification template loads on the right section.
Fill in the required details.
Click SAVE to save only the changes.
Click SAVE AND SELECT to display under Notification tab of ACTION section.
Click CANCEL to close the NOTIFICATION pop-up.

To delete a notification template, perform the following steps:

Click (Delete) icon adjacent to template name.
A warning message displayed as shown below.
Click OK to delete the notification template.

Linked to other Business Rule

Under this section, you can view the list of notification templates linked to other Business Rules.

Unlinked Notifications

Under this section, you can view the list of unlinked notifications. These notifications are created but not linked with any business rule.

Existing Templates

Under this section, you can view the existing email notification templates which are configured for the selected Tenant and Module (Incident Management).

Incident Transferred
Incident Assigned
Incident Updated to Pending
New Incident Logged (other sources)
Incident Updated (other sources)
Incident Updated by the Caller (other sources)
Incident Review Mail Template To Engineer
Closure Mail with Feedback
Incident Resolved
Incident Updated by the Analyst
Incident Updated to Pending
New Incident Logged
Auto Escalation Email for Pending
Custom E-Mail Notification
Incident Closed by the Caller
Auto Escalation Email for Resolution
Auto Escalation Email for Resolution to Analyst
Auto Escalation Email for Resolution to Workgroup
Manual Escalation
Action "REMINDER" for Self, Assigned To, and Other Users
Incident Re-Opened by the Caller
Incident Updated by the Caller
Auto Escalation Email for Resolution to Caller
Incident Re-Opened
Incident Cancelled
Incident Cancelled (Caller/Analyst)
Closed Incident Update to Caller (Mail to Ticket)
Incident Pending for User Response Reminder
Auto Escalation Email for Response
Escalation Reassigning Ticket - IM
Incident Resolved
Incident Resolved (Other Sources)
Auto Escalation Email for Pending to Caller
Auto Escalation Email for Response to Caller
Incident Closed
Major Incident Identified (from job)
Feedback Reminder
Incident Updated by External User
Action "REMINDER" for Caller
Incident Updated with User Communication

API

ADD API

To add API, perform the following steps:

Under the API tab, click ADD API. The API pop-up is displayed.

Figure: BUSINESS RULE - ACTION

Figure: API pop-up - Body tab
Fill in the required details. For more information, see Field Description.
Click SAVE. A new API is created and displayed under the Unlinked Notifications section.
Click SAVE AND SELECT to save and select the template under the API tab of the ACTION section.
Click CANCEL to close the API pop-up.

Field Description

The following table describes the fields on the API pop-up:

Field	Description
API Configuration Name	Type in the Name for the API Configuration.
Method	Select the required Method from the drop-down list. The available methods are: GET - for new request POST - add new data PUT - replace existing data
API Timeout (In seconds)	Specify the Timeout in seconds
API URL	Specify the API URL
Params	You can send path and query parameters with your requests using the Params tab. To send a path and query parameter, Click the Params tab. Click icon to add a new row. Enter the Key, Value, and Description. Slide the toggle button to right- hand side to make this path/query parameter active.
Authentication	Authentication involves verifying the identity of the client sending a request, and authorization involves verifying that the client has permission to carry out the endpoint operation. Open the Authorization tab to configure your access details. Select the required Authentication type from the drop-down list. The available types are: API Key Bearer Token Basic OAuth 2.0
Headers	Some APIs require you to send particular headers along with requests, typically to provide additional metadata about the operation you are performing. You can set these up in the Headers tab. Enter any key-value pairs you need and will send them along with your request.
Body	The Body tab allows you to specify the data you need to send with a request.
Response	Under this tab, you can view the API response.

Linked to this Business Rule

Under this section, you can view the list of APIs linked to this Business Rule. Also, you can edit and delete the APIs available under this section.

Linked to other Business Rule

Under this section, you can view the list of APIs linked to other Business Rules. Also, you can edit and delete the APIs available under this section.

Unlinked APIs

Under this section, you can view the list of unlinked notifications. These notifications are created but not linked with any business rule

Enhanced Notification functionality of Business Rule Designer

The existing Notification designer is enhanced with an option to add recipients via custom attributes. The entries specified in the custom attributes in the specific incidents are considered as mail recipients and mail is initiated when business rule executes. Earlier Business rule designer was configured to initiate email to a configured set of audience. The custom attributes of type Text Area, Text Box and Email Id will be listed when user selects Custom attributes option in the To and CC sections of Notification designer.

The following figure depicts the steps involved. The figure summarizes this enhancement of notification in Business Rule Designer.

Figure: Notification in BRD enhancement

ACTIONS

This section explains all the icons displayed on the ACTIONS panel of the BUSINESS RULE configuration page.

SHOW LIST

Click SHOW LIST to display the BUSINESS RULES table showing all the configured Business Rule details for the selected Tenant.

Figure: BUSINESS RULE LIST Page

You can perform the following actions on the BUSINESS RULES Page.

By clicking the (Edit) icon, you can edit the business rule order or execution order from the BUSINESS RULES Page.
You can make the specific business rule active or inactive from the BUSINESS RULES Page.

To inactive a Business Rule, perform the below steps:
1. Uncheck the check Active check box, a pop-up displayed with a message as shown below.
  
  Note:
  If the Trigger Type is selected as Schedule, the schedule job is running. Now, if the user attempts to deactivate the business rule or to change the Trigger Type, then the user will be asked to delete the schedule associated with the business rule and the following message is displayed:
  
  Click Ok to delete the scheduler record.
2. Click OK to inactive a Business Rule.
  Note:
  To display the inactive business rules, click the Include Inactive check box.

CHANGE HISTORY

Click CHANGE HISTORY to view the changes that occurred on the Business Rule, the user who made the changes, the date and time when the change was made, and also the Old and New values for the Business Rule.

ACTIONS

This section explains all the icons displayed on the ACTIONS panel of the BUSINESS RULES LIST page.

FILTERS

Click Filters to specify particular filter criteria to display the Business Rules. On clicking the Filters icon, the FILTERS pop-up page is displayed.

Field Description

The following table describes the fields on the FILTERS pop-up:

Field	Description
Module	Select the module.
Action	Select the action. Available options are as following: ALL Update Fields Send Notification API
Created Date	Select the From and To date values.
Created By	Specify the name who has created the business rule.
Updated Date	Select the From and To date values.
Updated By	Specify the name who has updated the business rule.
Execution Order	Specify the execution order.
Search Text	Specify the search text.
Trigger Type	Select the Trigger type. Available options are as following: ALL Create Update Schedule
Schedule Configured	Select the one of the options. Available options are as following: ALL Configured Not Configured Note: Schedule Configured option is visible only if Trigger Type is selected as Schedule.

ADD NEW

Click ADD NEW to configure a new Business Rule.

Notes:

End User screen will be frozen when manually escalated, reopened, closed/cancelled
Async rule will be processed based on the latest data of the Incident.
Admin has to configure the required notifications for the Business Rule. Default notifications applicable for Incident Management module will not be sent.
Orchestration call will be triggered for the Incident after business rule processing in case of update fields action.
Tenant Settings: Below Tenant configuration checks are applicable for Business Rule Configuration.
- Enable Manual Incident Cancellation Icon
- Enable Category Parent Node Selection
- Enable Classification Parent Node Selection
- Minimum Symptom Length
- Description Length
- Do Not Allow Images in Description
- Enable Capture of Closure Category
- Enable Secondary Analyst
- Minimum Characters for Solution
- Allow Analyst to Edit Symptom
- Allow Analyst to Edit Description
- Additional Information Tab
Availability Management related calls for incident creation or updation are not considered for business rule invocation.
API calls with reference to UpdateFromTFSToDB are not considered for business rule invocation.

Known Issues

CC recipients are not grouped by customer.

How to Configure a Business Rule?

Field Description

Adding Conditions:

Field Description

Field Description

Field Description

Release Notes | Installation Guide | Other Documents