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.) |
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.