You are here: Designer Studio > Basic concepts > How your ruleset list is built

How the system assembles and uses your ruleset list

When managing access control, it is important to understand how the system develops and uses a user's ruleset list.

Overview

The ruleset list of any requestor is an ordered list of rulesets and optionally specific versions or initial portions of a version number for each ruleset. Pega 7 Platformassembles the list during log in, from several sources. Thereafter, the rule resolution algorithm uses this list to determine which rules are visible and so available to be run for that requestor.

The primary source of information for your ruleset list is the application rule referenced in your access group. That application rule, in turn, usually references a second, "built-upon" application rule, which itself can reference a built-upon application.

Because there are multiple levels and sources of the rulesets in a ruleset list, your requestor session can access the "best" or "most appropriate" rule for your exact, current situation. If there are rules that only apply to your organization unit, they are included somewhere in the list. If there are — through localization — rules that cause a user screen to be presented with German-language labels and European formats for dates and currency amounts, these also are on your ruleset list. If there are rules that only apply on Fridays, or that only apply in Massachusetts, or only apply in other circumstances, these are on your list. This power and flexibility are the reasons that the ruleset list is sometimes called the situational layer cake.

To see your current ruleset list:

In the Profile display window, locate the list labeled RuleSets. If you have a personal ruleset (named to match your Operator ID), it appears as the top entry on the list.

Your ruleset list is assembled bottom-up

For authenticated users, the ruleset list is assembled during log in, from partial lists contained in several sources. The order of rulesets and versions in the ruleset list is significant, and is preserved as the system assembles the list.

The system adds rulesets and version entries it finds in these rule and data instances to the top of the list, so the entries near the bottom are those it found earliest. However, for each source of RuleSets for this list (such as an access group) that contains more than one ruleset to be added, the system adds starting at the bottom of that array.

This technique preserves the final order. For example, if the ruleset named Mortgage appears directly above the ruleset named AllLoans in the General tab of an application rule, then Mortgage is directly above AllLoans in the assembled ruleset.

Some of the sources of your ruleset list may identify specific versions, down to the patch level, such as Mortgage:04-02-15. Others may provide only the major and minor versions, such as Mortgage:04-02. As in other contexts, this means that all patch levels of Mortgage:04-02 that are found in the system are available to rule resolution for this user.

Your ruleset list order depends on the Application-Based Assembly mode setting (prior to Pega 7 Platform)

The prconfig setting fua/assemblyCacheMode and the Revert to previous generation caching check box on the Settings tab of your access group affects the order of ruleset versions in your rulesetlist.

The prconfig setting has three values:

The default value is Mixed.

Note: As a best practice for applications developed in PRPC Version 6.3 to Pega 7 Platform, do not select the Revert to previous generation caching check box to use ABA mode. In Pega 7 Platform, VTable is the default and recommended replacement for ABA.

The ruleset list has multiple sublists

A completed ruleset list contains sublists of ruleset versions, arranged in two layers. Order is significant at the layer, sublist level, and within each sublist:

The following table presents the order (in ABA mode):

Layer

Which rulesets

Notes

1 Personal

For operators who have the Allow Rule Checkout check box selected on the Security tab of the Operator ID instance. The name of the ruleset matches the Operator ID. This ruleset, at the top of the ruleset list, holds rules checked out by the operator. Such rules are not visible to any requestor except those of this operator.

This single ruleset has no version.This ruleset is included implicitly when the system assembles the ruleset list at log-on; you do not need to reference the personal ruleset on the Access Group form or any other form.

2 Localized

If the application has been localized, rulesets with names ending in a locale suffix (such as _it_IT for Italian as spoken in Italy, or _fr_CA for French Canadian) appear here. Typically, these rulesets contain only field values. See Internationalization and localization - Concepts and terms. If the application has not been localized, this layer is empty.

3 Mobilized

If the application has been extended to support mobile devices, rulesets with names ending in the special suffix _mobile appear in this layer. Typically, such rulesets contain portals, sections, flow actions, navigation rules, and controls that are selected by rule resolution when the HTTP User-Agent value indicates that an HTTP request is from a mobile device. If the application has not been mobilized, this layer is empty. Please note that using this RuleSet is deprecated. See Pega Mobility.

4 Production

Ruleset versions listed in the Production RuleSets array on the Layout tab of the Access Group form, if any.

5 Application (current)

Ruleset versions listed in the Application RuleSets array on the General tab of the Application rule form for the current application.

A branch ruleset (if any) appears immediately above the ruleset from which it branched.

Any shared or component ruleset versions, listed the Component and Shared RuleSets array on the General tab of the Application rule form for the current application, in the order they appear on the tab.

The system assembles layers 5 and 6 from ruleset versions listed in the Application RuleSets area of the General tab of any Application rule it encounters during log-on when it processes the five data instances described in the next section of this help topic

6 (multiple) Application (built-upon)

Ruleset versions for the built-upon application referenced in the current application rule. If in turn this application references a lower built-upon application, there is a layer for each, in the same relationship as the application rules. (The contents of the Component and Shared RuleSets area of application rules referenced through the Built on Application field are ignored.)

7 PegaRULES

Rulesets and versions as listed in the PegaRULES (or PegaDM) application rule that the application is ultimately built-upon, excluding: the Pega-RULES ruleset version.

8 Pega-RULES:NN-NN

A version of the foundation rulesets.

Five data instances contribute to the rulesets list

During log in, the system starts with an empty list and retrieves information from five data instances, in the order listed.

The first four of these five sources typically reference an application rule (Rule-Application rule type) that lists rulesets and versions. That application rule may reference another application rule as a prerequisite, having its own rulesets and versions.

If you update and save an application rule or access group, all the requestor sessions associated with these instances are immediately affected with an updated ruleset list.

Contributions from the access group and the application rule

The rulesets to which the operator has access are assembled from two sources:

Note: While normally the rulesets listed in the Production RuleSets (Customization) list on the Application rule are a one-to-one match of those listed in the Production RuleSets in the Access Group form, the lists can be different. The ruleset list is assembled using the rulesets listed in the user's current Access Group's Production RuleSets list, and not the specific list on the Application rule.

When processing an application rule, the approach is depth-first. That is, if the Application rule contains a prerequisite application rule (in the Built on Application field), ruleset versions in the prerequisite application rule (or its prerequisites) are added first. Then the ruleset versions in the lists on the Application rule are added, bottom-up according to the sub-list order (component and shared RuleSets, Application RuleSets, branch RuleSets, then the production RuleSets listed in the Access Group form).

This processing may result in duplicate entries in the ruleset list. For each set of duplicates, all matches are dropped except the highest one.

How the system uses the ruleset list

Each requestor's use of the system continually causes the system to search for a rule instance. This sophisticated search, known as rule resolution, uses properties from many sources to find the most appropriate rule for the current need, including class inheritance, security and access control restrictions, and the ruleset list.

During rule resolution, the system uses the ruleset list as it:

Many other factors influence this process, such as:

Differences between Application-Based Assembly and Rules Assembly

If your requestor operates in rules assembly mode rather than Application-Based Assembly mode, the RuleSet list differs slightly from the description provided above.

In theory, this can mean that runtime results for a specific user could differ depending on the mode. However, because the specialized RuleSets that differ typically contain only specific rule types, such differences should be rare. If your application uses such RuleSets and was developed in a version earlier than Version 6.3, testing is advisable if you want to use ABA mode. See Understanding Application-Based Assembly mode.

VTable

VTable sets up the RuleSet list in the same way as ABA and is the recommended replacement for ABA. See Understanding Virtual Rules Table.

Related Topics Link IconRelated information