Skip to main content

Table of Contents

Using setting rules


Only available versions of this content are shown in the dropdown

Use a setting rule to define a name and data type for a setting that your application can use for finely tuned access control. You can define access for different access roles based on the value of a setting. You associate the setting name and value on the Access of Role to Object rules for various class/role combinations.

Settings and values become associated with individual users indirectly. Each user has an associated access group, referenced in the Operator ID data instance. The access group identifies one or more access roles. Access of Role to Object rules with these roles as a first key part define many aspects of user access control. These Access of Role to Object rules might reference settings rules and define values for each setting.

Setting rules have no relation to application settings rules (Rule-Admin-System-Settings rule type) or dynamic system settings (Data-Admin-System-Settings class).


Use the Application Explorer to list setting rules in your application. Use the Records Explorer to list all the setting rules that are available to you.


For example, an application includes two access roles named Underwriter and SeniorUnderwriter. You create a setting rule named PolicyLimit so that the application can assign work to operators of each role based on the amount of a policy.

In the appropriate Access of Role to Object rules, you associate a different policy limit amount with each access role. In processing, policies with a value of $50,000 or less can be routed to an Underwriter and policies worth more than $50,000 can be routed to a Senior Underwriter.

Functions that evaluate settings

Activities in your application can use three standard functions in the Pega-RULES:Settings library to evaluate settings at run time:
getSetting(AppliesTo, SettingName)
Return the setting value.
getSettingType(AppliesTo, SettingName)
Return a Java type for the setting, such as string, int, double, datetime, or null (not found).
getNumericSetting(AppliesTo, SettingName)
Return the value as a Decimal property value.
Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

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

Pega Community 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
Contact us