Declare OnChange rules Completing the Create, Save As or Specialization form
About  New  OnChange Properties  Pages & Classes  History  More...

Records can be created in various ways. You can add a brand new record to your application or copy an existing one. Existing rules can be specialized by creating a copy into a specific ruleset, against a different class or (in some cases) with a set of circumstance definitions. Data instances may be copied but do not support specialization as they are not versioned.

Based on your use case, the Create, Save As or Specialization form is used to create the record. The number of fields and available options vary by record type. Start by familiarizing yourself with the generic layout of these forms and their common fields:

• Completing the Create form
• Completing the Save As form
• Completing the Specialization form

This help topic then identifies the key parts and options that are applicable to the record type you are creating.

Create a Declare OnChange rule by selecting Declare OnChange from the Decision category.

Key parts:

A Declare OnChange rule has two key parts:

Field	Description
Apply to	Select a class for this rule. At runtime, a clipboard page of this class must be a top-level page. The properties to be watched may be in this class (or in the class of an embedded page). You cannot use a Rule-Declare-* class or any ancestor of the Rule-Declare- class (including @baseclass) here. You cannot use a class derived from the Code- or Embed- class here.
Identifier	Enter a unique name for this OnChange rule within the class. Begin the name with a letter and use only alphanumeric, ampersand, and dash characters. No other rules explicitly reference this Identifier value. However, because of normal class inheritance, a Declare OnChange rule named OutofStock at one level in the class structure may override (and so prevent execution of) a Declare OnChange rule named OutofStock at a higher level in the class structure.

Rule resolution

When searching for rules of this type, the system:

• Filters candidate rules based on a requestor's RuleSet list of RuleSets and versions
• Searches through ancestor classes in the class hierarchy for candidates when no matching rule is found in the starting class.

Time-qualified and circumstance-qualified rule resolution features are not available for this rule type.

About Declare OnChange rules