FORMULA LANGUAGE
There are two ways to use @MailSend:
@MailSend @MailSend( sendTo ; copyTo ; blindCopyTo ; subject ; remark ; bodyFields ; [ flags ] )
Parameters
sendTo
When you use the [IncludeDocLink] flag (described below) to include a link to the current document, you should set the bodyFields parameter to null (""). If Notes/Domino cannot locate a field by name, it uses the string literal instead.
The available flags are:
[SIGN]
Electronically sign the memo when mailing it, using information from the user's ID. Signing does not occur unless you include this flag. This flag cannot be used in Web applications.
[ENCRYPT]
Encrypt the document using the recipient's public key, so that only the recipient whose private key matches can read the document. Encryption does not occur unless you include this flag. This flag cannot be used in Web applications.
[PRIORITYHIGH]
Immediately routes the message to the nexthop server, as defined by the combination of Mail Connection records and server records. If a phone call has to be made in order to route the message, then the call is placed immediately, regardless of the schedule set in the Remote Connection record. If you omit this flag, the priority defaults to Normal.
[PRIORITYNORMAL]
Routes the message to the nexthop server based on the schedule defined in the Mail Connect records. If the recipient's mail file resides on a server on the same Domino network, then delivery occurs immediately. If you omit this flag, the priority defaults to Normal.
[PRIORITYLOW]
Routes the message overnight if the recipient's mail file does not reside on a server on the same Notes/Domino network. If the recipient's mail file does reside on a server on the same Notes/Domino network, then delivery occurs immediately. Low Priority mail can also be controlled by a Notes/Domino environment variable called MailLowPriorityTime=x, where x is equal to a number from 0 to 23. When placed in the server notes.ini file, this variable tells the server when to route Low Priority mail. If you omit this flag, the priority defaults to Normal.
[RETURNRECEIPT]
Notify the sender when each recipient reads the message. No receipt is returned unless you include this flag.
[DELIVERYREPORTCONFIRMED]
Notify the sender whether delivery of the memo was successful or not. By default, the Basic delivery report is used, which notifies the sender only when a delivery failure occurs.
[INCLUDEDOCLINK]
Include a link pointing to the document that was open or selected when @MailSend was used. You must include this flag if you want that document linked to the mail memo. A new document must be saved.
Note This option will only work if the database contains a default view.
Use @MailSend in agents, form actions, form events, view actions, view events, and toolbar buttons. @MailSend is especially useful with scheduled agents as a means of sending mail at a predetermined interval; for example, to send reminders about a departmental meeting. One view from the database must be selected as the Default when database is first opened for the scheduled agent to work correctly. This function does not work in column, selection, hide-when, or window title formulas.
If the MailOptions field on the form is set to 0, @MailSend is disabled, and the formula fails to execute.
If the user's notes.ini file includes the statement
NoExternalApps=1
then any formula involving @MailSend is disabled. The user doesn't see an error message; the formula fails to execute.
When the [IncludeDocLink] option is used, the database must have a default view defined, and the linked document must be in it. Otherwise, @MailSend will fail.
When sending to multiple recipients within the SendTo, CopyTo, or BlindCopyTo arguments, the names must be supplied as a list with a separate list value for each recipient. For example, to send mail to both Sam and Martha at Big Company, the SendTo parameter would be "sam@bigcompany.com" : "martha@bigcompany.com", not "sam@bigcompany.com, martha@bigcompany.com".
Sending rich text fields
You can specify a rich text field as one of the bodyfields in an agent formula only.
Mail-related fields in a document
When you use @MailSend with no parameters, the current document may contain one or more mailrelated fields; if it does, those fields are used when routing the document.
Send method of LotusScript NotesDocument class
Send method of LotusScript NotesUIDocument class
send method of Java Document class
Example See Also