xfj:match

Top Previous Topic Next Topic  Print this topic

This element is a child of xfj:apply-rules.

 

The xfj:match element specifies a rule to include or exclude a set of pages from having the overlay applied to them. The syntax is as follows:

 

<xfj:match rule="match_function"/>

 

The match function can be one of these:

 

all - all pages of the DAL job
first - first page of the DAL job
last - last page of the DAL job
odd - odd pages of the DAL job
even - even pages of the DAL job
first(document_id) - first page of document document_id
last(document_id) - last page of document document_id
odd(document_id) - odd pages of document document_id
even(document_id) - even pages of document document_id
include(document_id) - all pages of document document_id
exclude(document_id) - do not match the whole document document_id
exclude(match_function) - do not match the rule specified by the match function in the argument

 

Note: The document_id refers to the id attribute of an xfj:document in the DAL job.

Note: The exclude() function accepts other match functions as parameters, enabling constructs such as: exclude(last), exclude(first(document1)), exclude(odd(document2)), etc. All functions are supported as an argument except include() and exclude().

Note: When multiple xfj:match elements exist, the rules are applied in the order in which they appear, with the exclude rules having greater priority.

 

Example:

 

<xfj:apply-rules>

       <xfj:match rule="all"/>

       <xfj:match rule="exclude(document1)"/>

       <xfj:match rule="exclude(first)"/>

</xfj:apply-rules>

 

This will match all the pages in the DAL, excluding the first page of the job and all pages of document1.