assert JavaServer Page tag |
Use the assert JavaServer Page tag to improve processing efficiency when displaying the results of the Obj-List method. BUG-3536
In an activity that uses the Obj-List method, you identify the
concrete classes for the Page List
property that holds the
results from the method. However, when you display the Page
List
in an HTML display, the system has no way — other than
the Assert tag — to indicate in the HTML which classes are
involved.
Accordingly, at runtime the system rechecks the class of each page in the list. The pega:assert tag provides a way to indicate in the HTML which classes to use for each page.
If you're working with a class group, use the
elseassert
option for each class in the class group. In
addition, use a final elseassert
option to display something
when the system doesn't find anything in any of the classes listed.
Someone later might add a class to a class group and neglect to update
the Assert tag in HTML forms. In such cases, the elseassert
option can be important for debugging.
In the syntax presentations below:
[
and ]
define
optional parts of the tag. Do not type the brackets.<pega:assert name="class-name1" >
MARIK 6/20/06
insert content
<pega:elseassert name="class-name2" />
insert content
<pega:elseassert />
insert default content
</pega:assert>
For example, in a worklist, the data belongs to a page of class
Code-Pega-List. Each pxResults
page is limited
to one or a few classes. The assert tag reduces the number of rules the
system reads to generate the display. GENTJ 10/30/06
<pega:forEach name=".pxResults"
>
<pega:withEmbedded name="$this" >
<pega:assert name="Assign-Worklist"
>
insert row definition
</pega:assert>
</pega:withEmbedded >
</pega:forEach>
You can assess the benefits of the assert tag by using the Performance tool to compare the Rule Count number when the assert tag is used with the number when it is not used.
Obj-List method |