Back Forward Declare Pages form
Completing the Definition tab

About Declare Trigger rules

Complete this tab to define the class and scope of the declarative page or pages created by this rule, and how they are refreshed.

Field

Description

Page Scope

Select to determine the scope of requestors that can access the declarative pages created by this rule:

  • Node — Any requestor executing on the current node can access the pages.
  • Thread — The page is created in a single requestor Thread, and can be accessed as often as needed by processing in that Thread. Accesses by separate requestors cause the rule to create distinct pages, which may have different contents.
Page Class

SmartPromptSelect the class of the top level page to be created. Typically, select Code-Pega-List if the page is to store a list of other pages, such as produced by a report or the Obj-List-View method. However, a declare page may be of any class. MIRAT 6/10/08 and MIRAT 12/2/2010

Page Structure Select:
  • Page — To create a single top-level page of the class identified in the Page Class field.
  • List — (Do not use. Reserved .) MIRAT 6/10/08 affirmed 12/2/2010 not working in meaningful way.
Data Source GRP-23188
Load Activity Select to Identify the Activity Name key part of an activity that the system uses to create and update (refresh) declarative pages. At runtime, the system uses the value in the Page Class field as the Applies To key part to find the activity with rule resolution.

Select an activity that has LoadDeclarativePage as the Activity Type (on the Security tab). Confirm that this activity adds property values to the page; it is not otherwise unrestricted. See More about Declare Pages rules.

If the Page Scope field is set to Node, the system uses the RuleSet list provided by the access group in the Access Group field with rule resolution to find the activity (not the RuleSet list of the requestor). If the Page Scope field is set to Thread, the system uses the RuleSet list of the requestor to find the activity.

CautionAt runtime when searching for this activity, rule resolution excludes checked-out rules in a personal RuleSet. The system selects and executes the current checked-in version.

Report Definition

Select to identify the key parts of a report definition that the system uses to create and update (refresh) declarative pages, as an alternative to a load activity. GRP-23188 6.2

If you select this option, enter Code-Pega-List in the Page Class field.

Report Definition Class

This field appears when you select Report Definition as the source. Enter the Applies To key part of a report definition rule.

Report Definition

This field appears when you select Report Definition as the source. Enter the Report Name key part of a report definition rule.

 Params

If the activity or report definition accepts input parameters, click Params and enter literal constant values or property references as parameter values. To reference a property value, enter the fully qualified reference, starting with a top-level page name. In addition, Include the name and class of clipboard pages you reference here on the Pages & Classes tab of this rule form.

Load Activity Authorization  
Access Group

SmartPromptSelect an access group that provides temporary access to the RuleSets and versions needed to access the load activity. This field appears only when the Page Scope is set to Node. CODE-258

The requestor that executes this activity uses this access group only during execution of the activity. RuleSets made available by this access group may not be available to the requestor at other times.

Conditional Refresh Strategy

The load activity executes the first time any requestor within the scope (Node or Thread) references the page (such as to access the value of a property, or to test whether a property is present).

Optionally, you can define one or two criteria that can cause the system to delete the declarative page or pages and rerun the load activity, creating them again with possibly fresher contents.

Refresh if Older Than

Optional. Enter positive integers in one or more of these fields to define an expiration time interval in days, hours, minutes, and seconds. If not blank, any attempt by a requestor to access the page after a period of no accesses equal to or greater than the timeout causes the system to refresh the page.

Page is Fresh When

SmartPromptOptional. Identify the When Name key part of a when condition rule to be evaluated when a requestor accesses a page with a Page Scope of Thread.

If the when condition rule evaluates to false, the page is recomputed. revised LABEL MIRAT SARTM 3/10/08

To find this rule at runtime, rule resolution uses the class in the Page Class field as the Applies To class, and the RuleSet list of the requestor. This field appears only when the Page Scope is set to Thread.

Up About Declare Pages rules