Determine Workflow Control
Several @Commands enable developers to execute workflow-related commands. Many of these commands are also available to users, who can manually select the appropriate action from the pull-down menu bar. However, these @Commands can also be automated as part of a workflow application (see Table 11.6).
| @Command | Description |
|---|---|
| @Command([MailAddress]) | Displays the Mail Send dialog box so that the user can select people/groups/servers to include in the address field of a mail document. The mail document must be open, in edit mode, and the cursor must be in an editable text field. |
| @Command([MailComposeMemo]) | Creates a new blank mail memo document by using the default form in the user's mail database. This command can be used anywhere except from within a dialog box. |
| @Command([MailForwardAsAttachment]) | For cc:Mail, forwards a Notes/Domino document as a cc:Mail attachment. |
| @Command([MailForward]) | Forwards the current document as the contents of the mail memo. The document must be open, in read or edit mode, or selected in a view or folder. You can select multiple documents and have them all copied into the body of the memo. |
| @Command([MailSend]) | Displays the Send Mail dialog box. The dialog box presents the options to Encrypt, Sign, and Send the current document. The document must be open, in read or edit mode, or selected in a view or folder. In addition, the document must contain a SendTo field with the recipients specified. |
Several functions enable developers to execute workflow-related commands. These functions can be automated as part of a workflow application.
The @MailSend Command
One of the most frequent methods used for routing mail is achieved by using @MailSend. @MailSend routes a copy of the current document to the recipient list. A document link can be included within the mail memo so that a link back to the original document is also sent to the recipients. The benefit to this method is that multiple copies of the document are not being routed throughout the organization. All users who receive the mail memo and click on the document link will link to the same original document. Of course, for the recipients to be able to open the document link, they must have access to the server where the linked document exists (recipients need physical access as well as granted permission to access the server) and have at least Reader access to the database in which the document exists.
The syntax of the @Mailsend document is:
@MailSend(sendto; copyto; blindcopyto; subject; remark; bodyFields; [flags])
The bodyFields option contains a list of the text fields to include from the original document.
The [flags] that can be included are
[IncludeDocLink]— Sends the message with a doclink to the original document containing the @MailSend function.
[Encrypt]— Encrypts the document. The memo's recipient must have the private key to read the document.
[PriorityHigh]— Instructs the mail server to immediately route the message. Depending on the mail routing configuration, the server either places a phone call to the next server in routing topology so that the memo can be routed or immediately routes the memo to the next server in the routing topology if the servers are constantly connected. The memo is routed immediately, regardless of the replication schedule.
[PriorityNormal]— Instructs the mail server to route the message by using the replication schedule. If the recipient is located in the same Notes Named Network as the sender, the message is routed immediately.
[PriorityLow]— Instructs the mail server to route the message overnight, during nonpeak hours. However, if the recipient is located in the same Notes Named Network as the sender, the message is routed immediately.
[ReturnReceipt]— Automatically sends a memo to the original sender of the document when the recipient reads the document.
[DeliveryReportConfirmed]— Automatically sends a memo to the original sender of the document informing the sender that the attempted delivery was successful or unsuccessful. If this parameter is not used, the default action of Domino is to notify the sender only if the document cannot be delivered (causing a delivery failure).
If the @MailSend is scripted without inclusion of the recipient arguments, the document is sent to the values specified in the SendTo field within the document. This function can be used in
Form and view actions
Agents
Fields
Buttons
Smart icons
 | @MailSend cannot be used in views (column or selection formulas), hide-when formulas, window title formulas, or form formulas. |