Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Using setting rules

Updated on July 1, 2021

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.

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us