Custom Web Publishing Guide

Developing FileMaker XSLT stylesheets 61
Sending email messages from the Web Publishing Engine
You can use the Web Publishing Engine to generate email messages, which is useful for custom web solutions.
To have the Web Publishing Engine send an email message, use one of the following three
fmxslt:send_email ()
extension functions in an XSLT stylesheet. You can use these functions to send one or more separate
messages. Because the
fmxslt:send_email () functions are contained in the Web Publishing Engine’s server-side
XSLT stylesheet, a client cannot use the Web Publishing Engine to send unauthorized email messages.
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.
Email extension function
Data type
returned Description
fmxslt:send_email(String smtpFields,
String body)
boolean Sends a plain text email message of any length from the Web
Publishing Engine using the Web Publishing Engine’s
default text encoding for email messages
fmxslt:send_email(String smtpFields,
String
body, String encoding)
boolean Sends a plain text email message of any length using one of
the following text encodings: US-ASCII, ISO-8859-1, ISO-
8859-15, ISO-2022-JP, Shift_JIS, UTF-8. For information
on these encodings, see “Setting text encoding for requests”
on page 52.
fmxslt:send_email(String smtpFields,
String xsltFile, Node xml, boolean
includeImages)
boolean Sends an HTML-based email message using the encoding
that is specified by encoding attribute of the <xsl:output>
element in the stylesheet. If the encoding attribute is not
included in the <xsl:output> element, the Web Publishing
Engine’s default text encoding for email messages is used.