Use the include JSP tag to instruct stream processing to insert one stream within the current stream. This tag lets you define a commonly used segment of HTML or XML text in one rule instance and then incorporate the text where needed.
This tag is useful in source HTML text for user interface forms, in source HTML text for correspondence, and in XML text for interfaces.
Use the include tag to include any of nine rule types:
For example, this code inserts a fragment of HTML text into the currently processed stream:
<pega:include name="NewHeader" type="Rule-HTML-Fragment" />
The name
attribute identifies only the final key part or key parts of the target rule to be included. For rule types that contain an Applies To key part, the system uses the Applies To key part of the current rule at runtime and uses rule resolution to find the target rule to include.
<pega:include > JSP tags can also appear in rules of other types derived from the Rule-Stream class, such as harness, section, flow action, list view and summary view rules. In most cases, the HTML code and JSP tags for these rules are automatically generated.
Don't use this tag to include a rule within itself (recursion), as that often causes an infinite loop.
In the following syntax presentation:
[
and ]
define optional parts of the tag. Do not type the brackets.<pega:include
[name="name"]
[ref="indirect reference "]
[type="rule type"]
[inline="true"|"false" ]
/>
Either name
or ref
is required as an attribute.
Attribute |
Description |
name
|
The name — second key part — of the rule to included. Use this attribute when the name is known during design. |
ref
|
Used for indirect references, which allow the rule name to be determined dynamically at runtime. See How to reference properties indirectly in JSP tags. |
type
|
Optional. Identify the class of the rule to be included, for example If the type attribute is omitted, then the type that is included depends on the including type, as follows:
You can use any of these keywords:
You can't include a Rule-HTML-Fragment rule or Rule-Obj-Corr rule within an XML Stream rule. You can include a Rule-HTML-Property rule only within a Rule-Obj-Corr rule. |
inline
|
Optional. Set to "false" in unusual situations to disable the default Java generation approach, which inlines Java code for this tag. The "false" setting may reduce the size of the Java class generated for the stream rule, possibly allowing it to fit within the 64KB limit. The default value is "true"; inlining is preferred as it normally provides better performance. |
mode
|
ptional. Determines whether input is enabled when the included stream is displayed. Set to:
|
Three stream rule types have three key parts. If the stream rule class is Rule-Obj-Corr or Rule-Corr-Fragment, identify the second and third key parts in the value of the name attribute, separated by a period. The third key part is the Correspondence Type.
For example, the standard correspondence type Email can appear:
<pega:include name="SuccessCorr.Email" type="Rule-Obj-Corr"/>
Similarly, you can include a correspondence fragment for phone text:
<pega:include name="WorkDetail.PhoneText" type="Rule-Corr-Fragment"/>
Likewise, if the stream rule class is Rule-Obj-XML, use a period to separate the second and third key parts of the target XML Stream rule. For example:
<pega:include name="Contact.MapFrom" type="Rule-Obj-XML" />
A section may accept parameters, identified on the Params tab of the Section form. If the <pega:include > tag is for a section, you can use the <pega:params > JSP tag to supply parameter values.
For example:
<pega:include name=".GameResults" type="Rule-HTML-Section" >
<pega:param name="HomeTeam" value="Boston"/>
<pega:param name="VisitorTeam" value="Yankees" />
<pega:param name="HomeTeamRuns" value="3" />
<pega:param name="VisitorTeamRuns" value="7" />
</pega:include>