Declare OnChange rulesCompleting the Create, Save As, or Specialization form

You are here: Reference > Rule types > Declare OnChanges > Declare OnChange rules - Completing the New or Save As form

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 new record to your application or copy an existing one. You can specialize existing rules by creating a copy in a specific ruleset, against a different class or (in some cases) with a set of circumstance definitions. You may copy data instances but they 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 using the following Developer Help topics:

Completing the Create form Designer Studio – Completing the Create form
Completing the Save As form Completing the Save As form
Completing the Specialization form Completing the Specialization form

This help topic help topic 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 letters, numbers, the ampersand character, and hyphens.

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.

Related information

Open topic with navigation