Skip to main content

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

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Creating a specialized or circumstance rule

Updated on April 5, 2022

You can create a specialized or circumstance rule to create a variant of the rule that can be triggered only conditionally. The created rule is resolved and active only when the specified conditions are met. Create specialized or circumstance rules to address dynamic business requirements without changing the core logic every time. For information about rule resolution exceptions and how they might affect circumstance rules, see Rule resolution exceptions.

The Save As and Specialize by toolbar tools are restricted to those users who hold the privilege @baseclass.ToolbarFull or @baseclass.ToolbarSaveAs.

Because the Specialization forms share most of the fields and functionality on the Create form, only exceptions and special cases are outlined in this topic.

  1. On the rule form, complete one of the following steps.
    • Create a rule that is specialized by class or ruleset.

      1. Select Save as > Specialize by class or ruleset.
      2. Provide a name for the specialized rule.
    • Create a circumstance rule.

      1. On the rule form, click Save as > Specialize by circumstance.
      2. Enter a name for the circumstance rule.
      3. Select one of the following types of circumstance: Template or Property and Date.
        • Click Template to create a template rule circumstance (by multiple properties) and then provide a template and a definition against which the template is evaluated. You must have at least one circumstance template rule created before you use it for circumstancing.
        • Click Property and Date to create a circumstance of a rule by a property, date, or a combination of both.

          • To create a property circumstance rule, provide the name of a property (for example, .pyStateName ) in the Property list and its expected value within quotation marks (for example, “MA”) in the Value box.
          • To create a date circumstance rule, enter a Date type property, start date, end date, or a combination of all of the options.

          Date combinations and business requirements lists the possible date combinations and the business-logic requirements they meet.

          If you do not specify a date property, the specified time period is always evaluated against the current system date.

          This rule is active during the specified time interval. At all other times, the base rule is active. During rule resolution, if two or more date circumstance versions are candidates at the current time and date, the application selects the candidates with the nearest end date. Of these, if multiple remaining candidate rules have the same end date, the application picks the candidate with the most recent start date.

  2. Optional: To override the default work item that your application associates with this development change, press the Down arrow key in the Work item to associate field, and then select a work item.
    For more information about your default work item, see Setting your current work item.
  3. Update the values in the Context, Apply to, and Add to ruleset lists as appropriate.
  4. Click Create and open.
  • Creating a circumstance template

    Create a circumstance template to specialize a rule by more than one feature.

  • Creating a circumstance definition

    You can create a circumstance definition to evaluate properties in a circumstance template.

  • Creating a redirected rule

    To create redirected rules, which are circumstance rules that are configured to reference other circumstance rules for the same base rules, complete the following tasks.

  • Base rules

    A base rule is the fallback rule selected by rule resolution when no other circumstance version's criteria is met. Base rules have no circumstance qualification.

  • Finding rules by circumstance

    To verify if an existing rule is either a base rule or a circumstance, open it in Dev Studio and inspect the form header. Click the Circumstanced link to see circumstance values or an indication that the rule is a base version. The link does not appear if the existing rule is neither a base nor a circumstanced version.

  • Specializing a case type

    Specialize a case type to support variations in the way that cases are processed in your application. Each version that you create is uniquely identified by a circumstance.

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