|
$email_options [FS] |
  
|
|
$email_options [FS] |
|
Specify E-Mail Options
$email_options option [option ...]
This command specifies options for this e-mail item. For further information see the Features section on sending e-mail.
The parameters on this command are used as follows:
| option | one of the following keywords |
| cvfailok | causes the original unconverted image to be sent if a conversion to PDF, JPG or GIF fails. Without this option the transmission fails with error code 125. |
| debug | enables debug messages for the transaction (written to FFTRACE, if it is running), even if FFTRACE is not set to collect all F7EMAIL output. |
| DKIM | enables DKIM signing. An $email_dkim_keyfile command is also required in the same FS file, as well as a $var_def command for the DK_SELECTOR variable. The keyword 'domainkeys' is a synonym for this option. |
| expandattachvars | expands CopiaFacts variables in e-mail attachment files which have content-type text/html. |
| ignmiss | causes missing attachment files to be ignored. Without this setting a missing attachment file will cause an email transmission to fail with error code 150. |
| MAPI | uses MAPI to send the email instead of SMTP. |
| MHTML | indicates that the attachments are images to be embedded in the HTML body text. For more information, see the Features section on sending e-mail. |
| nomacro | indicates that '`' macro-expansion is not to be performed on the headers, body text, alternate body text and text attachments. This option overrides option expandattachvars. |
| noquote | indicates that the headers, body text and alternate body text are not to be scanned for non-ASCII characters and are to be considered encoded 7bit. |
| notimeout | suppresses the error in circumstances when the e-mail data has been completely transmitted, including the final ".", but the remote MTA does not then send an acknowledgement. In this situation the transmission will be considered a success. No other e-mail timeout is affected by this option. |
| percentxx | indicates that in links in body/altbody text and in text/html attachments, the string %60 (by default) will be changed to the e-mail variable-expansion character (`) before variable expansion takes place. This option is needed because most HTML editor software replaces such characters with a percent sign followed by a hexadecimal value. The expansion will recognize only the hexadecimal value of whatever character is defined by the second parameter of $macro_char (default %60 for accent grave `). The operation is performed on http, https and mailto links only. |
| quoted | indicates that the body text and alternate body text files need not be scanned for non-ASCII characters, have already been encoded as quoted-printable, and should be described as such in the Content-Type header. |
| rawbody | places the supplied body text file into the e-mail with no additional formatting. The body text can contain encoded attachments and multipart sections, but all boundaries and content-type parameters are assumed to be already in the file. An alternate body and attachments may not be specified when this option is given. No checking of the contents is done, but CopiaFacts variables are expanded in the normal way unless the nomacro keyword is also present. Your body text file should normally start with Content-Type and Content-Transfer-Encoding headers because these are not added when the rawbody keyword is used. |
| second | all e-mail commands in the FS file will be ignored unless the fax or voice commands also in the same FS file result in a failed transmission. If this option is not given, an FS file containing both e-mail and fax/voice commands will be attempted as a fax or voice outbound operation if the e-mail transmission fails. |
| smimeencrypt | enables S/MIME encryption. An $email_encrypt_keyfile command is also required in the same FS file. The keyfile must contain the public key of the recipient and will be used to encrypt the e-mail transmission. |
| smimesign | enables S/MIME signing. An $email_sign_keyfile command is also required in the same FS file. One of the specified keyfiles must contain a private and public key for the From: address specified, and will be used to sign the e-mail transmission. |
Example:
Email options:
$email_options nomacro ; email commands and text contain no ` macros
S/MIME encryption:
$email_options SMIMEencrypt
$email_encrypt_keyfile steve.cer
$email_address steve@copia.com
...
S/MIME signing:
$email_options SMIMEsign
$email_sign_keyfile steve.pfx;xyzzy
$email_from steve@copia.com
$email_esender steve@copia.com
DKIM signing:
$email_options dkim
$email_dkim_keyfile copia.pem
$email_from steve@copia.com
$email_esender steve@copia.com
Topic url: http://www.copia.com/support/refmanual/index.html?%24email_options.htm