Send (NotesDocument - LotusScript®)

Mails a document.

Defined in

NotesDocument

Syntax

Call notesDocument .Send( attachForm [, recipients ] )

Parameters

attachForm

Boolean. If True, the form is stored and sent along with the document. If False, it isn't. Do not attach a form that uses computed subforms.

recipients

String or array of strings. Optional. The recipients of the document. See the following information.

Usage

The following rules apply to specification of the recipient or recipients:

  • Replaces any recipients in an existing SendTo item.

  • Required if the document does not contain a SendTo item.
  • May include people, groups, or mail-in databases.

If you have only Reader access to a database, you can run an agent that creates and sends a document, but the agent will not work if you attach a file to that document.

Two kinds of items affect the mailing of the document when you use Send:

  • If the document contains additional recipient items, such as CopyTo or BlindCopyTo, Notes® mails the documents to these recipients.
  • If the document contains items to control the routing of mail, such as DeliveryPriority, DeliveryReport, or ReturnReceipt, Notes® uses these when sending the document.

The SaveMessageOnSend property controls whether the sent document is saved in the database. If SaveMessageOnSend is true and you attach the form to the document, the form is saved with the document.

Sending the form increases the size of the document, but ensures that the recipient can see all of the items on the document.

The Send method automatically creates an item called $AssistMail on the sent document. The SentByAgent property uses this item to determine if a document was mailed by a script.

If a script runs on a workstation, the mailed document contains the current user name in the From item. If a script is a scheduled agent running on a server, the mailed document contains the agent signer's name in the From item.

Example