primary page

Primary page for activities

The primary page is a clipboard page with the same class as the activity (or selected other rules), designated when the activity is called. This page is the default location of properties referenced with a dot and no preceding page name. For greater clarity, you can reference a property on the primary page using the keyword PRIMARY followed by a dot and the property name.

When a Branch or Call instruction executes, the page in the Step Page column of the step becomes the primary page of the called activity. If the Step Page column is blank, the primary page of the current activity becomes the primary page of the called or branched-to activity.

The primary page of an activity becomes the step page of each step, except for steps where the Step Page column is not blank.

Do not confuse the primary page with the parameter page, which has a page structure but is not named, has no class, and is not part of the clipboard. References to parameters (not properties) on the parameter page always include the PARAM keyword before the dot.

Primary page for other class-based rule types

Many rule types in addition to activities have an initial key part (labeled Applies To) that identifies the class of objects that the rule applies to. However, the page at runtime that such rules "operate on" may be the current primary page, or may be another page of that class.

Execution of such rules can change property values on the primary page or on another page. Execution of such rules does not alter which page is "the" primary page, except for the following rule types:

Validate rules work with primary pages differently depending on how the rules are referenced.

Determining the current primary page

Use the Public API function tools.getPrimaryPage() to determine the primary page.

Related Topics Link IconRelated terms