| CFPOP | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 説明
POP メールサーバーから電子メールメッセージの取得や削除を行います。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||
| カテゴリ
インターネットプロトコルタグ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
シンタックス<cfpop server = "servername" port = "port_number" username = "username" password = "password" action = "action" name = "queryname" messageNumber = "number" uid = "number" attachmentPath = "path" timeout = "seconds" maxRows = "number" startRow = "number" generateUniqueFilenames = "yes"、"no" debug = "yes"、"no"> |
||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 関連項目
cfftp、cfhttp、cfldap、cfmail、cfmailparam、SetLocale、『ColdFusion MX 開発ガイド』の第39章の「電子メールの送受信」 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ヒストリ
ColdFusion MX 6.1:
ColdFusion MX: 添付ファイル名のセパレータが変更されました。メッセージに複数の添付ファイルが含まれる場合、カンマが attachments および attachmentfiles クエリーフィールドの名前を区切ります。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 使用方法
cfpop タグは、POP サーバーからメールメッセージを取得し、取得したメッセージを 1 行 1 メッセージで、ColdFusion クエリーオブジェクトに挿入します。または、POP サーバーからメッセージを削除します。
パフォーマンスを最大化するために、2 つの取得オプションを利用できます。メッセージヘッダの情報は、通常は短いため、短時間で転送されます。メッセージテキストおよび添付ファイルは長い場合もあり、処理に時間がかかることもあります。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||
| cfpop クエリー変数
次の表では、cfpop によって返されるクエリーに関する情報を提供する変数について説明します。
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||
| クエリーメッセージヘッダおよび本文の列
次の表は、action = "getHeaderOnly" または "getAll" の場合に返されるメッセージヘッダおよび本文の列のリストです。
メールメッセージに Content-Type が text/plain のパートが含まれる場合は、queryname.textBody 列にパートのメッセージの内容が入ります。メールメッセージに Content-Type が text/HTML のパートが含まれる場合は、queryname.HTMLBody 列にパートのメッセージの内容が入ります。これらのタイプと一致する Content-Type がない場合は、列は空になります。queryname.Body 列には、常に最初に見つかったメッセージ本文が入ります。 queryname.attachments 列には、すべての添付ファイル名を示すタブ区切りのリストが入ります。queryname.attachmentfiles 列には、添付ファイルの場所を示すタブ区切りのリストが入ります。処理が終わったテンポラリファイルを削除するには、cffile タグを使用します。 queryname.date 列のメールメッセージから抽出される日付時刻文字列から ColdFusion の日付時刻オブジェクトを作成するには、次の表のようにします。
cfpop の詳細については、『ColdFusion MX 開発ガイド』の第39章の「電子メールの送受信」 を参照してください。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||
例<!--- この参照専用の例は、cfpop の使用方法を示しています。 --->
<h3>cfpop の例</h3>
<p>cfpop を使用すると、POP3 メールボックス内でメールの取り出しと操作を行うことができます。
この参照専用の例では、メールクライアントの機能を 1 つ作成し、POP3 メールボックスでメールヘッダーを表示
する方法を示します。
<p>これを実行するには、このコードのコメントを削除し、メール操作が有効になっている CF サーバーで実行します。
<!---
<cfif IsDefined("form.server ")>
<!--- サーバー、ユーザー名が空でないことを確認します。 --->
<cfif form.server is not "" and form.username is not "">
<cfpop server = "#form.popserver# " username = #form.username# password = #form.pwd#
action = "getHeaderOnly" name = "GetHeaders ">
<h3> Inbox のメッセージヘッダ</h3>
<p>レコード件数。
<cfoutput>#GetHeaders.recordCount#</cfoutput></p>
<ul>
<cfoutput query = "GetHeaders">
<li>行。#currentRow#:送信者 :#From# -- 題名。#Subject#
</cfoutput>
</ul>
</cfif>
</cfif>
<form action = "cfpop.cfm " method = "post">
<p>メールサーバーを入力してください。
<p><input type = "Text" name = "popserver">
<p>ユーザー名を入力してください。
<p><input type = "Text" name = "username">
<p>パスワードを入力してください。
<p><input type = "password" name = "pwd">
<input type = "Submit" name = "get message headers">
</form>
--->
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||