RecipientName

Use this function to return from the FORM.DAT file the recipient name related to the specified section, form, or group.

You can use this function along with the HaveRecip function in DAL scripts to place a sequence number on each page of each recipient batch.

Syntax

RecipientName (Count, Section, Form, Group)

Parameter

Description

Count

An indexed reference to locate a recipient in the FORM.DAT file. The default is the first recipient in the FORM.DAT file.

Section

Enter the name of a section that contains the recipient. The default is the current section.

Form

Enter the name of a form that contains the recipient. The default is the current form.

Group

Enter the name of the form group that contains the recipient. The default is the current group.

If you omit the parameters, the system uses the first recipient it finds in the FORM.DAT file for the section, form, or group.

If the section, form, or group can not be located or the Count parameter causes the system to move beyond the last recipient in the FORM.DAT file for the section, form, or group, an empty string is returned.

See also