Circumstance Definition rules
Completing the New or Save As form

Create a circumstance definition by selecting Circumstance Definition from the Technical category.

When creating a circumstance definition rule, the PegaRULES database is accessed with a database account that has specific grants (capabilities). These grants may not be available to all developers. They can be provided by a DB Admin account, which can be identified on the Database tab of the Database Name instance for the PegaRULES database or in the prconfig.xml file. See Database Name form — Completing the Database tab.

If you do not have these database grants, a warning appears when you save the Circumstance Definition rule. The Circumstance Definition rule saves correctly, but you may not be able to define a report on rules with this circumstance (such as the View > Rule > Find by Circumstance report). STEWS 5.4. BUG-13117 SILVD STEWS 4/8/07.

A circumstance definition rule has three key parts:

Field	Description
Applies to Class	Select the class to which this rule applies.
Template Name	Enter the name of the circumstance template rule with which this rule is associated. This corresponds to the Purpose of Rule key in a circumstance template rule in the same Applies To class. Create at least one circumstance template rule instance before you create a circumstance definition rule.
Purpose	Enter a unique name for this rule within this class, beginning with a letter and using only alphanumeric, underscore, and dash characters. BUG-12559 not ampersand

The definition rule is class-based and rule-resolved. It cannot be qualified by circumstances or date ranges.

When performing a Save As using the same Applies to Class and Template Name, the new and the original instances will, by default, have identical properties and values in the Apply this Definition table in the Definition tab on the rule form. This creates conflict errors that prevent the new instance from being saved. Change the property values in either form to successfully save the new rule.

For general information about the New form, see Completing the new rule dialog box. For general information on the Save As form, see How to enter rule keys using Save As.

For information on how circumstance template and circumstance definition rules are used in multivariate circumstancing, see the Pega Developer Network article PRKB-25272 How multivariate circumstancing works.

About Circumstance Definition rules