cfmail

説明

SMTP サーバーを使用して、オプションでクエリー出力を含む電子メールメッセージを送信します。

カテゴリ

通信タグ、インターネットプロトコルタグ

シンタックス

<cfmail 
    from = "e-mail address" 
    to = "comma-delimited list" 
    bcc = "comma-delimited list" 
    cc = "comma-delimited list" 
    charset = "character encoding" 
    debug = "yes|no" 
    failto = "e-mail address" 
    group = "query column" 
    groupcasesensitive = "yes|no" 
    mailerid = "header id" 
    maxrows = "integer" 
    mimeattach = "path" 
    password = "string" 
    port = "integer" 
    priority = "integer or string priority level" 
    query = "query name" 
    remove = "yes|no" 
    replyto = "e-mail address" 
    server = "SMTP server address" 
    spoolenable = "yes|no" 
    startrow = "query row number" 
    subject = "string" 
    timeout = "number of seconds" 
    type = "mime type" 
    username = "SMTP user ID" 
    useSSL = "yes|no" 
    useTLS = "yes|no" 
    wraptext = "column number" 
    sign = "true|false" 
    keystore = "location of keystore" 
    keystorepassword = "password of keystore" 
    keyalias = "alias of key" 
    keypassword = "password for private key"> 
 
(Optional) Mail message body and/or cfmailparam tags 
 
</cfmail>

関連項目

cfmailparam、cfmailpart、cfpop、cfftp、cfhttp、cfldap、Wrap、『ColdFusion アプリケーションの開発』のSending and Receiving E-MailのUsing ColdFusion with mail servers

履歴

ColdFusion 8.0.1：Remove 属性が追加されました。

ColdFusion 8: priority、useSSL、および useTLS 属性が追加されました。

ColdFusion MX 7:

• cfmail タグの本文に MIME エンコードされたメッセージ全体を埋め込んでマルチパートメールを送信することができなくなりました。代わりに cfmailpart タグを使用してください。

• cfmail タグでは等幅フォントがプロポーショナルフォントと同様にレンダリングされます。この動作変更は ColdFusion 5 からのものです。ColdFusion MX 7 では UTF-8 が使用され、これがメールヘッダに埋め込まれて送信されます (Content-Type: text/plain; charset=UTF-8)。ColdFusion 5 では ISO-8859-1 (Latin 1) が使用されます。この動作を抑制するには、charset="ISO-8859-1" 属性を追加して ColdFusion 5 のデフォルトのエンコードに戻します。また、ColdFusion Administrator の [メール] ページでエンコードを変更することもできます。

ColdFusion MX 6.1:

• charset、failto、replyto、username、password、および wraptext の各属性が新たに追加されました。

• server 属性で複数のメールサーバーを指定できるようになりました。

• ColdFusion Administrator の [メール設定] ページにいくつかの設定オプションが追加されました。

ColdFusion MX: SpoolEnable 属性が追加されました。

ColdFusion 9: メールに電子署名を追加できるようになりました。新規に追加された関連属性は、sign、keystore、keystorepassword、keyalias、keypassword、および remove です。

属性

使用方法

指定したアドレスにメールメッセージを送信します。メールメッセージには、添付ファイルを含めることができます。タグ本文に CFML コードを入れて、メール出力を生成できます。cfmailparam タグと cfmailpart タグは、cfmail タグ本文内でのみ使用できます。

メールメッセージは、シングルまたはマルチパートにできます。マルチパートのメールメッセージを送信する場合は、メッセージの内容をすべて cfmailpart タグ内に入れる必要があります。cfmailpart タグ内にないマルチパートのメッセージテキストは無視されます。

type="text" を設定すると、送信するメッセージ内の空白文字が圧縮される場合があります。この問題を解決するには、ColdFusion Administrator で [サーバーの設定]-[設定] に移動し、[空白抑制の有効化] オプションを選択解除します。

メールアドレスの指定

メールアドレスは、次のどの形式でも指定できます。

メールサーバーの指定

server 属性では、複数のメールサーバーを指定できます。

サーバーごとに、オプションでユーザー名、パスワード、およびポートを指定できます。ここで設定する値は、対応する属性で設定した値よりも優先されます。server 属性は、次の形式で指定します。

[user:password@]server[:port],[user:password@]server[:port],....

たとえば、次の行では、デフォルトのポートを使用し、ユーザーとパスワードを使用しない mail.myco.com というサーバーを指定しています。次に、ユーザー、パスワード、および特定のポートを使用する 2 番目のサーバーを指定しています。

server=mail.myco.com,mail_admin:adm2qzf@mail2.myco.com:24

ColdFusion エンタープライズ版で複数のメールサーバーを指定すると、いずれかのサーバーに接続されるまで、指定した順序で利用可能なサーバーへの接続が試行されます。直前の 60 秒間利用できなかったサーバーには接続は試行されません。

電子署名

メールに電子署名を追加するには、sign、keystore、keystorepassword、keyalias、および keypassword の各属性を次の例に示すように指定します。

<cfmail from="Sender@Company.com" server="sendmail.myCo.com" sign="true" keystore="C:\OpenSSL\bin\hello.jks" keystorepassword="digital" to="Recepient@Company.com" keyalias="crypto" keypassword="signature" subject="Mail with Digital Signature">

送信するすべてのメッセージに電子署名を追加するには、タグに属性を追加するのではなく、ColdFusion Administrator の [サーバーの設定]-[設定] ページで設定を指定します。

タグで属性を指定しない場合は、Administrator 設定が適用されます。また、タグで sign = "true" を設定し、keystore、keystorepassword、keyalias、および keypassword の各属性を指定しない場合は、ColdFusion Administrator を使用して指定したこれらの属性の値が適用されます。

例

<h3>cfmail Example</h3> 
 
<!--- Delete the surrounding comments to use this example. 
 
<cfif IsDefined("form.mailto")> 
    <cfif form.mailto is not "" AND form.mailfrom is not "" AND form.Subject is not ""> 
        <cfmail to = "#form.mailto#" from = "#form.mailFrom#" subject = "#form.subject#"> 
                This message was sent by an automatic mailer built with cfmail: 
                = = = = = = = = = = = = = = = = = = = = = = = = = = = 
                #form.body# 
        </cfmail>     
        <h3>Thank you</h3> 
        <p>Thank you, <cfoutput>#mailfrom#: your message, #subject#, has been sent to 
            #mailto#</cfoutput>.</p> 
    </cfif>     
</cfif> 
<p> 
<form action = "cfmail.cfm" method="POST"> 
    <pre> 
    TO: <input type = "Text" name = "MailTo"> 
    FROM: <input type = "Text" name = "MailFrom"> 
    SUBJECT:     <input type = "Text" name = "Subject"> 
    <hr> 
    MESSAGE BODY: 
    <textarea name ="body" cols="40" rows="5" wrap="virtual"></textarea> 
    </pre> 
    <!--- Establish required fields. ---> 
    <input type = "hidden" name = "MailTo_required" value = "You must enter a recipient"> 
    <input type = "hidden" name = "MailFrom_required" value = "You must enter a sender"> 
    <input type = "hidden" name = "Subject_required" value = "You must enter a subject"> 
    <input type = "hidden" name = "Body_required" value = "You must enter some text"> 
    <p><input type = "Submit" name = ""></p> 
</p> 
</form>