Back Forward Control form
Completing the Parameters tab

 About HTML Property rules
xxxxxxxxxxxxx update for V6.1SP2 Etch-A-Sketch changes xxx new rule form

C-2281 C-2282 42SP6 Optional. Identify parameters for this control rule. This tab appears only if the rule is non-auto-generated as specified by the Auto-Generated? checkbox on the HTML tab.Proj-1128 5.4

Parameters are supported on control rules identified in flow action, section, and harness rules. (Parameters are allowed only for JSP-based rules.)

Benefits

Use of parameterized control rules — both standard rules and those you build for your applications — is recommended for flexibility and to reduce the number of distinct control rules in your application.

For a partial list of standard rules that accept parameters, see Atlas — Standard Control rules with parameters.

Supplying values for parameters

Completing the tab

TipThis tab is wide. To display more of the content, click the collapse arrow (Collapse) in the portal to temporarily hide the navigation panel. When you finish working with this tab, click the expand arrow (Expand) to display the navigation panel again.

Field

Description
Name

ArrayChoose a name for this parameter, starting with a letter and using only letters and digits. B-21984 slow Do not choose a parameter name that starts with the reserved word pega.

Advanced featureUse the following syntax to identify complex parameters: Proj-1128

  • .MyValueList() — for a Value List or Value Group structure
  • .MyPageList().Prop1, MyPageList().Prop2 — for parameters Prop1 and Prop2 on the embedded pages of the Page List structure MyPageList()

As with scalar parameters, these complex parameters are not true property rules — no Rule-Obj-Property rule exists for them — but they mimic the structure of the property types. Complex parameter definitions are accepted on this Parameters tab, on the Parameters tab of the Section form.

Use the <pega:param > JSP tag, within the <pega:reference ..> JSP tag, to set values for complex and scalar parameters. Typically, complex parameter values are used within the scope of a <pega:foreach ..> JSP tag.
Description

Optional. Enter descriptive text to document the purpose of each parameter. This description appears when a developer completes parameter values.
Data Type

SmartPromptSelect String, Boolean, or Integer as the data type of the parameter.
Required?

Select to indicate that the parameter (of data type String or Integer) must not be blank when this Control rule is referenced in another rule. This restriction is enforced when rules are saved, not at runtime. REALLY?

Leave cleared for Boolean parameters.
Type for SmartPrompt

SmartPrompt Optional. To aid application developers in selecting a value for this parameter, identify a concrete class that has a single key part, such as Data-Admin-Operator-ID. This instructs the system to let developers complete this parameter value through a SmartPrompt selection rather than by typing; it has no runtime effect. Vague Examples?

Validate As

Optional. Identify a Single Value property in the Applies To class of this rule (or an ancestor class) that uses a Local List of values in the Table Edit tab. When the developer enters a parameter value, the system uses the Local List values of the referenced property.
HTML Fragment for Parameter Prompting

SmartPrompt Advanced featureOptional. Identify an HTML fragment rule that can prompt developers (when completing the Format form) with descriptive text for each parameter.

Up About Control rules