You are here: Job and Form Set Rules Reference > JDT Rules Reference > FilterRecip

FilterRecip

Use this form set level rule to remove all forms from a form set except those that match the recipient filter criteria you specify.

Syntax

;FilterRecip;;;

You can use these INI options with this rule:

< FilterRecip >

Recip =

FilterByRecip =

Option

Description

Recip

Use this option to specify the search location for the Recip filter criteria. All occurrences of the data specified in the data are used for filtering. You can specify the search location as an XML search string or as a flat file search mask.

FilterByRecip

(Optional) Use this option to turn the rule on or off by transaction. If you include this option, the rule looks for a value of TRUE at the specified search location. If TRUE is not found, the filter logic is not executed. If you omit this option, the rule is always executed.

Here is an example of how you can use the Recip option:

Recip = 1,HEADER 20,8 (Offset,Match Offset,Length)

Filtering is performed using all data that matches the search criteria. Assume you have this INI setting:

< FilterRecip >

Recip = !/transaction/PrintRecip

And this transaction data:

<transaction>

<PrintRecip>Insured</PrintRecip>

<PrintRecip>Agent</PrintRecip>

</transaction>

Only recipients Insured and Agent will remain in the form set after the filtering process is complete.

Example

Here is an example AFGJOB.JDT file:

/*  JDT Rules for Single-Step Processing Batching By Recipient. */
<Base Rules>
;RULStandardJobProc;1;Always the first job level rule;
;JobInit1;1;;
;InitPrint;1;required to execute gendata/genprint in single step;
/* Every form set in this base uses these rules. */
<Base Form Set Rules>
;NoGenTrnTransactionProc;2;;
;LoadFormsetFromArchive;2;;
;PrintFormset;2;;
;WriteOutput;2;;
;WriteNaFile;2;;
;BatchingByRecipINI;2;;
;FilterRecip;2;;
/* Every section in this base uses these rules. */
<Base Image Rules>
;WIPImageProc;;
/* Every field in this base uses these rules. */
<Base Field Rules>
;RULWIPFieldProc;;

See also