Custom Web Publishing Guide

66 FileMaker Server Advanced Custom Web Publishing Guide
Notes
1 In each of the three forms of the fmxslt:send_email () function, the smtpFields parameter is a URL-encoded
string of any length that contains the address and subject information using the following format, which
is based on RFC 2368, the
mailto URL scheme:
username@host?name1=value1&name2=value2...
where username@host specifies a recipient. The name/value pairs can be specified in any order and are
defined as follows:
1 from=username@host (must appear only once). The from field must be specified.
1 to=username@host. Use this name/value pair for additional recipients.
1 reply-to=username@host (can appear only once)
1 cc=username@host
1 bcc=username@host
1 subject=string (can appear only once)
If the from, reply-to, or subject fields are specified more than once, then the email message is not sent, a
value of
false() is returned by the function, and the appropriate error status code is set.
1 The Web Publishing Engine will check the syntax of all email addresses provided. They must be of the
form:
[e-mail] or "quoted identifier"<[e-mail]>
where tld is any top-level-domain such as com or net. If any of the fields contains an invalid email
address, then the email message is not sent and the appropriate error status code is set.
1 The individual values for the smtpFields parameter, such as the subject, must be a URL-encoded string.
For example, the “
&” character must be specified as “&amp;” and blank spaces must be specified as
“
%20”. The entire string for the smtpFields parameter must be XML-encoded. (See the example at the end
of this section.)
1 For each of these functions, a value of true() is returned if the email message is successfully sent;
otherwise
false() is returned.
1 For English email messages, the Web Publishing Engine uses an initial default text encoding of ISO-
8859-1. You can change this setting by using the Administration Console. See the FileMaker Server
Advanced Web Publishing Installation Guide
.