Specify E-Mail Address
Each e-mail FS file results in a transmission to a single recipient. However it is possible to send CopiaFacts e-mail which appears to each recipient to have been sent to other people also. The basic (manual) method of doing this is to set the variables EMAILTO_LIST or EMAILCC_LIST to with values containing one or more e-mail addresses; these variables can also be set automatically from Job Administration broadcast lists. See the topic Sending E-Mail to Multiple Recipients for more information.
If both this command and a fax or voice phone command is given, then both methods of transmission will be attempted in turn. If $email_options "second" is given, then the e-mail will be tried only if the fax/voice outbound operation fails. Otherwise, the e-mail will be attempted first and only if it fails will the fax/voice operation be tried. This feature would allow an e-mailed WAV file to replace a voice outbound call, or an e-mailed DOC attachment to replace a faxed document converted to faxable TIFF.
The parameter on this command is used as follows:
|address_part||components of a single e-mail address in the format described below|
The supplied address parts are combined on the e-mail 'To:' header, separated by space characters. Double-quote characters have no special significance and are passed to the e-mail header line exactly "as-is". For compatibility with earlier releases, double-quote characters may also be preceded by the macro-expansion character (default `).
|If you use a display-name preceding a <mailbox@domain> address, it must be enclosed in double-quotes if it contains any of the characters ()<>;:,." in the display-name text. If you have e-mail destinations where this is not the case, then you can use the $email_options sanitize keyword to fix this in most cases. However this option does not insert 'escapes' (a preceding \ character) where the syntax requires this, and mail fail to parse the display-name as a result. So embedded " characters in a quoted string must be written as \", even if the double-quote has been expanded from a variable.|
|The use of angle-brackets to enclose the actual address is required if you also supply other text such as a display-name element. The $email_options sanitize keyword will fix this provided that the display-name element is valid, and will also eliminate blank spaces immediately adjacent to the @.|
|Double-quotes in or surrounding the actual e-mail address are accepted but deprecated. If double-quotes surround the whole actual e-mail address, no other address parts must be included (but the $email_options sanitize keyword will normally fix this). Other than this, text enclosed inside double-quotes and inside parentheses is treated as a comment and discarded.|
Unquoted words outside the actual e-mail address which contain characters not in the ASCII character set will be encoded as described in RFC2047.
The default macro-expansion character on all $email... commands is an ASCII grave accent character (`).
Default: none (required command for e-mail)
$email_address "Steve Hersee" <email@example.com>
$email_address <firstname.lastname@example.org> (Steve Hersee)
$email_address "`BCF2" <`BCF1>
$email_address <"steve"@copia.com> ; deprecated
$email_address "email@example.com" ; deprecated
$email_address firstname.lastname@example.org <email@example.com> ; deprecated
See also these examples for sending to CC and BCC recipients.