Difference between revisions of "Event Rules"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
m (Text replace - 'Cases Object' to 'Cases object')
Line 2: Line 2:
'''[[File:GearIcon.png]] > Objects > {object} > Business Rules > Event Rules'''
'''[[File:GearIcon.png]] > Objects > {object} > Business Rules > Event Rules'''
</noinclude>
</noinclude>
Specify Rules to execute when any of the following actions are taken, and specify the order in which they execute, if there is more than one. They are typically used for [[Cases Object]], but can be used for other objects, as well.
Specify Rules to execute when any of the following actions are taken, and specify the order in which they execute, if there is more than one. They are typically used for [[Cases object]], but can be used for other objects, as well.


As a simple example, suppose that you want to send someone an email whenever a case comes in for a particular customer. It's possible to do that by setting up an Event Rule--an if-condition-then-action that is triggered whenever a particular event occurs in the lifecycle of a Case. (For example, when a case is created.  
As a simple example, suppose that you want to send someone an email whenever a case comes in for a particular customer. It's possible to do that by setting up an Event Rule--an if-condition-then-action that is triggered whenever a particular event occurs in the lifecycle of a Case. (For example, when a case is created.  
Line 22: Line 22:
#::*::* A file is uploaded. (The change is to an internal system object where attachments are stored, on which rules cannot be specified.)
#::*::* A file is uploaded. (The change is to an internal system object where attachments are stored, on which rules cannot be specified.)
#::* '''Case (or Record) Deleted -''' A record is deleted.
#::* '''Case (or Record) Deleted -''' A record is deleted.
#::* '''Case Closed -''' Applies only to the [[Cases Object]].
#::* '''Case Closed -''' Applies only to the [[Cases object]].
#::* '''Case Reopened -''' Applies only to the Cases object.
#::* '''Case Reopened -''' Applies only to the Cases object.
#::* '''Process Start -''' The designated process has been initiated.
#::* '''Process Start -''' The designated process has been initiated.

Revision as of 21:28, 8 July 2015

GearIcon.png > Case Automation > Business Rules > Event Rules
GearIcon.png > Objects > {object} > Business Rules > Event Rules

Specify Rules to execute when any of the following actions are taken, and specify the order in which they execute, if there is more than one. They are typically used for Cases object, but can be used for other objects, as well.

As a simple example, suppose that you want to send someone an email whenever a case comes in for a particular customer. It's possible to do that by setting up an Event Rule--an if-condition-then-action that is triggered whenever a particular event occurs in the lifecycle of a Case. (For example, when a case is created.

For example, the "if" condition could check for a particular customer account, while the action will be to send an email. (Rules can do quite a lot more. But here, we want to limit ourselves to something quick and easy.)

To create such a rule:

  1. Go to GearIcon.png > Case Automation > Business Rules > Event Rules
    or GearIcon.png > Objects > {object} > Business Rules > Event Rules
  2. Select the Case Created event, and click [New Event Rule]
    CaseEventRuleCreate.png
    The available choices include:
    • Case (or Record) Created - A new record is created.
    • Case (or Record) Updated -Record data is modified.
      Note:' Record-updated events do not occur when:
      • A related record is modified (unless that change causes a Rollup Summary Field to be updated).
      • An email is sent or a private note is added. (The change is to the History object, which does not trigger rules.)
      • A file is uploaded. (The change is to an internal system object where attachments are stored, on which rules cannot be specified.)
    • Case (or Record) Deleted - A record is deleted.
    • Case Closed - Applies only to the Cases object.
    • Case Reopened - Applies only to the Cases object.
    • Process Start - The designated process has been initiated.
    • Process Complete - The designated process has been finished.
    • Case (or Record) Owner Changed - Someone new becomes responsible for the record.
    • Pre-Import - A record is about to be imported into this object
    • Post-Import - A record has just been imported into this object
    • Batch Import - An import process is about to begin importing records into this object.
  3. The default for such rules is to run always. In this example, you want to run when specified conditions are met, so you make that selection and then click "Add Condition".
    CaseEventRuleSettings.png
  4. When you click [Add Condition], a field chooser appears. In this case, you select the Account record associated with the case. From that record you select the Account Name, and click [Insert Field] to insert the field into the condition statement:
    CaseEventRuleConditionField.png
  5. The condition statement now appears in the Execution Criteria section of the Rule. You can now select the kind of comparison you want, and specify the value to compare to. (For example: XYZ Corp.)
    CaseEventRuleCondition.png
  6. When you're done specifying conditions, you'll specify the actions to execute when the conditions are met. In this case, you'll choose to send an email, using the same process you used when defining a Macro.
  7. When done, click [Save]