Reserved fields that control mailing options

To build mailing options into a form, create fields that have reserved names in Domino® Designer. When you create a field with one of these reserved names, built-in programming takes care of the task for you. The fields can be text or choice list fields that use predefined values.

For information on text fields, see the topic Text and rich text fields.

For information on choice list fields, see the topic Creating fields to display lists of choices.

For information on editable and computed fields, see the topic Editable and computed fields.

For information about mail-enabling forms, see the topic Features that support automatic mailing.

Table of fields that control mailing options

Reserved Field name

Values

Comments

BlindCopyTo

The name(s) of a person, group, or mail-in database.

CopyTo

The name(s) of a person, group, or mail-in database.

DeliveryPriority

L, N, H

Values correspond to: Low, normal, or high-priority.

DeliveryReport

N, B, C, T

Values correspond to: None, Only on failure, Confirm delivery, Trace entire path

Encrypt

1, 0

Use 1 to encrypt mailed documents.

MailOptions

1, 0

Use 1 for automatic mailing.

ReturnReceipt

1, 0

Use 1 to send a receipt when document is opened by the recipient.

SaveOptions

1, 0

Use 1 to save mailed documents. Use 0 so that the document is not saved when mailed. prevent the document from being saved.

SendTo

The name(s) of a person, group, or mail-in database.

Required for all forms that mail documents.

Sign

1, 0

Use 1 to an add electronic signature to fields. (Only applicable if a form also contains sign-enabled fields.)

Tip: If you write a LotusScript® program that uses the Send method of the NotesDocument class or a formula that uses @MailSend, you can include many of the previous mailing options in the script or formula.

For more information on using LotusScript®, see the Domino® Designer Programming Guide.

Interactions with the Mail Send dialog box

The MailOptions field with a value of 1 overrides the user's choices in the Mail Send dialog box if the form is set to enable optional mailing. With a MailOptions field set to 1, users can click Yes to save the document, No to close without saving, or Cancel to return to the document.

The Sign, Encrypt, and SaveOptions fields with values of 1 override the property "On Close: Present mail send dialog" in the Form Properties box, but they do not actually change what is displayed to users in the Mail Send dialog box.

Interactions with the Document Save dialog box

The values in SaveOptions, Sign, and Encrypt fields override the user's settings in the Document Save dialog box.

MailOptions

The MailOptions field with a value of 1 overrides the property "On Close: Present mail send dialog" in the Form Properties box. With a MailOptions field set to 1, users can click Yes to save the document, No to close without saving, or Cancel to return to the document. To add the mail signing and encryption options, create editable keywords fields named Sign and Encrypt.

SendTo

The "Allow multi-values" and "Allow values not in list" are useful for SendTo fields.

Example