User Guide

242 Chapter 2: ColdFusion Tags
charset Optional Character
encoding
selected in
ColdFusion
MX
Administrator
Mail page;
default is
UTF-8
Character encoding of the mail message, including the
headers. The following list includes commonly used values:
• utf-8
• iso-8859-1
• windows-1252
• us-ascii
• shift_jis
• iso-2022-jp
• euc-jp
• euc-kr
• iso-2022-kr
• big5
• hz-gb-2312
• euc-cn
• utf-16
For more information on character encodings, see:
www.w3.org/International/O-charset.html.
type Optional text/plain MIME type of the message. Can be a valid MIME media
type or one of the following:
• text specifies text/plain type
• plain specifies text/plain type
• html specifies text/html type
For a list of all registered MIME media types see
www.iana.org/assignments/media-types/
MIMEAttach Optional Path of file to attach to message. Attached file is MIME-
encoded. ColdFusion attempts to determine the MIME type
of the file; use the cfmailparam tag to send an
attachement and specify the MIME type.
query Optional Name of
cfquery from which to draw data for message(s).
Use this attribute to send more than one message, or to
send query results within a message.
group Optional CurrentRow Query column to use when you group sets of records to
send as a message. For example, to send a set of billing
statements to a customer, group on "
Customer_ID." Case-
sensitive. Eliminates adjacent duplicates when data is
sorted by the specified field.
groupCase
Sensitive
Optional No Boolean. Whether to consider case when using the group
attribute. To group on case-sensitive records, set this
attribute to Yes.
startRow Optional 1 Row in a query to start from.
maxRows Optional Maximum number of messages to send when looping over
a query.
server Optional SMTP server address, or (Enterprise edition only) a
comma-delimited list of server addresses, to use for
sending messages. At least one server must be specified
here or in the ColdFusion MX Administrator. A value here
overrides the Administrator. A value that includes a port
specification overrides the
port attribute. See the Usage
section for details.
Attribute Req/Opt Default Description