Back Forward Model form
Completing the Definition tab
  1. About
  2. New
  3. Definition
  4. Parameters
  5. Pages & Classes
  6. History
  7. More...

XXXXXXXXXXXXXXXXX MAJOR REVISIONS 6.2 FOR PROJ-577 DATA TRANSFORMS EPIC XXXXXXXXXXXXXX

XXXXXXXXXXXXXXXXX Thinking about using the ExpCol sections to provide explanations of each action XXXXXXXXXXXXXX

Use the Definition tab to define the actions to be taken on the specified data, in a structured sequence. Each row in the sequence applies the action specified in its Action column. In general, a row specifies:GRP-23551

At runtime, the system applies the specified actions according to the row order on this tab. A Source reference in one row can refer to a Target that is computed in a higher row.

XXXXXXXXXXXX KOWAL: Determine best use of Exp/Col sections for the descriptions of the Data Transform actions XXXXXXXXXXXXXXX

  Show all 

TipIf this model is used to initialize a newly created page, do not set properties to the null value (or empty string ""). This has no effect on later computations involving the property, as the PropertyExists() function returns false for such properties, and properties with a null value are not saved into the PegaRULES database by the Obj-Save method.BEACT (Models that apply to a class derived from the Rule- base class are exceptions, because null values are important to runtime forms created by the Form Builder.)

XXXXXXXXXXXXX 6.2 PROJ-577 Check that the above paragraph is still true with new Data Transformation enhancements XXXXXXXXXXXXXXXXX

Field

Description

Click to add a new row.
Action
Action menu choices

Select the action:

  • Append and map to —
  • Append to —
  • Apply model —
  • Comment — Specifies descriptive text (the comment). Use this action to provide comments within the sequence. For example, to explain the goal of a particular branch of steps. GRP-24091
  • Exit Iteration —
  • Exit model —
  • For each page in —
  • Otherwise —
  • Otherwise when —
  • Remove — Deletes the target and any associated values from the clipboard.GRP-23551XXXXX Get more clarity from PROJ-577 team. Both top-level and embedded pages? All value types of properties?
  • Set — Sets the target to equal the source. You can set single value properties, top-level pages, embedded pages, page lists, and page groups. Set is typically used to initialize properties.GRP-23551XXXXX Get more clarity from PROJ-577 team about use of pages here. And what about Value List and Value Group? XXXXXXX
  • Update page — Sets the context for setting properties on the target page. Use when you want to set properties on a page that is different than the primary page. If the source page is different than the primary page, select the with values from choice from the Relation drop-down list, and specify the source page. GRP-23552
  • When —
Target

Specify the target of the selected Action.

The gray text in the Target field provides guidance for the appropriate type to enter. For example, when When is selected in the Action field, the Target field displays [condition] to indicate a when condition should be specified:

Target sample guidance for Apply model action

Click the pencil icon () to open the target's rule form.GRP-23448

Some actions do not involve targets (for example, the Exit model action). If the action does not use a target, the Target field is not available.

For targets that specify values, see How to reference properties.GRP-23551

KOWAL: 12/09/2010 Removed mention of using two forward slashes to indicate a comment, per PROJ-577's verification that use of forward slashes has not worked at least since v4.1

Relation

Specify the relationship between the target and the source.

The availability of the Relation settings depends on what action is selected in that row. For example, the Comment action has no associated Relation setting, and the Set action has a fixed Relation setting of to.GRP-23551
Source

Specify the target of the selected Action.

The gray text in the Source field provides guidance for the appropriate type to enter. Click the pencil icon () to open the source's rule form.GRP-23448

Some actions do not involve sources (for example, the Comment action). If the action does not use a source, the Source field is not available.

For actions whose sources can be values, you can specify an expression. See About Expressions. For guided assistance in entering complex expressions, click to start the Expression Builder. If you use an expression that references a value on a page other than the page being updated, list that page name and class on the Pages & Classes tab.XXXXXXXXX Validate wording with PROJ-577 team for 6.2. Are Sources always values?

TipTo enter literal constants that represent a Date (as "20051215") or DateTime value, remember to include double quotes to distinguish them from integer constants. B-13124 B-15954 CLINB

TipDon't use "" as a value to initialize a property of type TrueFalse. Use "T" or "F" for true or false values respectively.

  Super Class Model

Select the Call superclass model? checkbox to chain together this model and a model in the immediate parent class having the same Model Name. At runtime, the system performs the actions defined in the parent class first. (If the parent class model also has this checkbox selected, its own parent's model is used first, and so on.) 03-02 C-252/R-4940 R-4942

Field

Description
Call superclass Model?

03-02 10/25/02 C-252 Select to cause the system at runtime to apply a model of the immediate parent of this model's class (with the same Model Name) before it applies this model.

This approach can link together several models. This capability is sometimes described as model chaining. The model that is found may (through this checkbox) refer to still another model of this name, in a still-higher class.

R-6248 NJENC Click the pencil icon () to open the model of the superclass.

Note the details of the internal algorithm for this feature:

  1. Process Commander identifies the parent of the current class using the Parent field in the class definition, not by following full class hierarchy searches. (Thus, it uses directed inheritance first to find the parent, then pattern inheritance.) Q-1310 B-13598 affirmed
  2. After identifying a parent class, the system uses rule resolution to find the model of the same name as the current model.
  3. The model in the highest class is applied first. The current model is applied last.

TURBT 1/9/03 MIRAT For example, assume a model named FirstModel in the class Master-MyDesign has this box selected. The system examines the Rule-Obj-Class instance named MyDesign to locate its parent class (say Data-Master-). It then uses rule resolution to find another model named FirstModel, starting with the Data-Master- class. The rule resolution search depends on the user's RuleSet list, versions, time-based rules, circumstances, and so on.

Up About Model rules