Skip to main content
Verify the version tags to ensure you are consuming the intended content or, complete the latest version.

Circumstance rules

Circumstancing establishes a baseline for expected case behavior and adds variants to address exceptions to the behavior. The goal of circumstancing is to create a variant for each anticipated situation. Pega selects the appropriate variant, or circumstance, to use based on the details of the case.

When you circumstance a rule, you create a set of focused rules to address exceptions to case processing, rather than one all-encompassing rule. Since each rule focuses on a specific exception, application maintenance and updates are easier and can be delegated to business users. Reusing the rules you create at the application or enterprise level is also easier.

Circumstance a rule

To circumstance a rule, you create a base rule to define the expected behavior. Pega uses the base rule unless a circumstanced version is more appropriate.

Consider a company with different response time obligations for elite and non-elite customers. The response time for non-elite customers is the expected behavior. In this situation, the response-time goal is 24 hours. You create a base rule—in this case, a service level—to enforce the response time goal for non-elite customers. Then you identify any exceptions to the expected behavior.

For each exception, you circumstance the base rule to address the difference from the expected behavior. For example, elite customers with silver status have a response time goal of 12 hours. You circumstance the base rule to enforce the response time goal for customers with silver status. You can then create another circumstance to address the goal time for customers with gold status, who have a service level response goal of six hours.

Types of circumstancing conditions

You can circumstance a rule according to the value of one or more conditions. You define a condition based on one variable, multiple variables, date property, and as-of-date, then apply the condition to a variant of the rule. When using the rule, the application evaluates the conditions defined on all the circumstanced variants. If one of the circumstancing conditions is satisfied, the application uses the corresponding rule variant. Otherwise, the application uses the base rule.

In the following image, click the + icon to learn more about the types of circumstance conditions.

Examples of circumstancing conditions

Each variant of a rule applies one type of circumstancing condition, though you can combine conditions to circumstance a rule.

The following video provides examples of each type of circumstancing condition.

Video transcript

In Pega, you circumstance a variant of a rule using one of four types of circumstance conditions.

You use a single value circumstance to create a rule variant that is effective whenever the value of a single property satisfies the circumstancing condition. For example, many companies offer a quicker response on complaints or inquiries for customers with premium or elite status. In this situation, you circumstance a service level rule based upon the value of the property that records the customer status. If the value is silver for a case, the application uses the circumstanced variant for customers with silver status, rather than the base rule.

You use a multiple value circumstance to create a rule variant that is effective whenever a combination of property values satisfies the circumstancing condition. For example, a bank waives account fees for customers who maintain an account balance of 10000 euros. But for customers in Germany, the account balance must exceed 25000 euros. In this situation, you use a circumstance template to define the properties on which to circumstance the rule. You then use a circumstance definition to specify the minimum balance and country for the exception — 25000 euros for customers in Germany.

You circumstance on a date property to create a rule variant that is effective whenever the value of a specified date property satisfies the circumstancing condition. For example, companies often update a business process in response to business conditions, but must process existing cases under the previous version of the process. A process goes into effect on January 1 to reflect a more rigorous review of loan applications. But cases created before this date are to be completed using the old process. In this situation, you circumstance the updated process based upon the value of the pxCreateDate property — the date a case was created. If the value of pxCreateDate is a date after January 1, the application uses the updated process instead of the original process.

You circumstance a rule using an as-of date to create a rule that is effective after a certain date, or during a range of dates. For example, during December, a retailer offers free shipping on any order over $50. During the rest of the year, only orders over $100 receive free shipping. In this situation, you apply a date range to the rule that calculates the shipping charge. If a customer places an order in December, then the application applies the $50 threshold for free shipping. If the customer places an order in any other month, the application applies the $100 threshold instead.

This Topic is available in the following Module:

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?


100% found this content useful

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice