User Guide

276 Chapter 15: Server Behaviors
There are two parameters (with some text in between them) to extract. Given the text:
<%= a_BIG_b %>, the first subexpression in the search pattern matches "a", so p1="a". The
second subexpression is ignored (note the
,, in the paramName value). The third subexpression
matches
"b", so p2="b".
limitSearch
Description
This attribute limits the search to some part of the whereToSearch tag.
Parent
searchPattern
Type
Attribute.
Required
No.
Values
all
, attribute+attribName, tagOnly, innerOnly
• The all value (default) searches the entire tag that is specified in the whereToSearch attribute.
• The attribute+attribName value searches only within the value of the specified attribute, as
shown in the following example:
<searchPatterns whereToSearch="tag+FORM">
<searchPattern limitSearch="attribute+ACTION">
/MY_PATTERN/
</searchPattern>
</searchPatterns>
This example indicates that only the value of the ACTION attribute of FORM tags should be
searched. If that attribute is not defined, the tag is ignored.
• The tagOnly value searches only the outer tag and ignores the innerHTML tag. This value is
valid only if
whereToSearch is a tag.
• The innerOnly value searches only the innerHTML tag and ignores the outer tag. This value is
valid only if
whereToSearch is a tag.
isOptional
Description
This attribute is a flag that indicates that the search pattern is not required to find the participant.
This is useful for complex participants that might have non-critical parameters to extract. You can
create some patterns for distinctly identifying a participant and have some optional patterns for
extracting non-critical parameters.
Parent
searchPattern