Table of Contents

Creating rulesets


Only available versions of this content are shown in the dropdown

Reduce development time and costs by creating rulesets. After you create a ruleset, you can group rules, which are reusable elements of your application, together in a logical way in the ruleset. As a result, you conveniently manage, maintain, and reuse your rules.

For example, you can create a ruleset that stores service-level agreements (SLAs), and a separate ruleset for case notifications. If you want to make any changes to the SLA ruleset, your modifications are granular and you avoid the risk of unintended changes occurring in the case notifications ruleset. You can also provide a way for members of your development team to work in isolated sandboxes by creating branch rulesets.

When you create new rulesets, consider the following guidelines:

  • Create a new ruleset with a top-level class that inherits directly from @baseclass.
  • Use names that are easy to remember and unique for each ruleset.
  • Use names that clearly convey the purpose of the ruleset; avoid using acronyms that might be difficult to decode. For example, name your ruleset UPlusTelcoContracts instead of UPTC.
  • Always begin your ruleset name with a phrase that clearly identifies your company and the business purpose. This convention also prevents potential ruleset conflicts.
  • Do not use Pega or Pega- as a prefix for your ruleset names. These prefixes are restricted to Pega Platform internal use and can cause unexpected behavior.
  • The maximum length of a ruleset name is 32 characters. Avoid using spaces in ruleset names.
  • Avoid the use of special characters such as dashes (-), underscores (_), plus signs (+), or quotes (“ ”). The system does not permit the saving of rules with these attributes.
  • For more information about using patterns for the ruleset version number, see Organizing rules into rulesets.
  • Creating a ruleset and a ruleset version

    For easier maintenance and development of your application, create rulesets so that you can categorize the rules that your application uses based on usage, purpose, and dependencies. You can also create newer versions of existing rulesets to keep track of version control. As a result, you can quickly locate and analyze the elements that you change in your application.

  • Copying rulesets

    To speed up application development, reuse resources by copying rulesets. For example, you can copy a ruleset if you want to modify only some of the rules that the ruleset includes, to increase flexibility of your application.

Related Content


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.