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

MergeRecipsFromForm

Use this form set level rule to assign the recipients from a specific form to the other forms in a form set. This lets you reduce the number of recipient triggers when all recipients receive the majority of the forms in the form set.

Syntax

;MergeRecipsFromForm;;FormName, Z flag;

Parameter	Description
FormName	The name of the form from which the recipient names are copied. The other forms in that form set are assigned these recipients, if they're not already there. The form name you specify can occur multiple times in the form set and the unique recipient names from all copies are assigned to the remaining forms in the form set.
Z flag	If you want the system to copy recipients with a zero copy count, enter the character Z (or z). The default is blank.

Parameter

Description

FormName

The name of the form from which the recipient names are copied. The other forms in that form set are assigned these recipients, if they're not already there.

The form name you specify can occur multiple times in the form set and the unique recipient names from all copies are assigned to the remaining forms in the form set.

Z flag

If you want the system to copy recipients with a zero copy count, enter the character Z (or z). The default is blank.

Example

;MergeRecipsFromForm;;Mailer Form;

Assume that before processing, the recipients for this form set are set up as follows:

Standard Form A - RECIPS=(Home Office)
Standard Form B - RECIPS=(Home Office)
Mailer Form - RECIPS=(Home Office, Agent 1)

After using this rule to process the form set, the recipients for each form are now set to:

Standard Form A - RECIPS=(Home Office, Agent 1)
Standard Form B - RECIPS=(Home Office, Agent 1)
Mailer Form - RECIPS=(Home Office, Agent 1)

Z Flag

If you want the system to copy recipients with a zero copy count, use the Z flag (it’s not case sensitive). Here is an example:

;MergeRecipsFromForm;2;FormName,Z;.

The system ignores that recipient and does not copy it to the other forms in the form set if the copy count is set to zero for a recipient and the Z flag is omitted.

Open table of contents