Creating rules to trigger notifications for records


In BMC Helix Business Workflows, as a case business analyst, you can create custom notifications for tasks and knowledge articles by using the Rule designer in BMC Helix Innovation Studio.

You can create custom notifications to notify agents or support groups about certain changes in tasks and knowledge articles like status change, priority change, and so on.

For more information about notifications, see Notifications

To create a notification for a task or knowledge article record instance, you must perform the tasks that the following table describes:

Task

Action

Reference

1

Create an event to define the event name for a notification.

2

Create a notification template to associate it with an event, and define the content and structure of a notification.

3

Create a process to define for which event name, the process should be run.

4

Create a rule to define the trigger condition for a notification.

For example, you want to create a notification to notify an article assignee when the status of an article changes. To do this, you create an event, a notification template, and a process. Then, you create a rule to trigger the notification. When an agent changes the status of an article, the notification is sent to the article assignee.

To create a process

  1. Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
  2. Click the application name in which you want to create the rule.
  3. On the application page, click Processes, and then, click New.
  4. From the Palette, drag the Send Notification Using Event element. 
    By default, the Start and End elements are displayed on the canvas.
  5. Complete the fields according to your requirements.
    The following tables describe the fields in detail:
    • Description of fields in Process Properties

      Section

      Field

      Description

      GENERAL

      Name

      Enter the name of the process. You need to use this process in a rule so that the process is run when the notification is triggered.

      VARIABLES

      Add/Remove Variables

      The process obtains the required record details from the specified variable.

      1. Enter the name of the first variable.
        Under Input/Output Variable, Input is selected by default.
      2. In Data Type, select Record.
      3. In Record Definition, select the record for which you want to create the notification.
      4. Click Save.

      The following figure shows the sample field values in Process Properties:

      1808_Notification process properties.png

    • Description of fields for the Send Notification Using Event element

      Section

      Field

      Description

      INPUT MAP

      Event Name

      Enter the name of the event for which you want to run the process.

      Module Name

      Enter the name of the module that you selected in the notification template.

      Source Record Instance Id

      In the Available Values section, under Process Variables, expand the record fields, and add ID. Note: The input variable that you provide for the process is displayed under Process Variables in the expression builder for Source Record Instance Id.

      Attachment

      You can attach a file while sending an email notification. In the Edit Expression dialog box, select the variable from the list that you want add as an attachment.
      Note: Value for this field must be an attachment object.

      The following figure shows the sample field values for the Send Notification Using Event element:

      1808_Send notification using event element properties.png

  6. Click Save.

To create a rule

  1. Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
  2. Click the application or library in which you want to create the rule.
  3. On the application or library page, click Rule. Then, click New.
  4. From the Palette, drag the Qualification and Start Process elements on the canvas.
    By default, the Trigger element is displayed on the canvas.
  5. Complete the fields according to your requirements
    The following tables describe the fields in detail:
    • Description of fields in Rule Properties

      Section

      Field

      Description

      RECORD DEFINITIONS

      Add/Remove Record Definitions

      Click this link to add the required record for which you want to create the notification.

    • Description of fields for the Trigger element

      Section

      Field

      Description

      GENERAL

      Trigger Type

      Because notifications are sent for record instances, select Record Event.

      Record Event

      Select the type of event for which you want to create the notification.

      For example, you want to notify an article assignee about the status change of an article. This notification is sent only after the article status changes. For this notification, you specify the Record Event as After Update.

      For more information, see Defining a trigger for a rule.

      OPTIONS

      Execution Order (1 - 1000)

      Determines the precedence for rules when more than one rule is associated with the same record definition and record event.

    • Description of fields for the Qualification element

      Section

      Field

      Description

      GENERAL

      Expression

      Enter the condition for the notification to be triggered.

    • Description of fields for the Start Process element

      Section

      Field

      Description

      GENERAL

      Process To Start

      Select the process that you want to execute with the rule.

      INPUT MAP

      Click to build expression

      From the fields available for the selected record, add Current Record.png.

  6. Click Save.

For more information about rules, see Creating rules.

Where to go from here

Example-of-creating-custom-notifications

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*