マニュアルキャンセル

cfexchangemail

検索

最終更新日 : 2025年3月31日 | 次にも適用 : ColdFusion

ColdFusion

アプリを開く

CFML リファレンスユーザーガイド
ColdFusion 関数
ColdFusion のタグ
1. ColdFusion タグの概要
2. カテゴリ別の ColdFusion タグ
  1. アプリケーションフレームワークタグ
    1. cfapplication
    2. cfassociate
    3. cferror
    4. cfimport
    5. cfinterface
    6. cflock
    7. CFScript の
    8. cfthread
  2. 通信タグ
  3. データベース操作タグ
  4. データ出力タグ
    1. cfchart
    1. cfchartdata
    2. cfchartseries
    3. cfchartset
    4. cfcol
    5. cfcontent
    6. cfdocument
    7. cfdocumentitem
    8. cfdocumentsection
    9. cfflush
    10. cfheader
    11. cflog
    12. cfoutput
    13. cfpresentation
    14. cfpresentationslide
    15. cfpresenter
    16. cfprocessingdirective
    17. cfprint
    18. cfreport
    19. cfreportparam
    20. cfsilent
    21. cftable
  5. デバッグタグ
    1. cfdump
    2. cftimer
    3. cftrace
  6. 例外処理タグ
    1. cfcatch
    2. cferror
    3. cffinally
    4. cfrethrow
    5. cfthrow
    6. cftry
  7. 拡張タグ
    1. cfchart
    2. cfchartdata
    3. cfchartseries
    4. cfcollection
    5. cfcomponent
    6. cfexecute
    7. cfftp
    8. function
    9. cfindex
    10. cfinterface
    11. cfinvoke
    12. cfinvokeargument
    13. cfobject
    14. cfproperty
    15. cfreport
    16. cfreportparam
    17. cfreturn
    18. cfsearch
    19. cfsharepoint
    20. cfspreadsheet
    21. cfwddx
    22. cfxml
  8. ファイル管理タグ
  9. フロー制御タグ
    1. cfabort
    2. cfbreak
    3. cfcase
    4. cfcontinue
    5. cfdefaultcase
    6. cfelse
    7. cfelseif
    8. cfexecute
    9. cfexit
    10. cfif
    11. cfinclude
    12. cflocation
    13. cfloop
    14. cfrethrow
    15. cfswitch
    16. cfthrow
    17. cftry
  10. フォームタグ
    1. cfapplet
    2. cfcalendar
    3. cffileupload
    4. cfform
    5. cfformgroup
    6. cfformitem
    7. cfgrid
    8. cfgridcolumn
    9. cfgridrow
    10. cfgridupdate
    11. cfinput
    12. cfpdf
    13. cfpdfform
    14. cfpdfformparam
    15. cfpdfparam
    16. cfpdfsubform
    17. cfselect
    18. cfslider
    19. cftextarea
    20. cftree
    21. cftreeitem
  11. インターネットプロトコルタグ
    1. cfajaximport
    2. cfajaxproxy
    3. cfftp
    4. cffeed
    5. cfimap
    6. cfhttp
    7. cfhttpparam
    8. cfldap
    9. cfmail
    10. cfmailparam
    11. cfmailpart
    12. cfpop
    13. cfsprydataset
  12. ページ処理タグ
    1. cfcache
    2. cfcontent
    3. cfflush
    4. cfheader
    5. cfhtmlhead
    6. cfinclude
    7. cfprocessingdirective
    8. cfsetting
    9. cfsilent
  13. セキュリティタグ
  14. 変数操作タグ
    1. cfcookie
    2. cfdump
    3. cfparam
    4. cfregistry
    5. cfsavecontent
    6. cfschedule
    7. cfset
    8. cfsetting
  15. その他のタグ
    1. cfimage
    2. cflog
    3. cfregistry
3. タグ a～b
4. タグ c
5. タグ f
6. タグ g～h
  1. cfgraph
  2. cfgraphdata
  3. cfgrid
  4. cfgridcolumn
  5. cfgridrow
  6. cfgridupdate
  7. cfheader
  8. cfhtmlhead
  9. cfhtmltopdf
  10. cfhtmltopdfitem
  11. cfhttp
  12. cfhttpparam
7. タグ i
  1. cfif
  2. cfimage
  3. cfimap
  4. cfimapfilter
  5. cfimpersonate
  6. cfimport
  7. cfinclude
  8. cfindex
  9. cfinput
  10. cfinsert
  11. cfinterface
  12. cfinvoke
  13. cfinvokeargument
8. タグ j～l
9. タグ m～o
10. タグ p～q
  1. cfparam
  2. cfpdf
  3. cfpdfform
  4. cfpdfformparam
  5. cfpdfparam
  6. cfpdfsubform
  7. cfpod
  8. cfpop
  9. cfpresentation
  10. cfpresentationslide
  11. cfpresenter
  12. cfprint
  13. cfprocessingdirective
  14. cfprocparam
  15. cfprocresult
  16. cfprogressbar
  17. cfproperty
  18. cfquery
  19. cfqueryparam
11. タグ r～s
  1. cfregistry
  2. cfreport
  3. cfreportparam
  4. cfrethrow
  5. cfreturn
  6. cfsavecontent
  7. cfschedule
  8. cfscript
  9. cfsearch
  10. cfselect
  11. cfservlet
  12. cfservletparam
  13. cfset
  14. cfsetting
  15. cfsharepoint
  16. cfsilent
  17. cfslider
  18. cfspreadsheet
  19. cfsprydataset
  20. cfstoredproc
  21. cfswitch
12. タグ t
  1. cftable
  2. cftextarea
  3. cftextinput
  4. cfthread
  5. cfthrow
  6. cftimer
  7. cftooltip
  8. cftrace
  9. cftransaction
  10. cftree
  11. cftreeitem
  12. cftry
13. タグ u～z
  1. cfupdate
  2. cfwddx
  3. cfwebsocket
  4. cfwindow
  5. cfxml
  6. cfzip
  7. cfzipparam
CFML リファレンス
クラウドサービス

説明

メールメッセージと添付ファイルの取得、メッセージの削除、Microsoft Exchange サーバー上のメッセージのプロパティ設定を行います。

履歴

ColdFusion（2025 リリース）：access_token 属性が追加されました。

ColdFusion 10：serverVersion 属性と folderID 属性が追加されました。

ColdFusion 8：このタグが追加されました。

カテゴリ

通信タグ

シンタックス

delete
<cfexchangemail
required
action = "delete"
uid = "message UID,message UID,..."
optional

access_token="token"
connection = "connection ID"
folder = "Exchange folder path">

deleteAttachments
<cfexchangemail required action = "deleteAttachments" uid = "message UID" optional connection = "connection ID">
folder = "Exchange folder path">

get
<cfexchangemail required {{{{{{
}}}}}} action = "get" {{{{{{
}}}}}} name = "query identifier" {{{{{{
}}}}}} optional {{{{{{
}}}}}} connection = "connection ID" {{{{{{
}}}}}} folder = "Exchange folder path"> {16} folderID = "Exchange folder UID" {17} {18} {{{{
}}}} {19} {{{{
}}}} {20} ... {21} {{
}} {22} {23} getAttachments {24} {{
}} required {{
}} action = "getAttachments" {{
}} name = "query identifier" {{
}} uid = "message UID" {{
}} optional {{
}} attachmentPath = "directory path" {{
}} connection = "connection ID" {{
}} folder = "Exchange folder path" {{
}} generateUniqueFilenames = "no|yes"> {25} {26} getMeetingInfo {27} <cfexchangemail required action = "getMeetingInfo" meetingUID = "meeting UID" name = "query identifier" optional connection = "connection ID" mailUID = "message UID"> {28} {29} move {30} <cfexchangemail required action = "move" destinationFolder = "Exchange folder path" optional connection = "connection ID" folder = "Exchange folder path"> {31} folderID = "Exchange folder UID" {32} {33} <cfexchangefilter name = "filter type" value = "filter value"> {34} <cfexchangefilter name = "filter type" value = "filter value"> {35} ... {36} </cfexchangemail> {37} {38} set {39} <cfexchangemail required action = "set" message = "#structure with values to set#"> {40} uid = "message UID"> {41} optional {42} connection = "connection ID" {43} folder = "Exchange folder path"> {44} folderID = "Exchange folder UID"

メモ：connection 属性を省略する場合は、cfexchangemail タグで cfexchangeconnection タグの属性を指定して一時的接続を作成します。この場合、ColdFusion はタグが完了すると接続を閉じます。詳しくは、cfexchangeconnection タグの open アクションを参照してください。

メモ：このタグの属性は attributeCollection 属性で指定でき、その値は構造体になります。 attributeCollection 属性で構造体の名前を指定し、タグの属性名を構造体のキーとして使用します。

属性

メモ：folder や destinationFolder などの属性でフォルダーパスを使用する際に、フォルダー名にスラッシュ

が含まれている場合は、変換で文字がパスの区切り文字として解釈されないように、xF8FF エスケープ文字を使用してフォルダー名を指定します。

属性	アクション	必須／オプション	デフォルト	説明
action	all	必須		実行するアクションです。有効な値は次のとおりです。 delete deleteAttachments get getAttachments getMeetingInfo move set
access_token		オプション		Exchange Online に接続するために必要な、Microsoft Graph API スコープで作成された OAuth アクセストークン。
attachmentPath	getAttachments	オプション		添付ファイルを保存するディレクトリのファイルパスです。指定したディレクトリが存在しない場合は、自動的に作成されます。メモ：この属性を省略すると、添付ファイルは保存されません。相対パスを指定する場合は、GetTempDirectory 関数によって返される ColdFusion テンポラリディレクトリがパスのルートになります。
connection	all	オプション		cfexchangeconnection タグで指定された Exchange サーバーへの接続の名前です。この属性を省略する場合は、cfexchangecalendar タグで cfexchangeconnection タグのオープンアクション属性を指定して一時的接続を作成します。
destinationFolder	move	必須		メールボックスのルートから、メッセージの移動先フォルダーまでの、スラッシュ（/）区切りのパスです。
folder	getMeetingInfo を除くすべて	オプション		メールボックスのルートから、メッセージが存在するフォルダーまでの、スラッシュ（/）区切りのパスです。cfexchangemail タグは、指定したフォルダーのみを検索し、サブフォルダーは検索しません。 get アクションと move アクションの場合、cffexchangefilter 子タグで name="folder" 属性を指定すると、この属性を設定したのと同じことになり、この属性の値よりも優先されます。この属性を省略した場合や、get アクションと move アクションの場合、対応する cfexchangefilter 設定を使用しないと、Exchange はインボックスの上位レベルが検索されます。
folderID	__ get、move、set	オプション		フォルダーを一意に識別する Exchange UID 値です。大文字と小文字は区別されます。指定しない場合は、folder が使用されます。folder または folderID のどちらも指定しない場合は、操作を実行するためのデフォルトのフォルダーとしてインボックスが使用されます。
generateUnique Filenames	getAttachments	オプション	yes	同じ名前の添付ファイルが複数ある場合に、一意のファイル名を生成するかどうかを指定するブール値です。同じ名前を持つ添付ファイルが複数存在し、このオプションが yes の場合、ColdFusion は、競合するファイル名の後ろ（拡張子の前）に番号を付加します。例えば、myfile.txt という名前の添付ファイルが 3 つある場合は、myfile.txt、myfile1.txt、myfile2.txt という名前で保存されます。
mailUID	getMeetingInfo	オプション		会議出席依頼、応答、または中止の通知を含むメールメッセージの UID です。大文字と小文字は区別されます。この属性は、1 つの会議に関連するメッセージが複数ある場合に使用します。
meetingUID	getMeetingInfo	必須		通知を受け取った会議の UID です。大文字と小文字は区別されます。
message	set	必須		設定するプロパティとその値を含む構造体への参照です。この属性はシャープ記号（#）で囲んで指定する必要があります。メッセージ構造体について詳しくは、使用方法を参照してください。
name	getgetAttachmentsget MeetingInfo	必須		返されたメールメッセージ、または添付ファイルや会議に関して取得した情報を格納する ColdFusion クエリー変数の名前です。返されるデータの詳細については、「使用方法」を参照してください。
serverVersion		オプション	2007	Microsoft Exchange Server のバージョンを指定します。有効な値は次のとおりです。 2003 2007 2010 詳細を指定しない場合は、デフォルトで 2007 が使用されます。指定した値は、アプリケーションレベルで指定した値よりも優先されます。
uid	deletegetAttachmentsset	必須		アクションの対象となるメッセージの UID です。大文字と小文字は区別されます。delete アクションの場合は、この属性で UID 値のコンマ区切りリストを指定できます。deleteAttachments、getAttachments、および set アクションの場合は、1 つの UID 値のみを指定できます。

使用状況

cfexchangemail タグを使用すると、cfmail タグでは実行できない Exchange サーバー上のメールに対するアクションを実行できます（メールメッセージの送信、転送、応答を行うには、cfmail タグを使用する必要があります）。次のアクションを実行するには、cfexchangemail タグを使用します。

サーバーからメールメッセージを完全に削除する。
特定のメッセージの添付ファイルを取得する。
件名、送信者 ID、受信者 ID、受信時刻などのフィルタ条件に一致するメッセージを取得する。
特定のメッセージの添付ファイルを取得する。
会議出席依頼や中止通知などの通知を受け取った会議に関する詳細情報を取得する。
フォルダ間でメッセージを移動する (削除済みアイテムフォルダを含む)。
特定のメールメッセージのプロパティを設定する。
このタグを使用するには、Exchange サーバーに接続する必要があります。複数の連絡先レコードを作成する場合のように、Exchange サーバーと対話するタグを複数使用する場合は、cfexchangeconnection タグを使用して継続的接続を作成します。その場合は、個々の cfexchangemail タグで接続識別子を指定します（タスク、連絡先、接続などにもアクセスする場合はその他の ColdFusion Exchange タグでも接続識別子を指定します）。これにより、個々のタグに対して接続を作成して閉じる必要がなくなるので、システムの負荷が減少します。また、ColdFusion が 1 個の cfexchangemail タグを処理する間だけ存続する一時的接続を作成することもできます。その場合は、cfexchangemail タグで接続属性を直接指定します。接続属性について詳しくは、cfexchangeconnection タグを参照してください。

delete アクション

delete アクションはサーバーからメッセージを完全に削除します。Outlook で Shift + Delete キーを押した場合のアクションに相当します。削除済みアイテムフォルダーにメッセージを移動するには、move アクションを使用します。これは、Outlook で Delete キーを押した場合のアクションに相当します。delete アクションを指定する場合は、削除するタスクを識別する Exchange UID のコンマ区切りリストを uid 属性で指定する必要があります。指定する UID 値を確認するには、適切なフィルター式を指定した get アクションを使用します。
cfexchangemail タグで指定した UID がすべて無効な場合はエラーが発生します。 1 つでも有効な UID が含まれる場合は、無効な UID が無視され、有効な UID に対応する項目が削除されます。

get アクション

get アクションを指定する場合は、子の cfexchangefilter タグを使用して取得するメッセージを指定します。詳しくは、cfexchangefilter を参照してください。タグの処理が完了すると、name 属性で指定したクエリオブジェクトに、見つかったメッセージごとのレコードが格納されます。各レコードには次の列があります。

列	説明
BCC	Exchange ユーザー ID または web メールアドレスのコンマ区切りリストです。
CC	Exchange ユーザー ID または web メールアドレスのコンマ区切りリストです。
Folder	Exchange メールボックスのルートから、メッセージが存在するメールフォルダーまでの、スラッシュ区切りのパスです。
FromID	Exchange ユーザー ID または web メールアドレスです。
HasAttachment	メッセージに少なくとも 1 つの添付ファイルがあるかどうかを示すブール値です。
HTMLMessage	HTML 形式のメッセージを含む文字列です。
IsRead	ブール値です。
Message	プレーンテキスト形式のメッセージ内容を含む文字列です。
MessageType	次のいずれかの文字列です。 Mail Meeting_Cancel Meeting_Request Meeting_Response
MeetingResponse	メッセージタイプが Meeting_response の場合、この列には、Accept、Decline、Tentative のいずれかの文字列として応答コードが含まれます。他のメッセージタイプでは、このフィールドは使用されません。
MeetingUID	メッセージタイプが Meeting_Cancel、Meeting_request、または Meeting_response の場合、この列には、このメッセージが送信されたカレンダーイベントの UID が含まれます。リクエストに応答するには、cfexchangecalendar タグでこの値を使用します。Mail メッセージタイプでは、このフィールドは使用されません。
Sensitivity	次のいずれかの文字列です。 public private normal company-confidential
Subject	文字列です。
TimeReceived	ColdFusion の日付時刻オブジェクトです。
TimeSent	Coldfusion の日付時刻オブジェクトです。
ToId	Exchange ユーザー ID または web メール ID のkコンマ区切りリストです。
UID	メッセージの Exchange UID です。

メモ：出席依頼送信者が会議出席依頼メッセージを受信できるのは、その送信者が出席者リストに記載されている場合のみです。

getAttachments アクション

getAttachments アクションを使用する場合は、1 つの UID と name 属性を指定します。 cfexchangecontact タグは、name 属性で指定したクエリオブジェクトに、添付ファイルごとのレコードを格納します。各レコードには、UID で指定した添付ファイルに関する次の情報が含まれます。

列名	説明
attachmentFileName	添付ファイルのファイル名です。
attachmentFilePath	サーバー上の添付ファイルの絶対パスです。 attachmentPath 属性を省略すると、この列には空の文字列が入ります。
CID	添付ファイルの content-ID です。メッセージにイメージを埋め込むために HTML の img タグ内で使用します。
mimeType	添付ファイルの MIME タイプです（text／html など）。
isMessage	添付ファイルがメッセージかどうかを指定するブール値です。
size	添付ファイルのサイズです（単位：バイト）。

添付ファイルは attachmentPath 属性で指定したディレクトリに保存されます。attachmentPath 属性を省略すると、添付ファイル自体は取得されず、添付ファイルに関する情報が取得されます。この方法を使用すると、添付ファイルの取得に伴うオーバーヘッドを発生させることなく、添付ファイルを調べることができます。
1 つのメッセージに同じ名前の添付ファイルが複数ある場合は、generateUniqueFilenames="yes" を指定した場合でも、添付ファイル情報の構造体には重複する元の名前でそれらの添付ファイルがリストされます。generateUniqueFilenames 属性は、ディスク上のファイルの名前に対してのみ適用されます。メモリ内の attachmentPath ディレクトリを指定するには、次のシンタックスを使用します。メモリ内のファイルはディスクに書き込まれないため、一時的データの処理が速くなります。

attachmentpath = “ram:///path”

パスには、ram:///petStore/orders/messageAttachments のように複数のディレクトリを含めることができます。ファイルを指定する前に、パスに含まれるすべてのディレクトリを作成しておく必要があります。メモリ内ファイルの使用方法について詳しくは、ColdFusion アプリケーションの開発の ColdFusion アプリケーションの最適化の「メモリ内ファイルの使用」を参照してください。
getAttachments アクションは、Exchange のサーバー設定で EWS（Exchange Web サービス）の認証が basic に設定されている場合にのみ有効です。IWA (Integrated Windows Authentication) はサポートされていません。

getMeetingInfo アクション

出席依頼や中止通知などの通知メッセージを受け取った会議に関する情報（会議の開始時刻、終了時刻、場所など）を取得するには、getMeetingInfo アクションを使用します。この情報は、get アクションで返される通知メッセージのクエリオブジェクトには直接格納されません。

メモ：公開時点では、以下の情報は getMeetingInfo アクションの動作を完全には反映していません。更新情報について詳しくは、アドビの web サイトで HTML 形式でオンラインで入手できる ColdFusion ドキュメントの cfexchangemail を参照してください。

getMeetingInfo アクションを指定する場合は、会議の UID を meetingUID 属性で指定します。この UID 値は、get アクションで返されるクエリレコードから取得できます。また、通知を含む特定のメッセージの UID を messageUID 属性で指定することもできます。1 つの会議に関して複数のメッセージを受け取った場合は、この属性を使用して 1 つの通知メッセージを選択できます。タグの処理が完了すると、name 属性で指定したクエリオブジェクトに、見つかったメッセージごとのレコードが格納されます。各レコードには次の列があります。

フィールド	説明
AllDayEvent	終日のイベントかどうかを示すブール値です。
Duration	イベントの継続時間です（単位：分）。
EndTime	ColdFusion の ODBC 日付時刻形式で示されるイベントの終了時刻です。
From	会議通知を送信したユーザーのメール ID です。
HasAttachment	そのイベントに添付ファイルがあるかどうかを示すブール値です。
Importance	次のいずれかの値になります。 high normal low
IsRecurring	そのイベントが反復されるかどうかを示すブール値です。
Location	イベントの場所を示す文字列です。
MeetingUID	カレンダー内のイベントの UID です。
Message	イベントに関するメッセージを含む文字列です。
OptionalAttendees	メール ID のコンマ区切りリストです。
Organizer	文字列です。この値は Exchange ID または電子メールアドレスであるとはかぎりません。
Reminder	イベントの何分前にリマインダーメッセージを表示するかを指定します。
RequiredAttendees	メール ID のコンマ区切りリストです。
リソース	Exchange スケジュールリソース（会議室や機材など）のメール ID のコンマ区切りリストです。
Sensitivity	次のいずれかの値になります。 normal company-confidential personal private
StartTime	ODBC 日付時刻形式で示されるイベントの開始時刻です。
Subject	イベントの件名を示す文字列です。
TimeReceived	ODBC 日付時刻形式で示されるメッセージの受信時刻です。
UID	イベント通知を含むメッセージの UID です。

move アクション

フォルダー間でメッセージを移動するには、move アクションを使用します。このアクションを使用すると、削除済みアイテムフォルダーにメッセージを移動できます。これは、Outlook で Delete キーを押した場合のアクションに相当します。 move アクションを指定する場合は、移動先のフォルダーを指定し、必要に応じてメッセージの移動元フォルダーを指定します（デフォルトの移動元フォルダーはインボックスです）。取得するメッセージを指定するには、子の cfexchangefilter タグを使用します。詳しくは、cfexchangefilter を参照してください。

set アクション

set アクションを指定する場合は、message 属性で指定した構造体に、設定するメッセージプロパティを指定するキーと値のペアを格納します。次の表に、キーの名前と有効な値を示します。

キー名	有効な値
IsRead	yes、no
Importance	high、normal、low
Sensitivity	normal、company-confidential、personal、private

例

次の例では、前週に docuser2 から受信した受信トレイ内のメールメッセージに含まれる添付ファイルを取得します。各メッセージの添付ファイルを、固有の名前のディレクトリに格納します。 UID をファイル名として使用することはできません。これは、添付ファイルを含むメッセージごとに、UID には、メッセージの UID、ディレクトリパス、件名、日付、送信元から成るアプリケーションレポートが含まれ、その後にメッセージの添付ファイルを示す表が含まれている可能性があるためです。この表には、添付ファイルの名前、サイズ、MIME タイプが表示されます。

<cfset i=1>

<cfset rightNow = Now()>
<cfset lastWeek = DateAdd("d","-7", rightNow)>

<cfexchangeconnection action="open" username ="#user1#" password="#password1#" server="#exchangeServerIP#" connection="testconn1">

<cfexchangemail action="get" folder="Inbox " name="weeksMail" connection="testconn1">
<cfexchangefilter name="FromID" value="docuser2">
<cfexchangefilter name="TimeSent" from="#lastWeek#" to="#rightNow#">
</cfexchangemail>

<cfloop query="weeksMail">
<cfif weeksmail.HasAttachment>
<cfexchangemail action="getAttachments" connection="testconn1" folder="Inbox/MailTest" uid="#weeksmail.uid#" name="attachData" attachmentPath="C:\temp\cf_files\attachments\msg_#i#" generateUniqueFilenames="yes">
<cfoutput>
Message ID #weeksmail.uid# attachments are in the directory
C:\temp\cf_files\attachments\Msg_#i# 
 
Message information: 
Subject: #weeksmail.Subject# 
Sent: #dateFormat(weeksmail.TimeSent)# 
From: #weeksmail.FromID# 
 
Attachments 
<cftable query="attachData" colheaders="yes">
<cfcol header="File Name" text="#attachmentFilename#">
<cfcol header="Size" text="#size#">
<cfcol header="MIME type" text="#mimeType#">
</cftable>
</cfoutput>
<cfset i++>
</cfif>
</cfloop>
<cfexchangeconnection action="close" connection="testconn1">

ヘルプをすばやく簡単に入手

新規ユーザーの場合