Circumstance Rules

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.

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.

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.