Back Forward HTML Property form
Completing the Parameters tab

 About HTML Property rules

Optional. Identify parameters for this HTML property rule.

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

Benefits

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

For a partial list of standard rules that accept parameters, see Atlas — Standard HTML Property 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. Do not choose a parameter name that starts with the reserved word pega.

AdvancedUse the following syntax to identify complex parameters:

  • .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 HTML property rule is referenced in another rule. This restriction is enforced when rules are saved, not at runtime.

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.

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 AdvancedOptional. Identify an HTML fragment rule that can prompt developers (when completing the Format form) with descriptive text for each parameter.

zzz About HTML Property rules