マニュアルキャンセル

cfexchangefilter

検索

最終更新日 : 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 リファレンス
クラウドサービス

説明

cfexchangemail、cfexchangecalendar、cfexchangetask、および cfexchangecontact の get オペレーションのアクションを制御するフィルターパラメーターを指定します。

履歴

ColdFusion（2025 リリース）：
- 変更：
  - カレンダーのフィルタリング：期間、メッセージ、および requiredAttendees によるフィルタリングは、Exchange Online ではサポートされていません。
  - 連絡先のフィルタリング：添付ファイルは連絡先リソースの一部ではなくなったので、hasAttachment フィルタリングはサポートされていません。
  - タスクのフィルタリング：actualWork、billingInfo、companies、mileage、percentageCompleted、および totalWork によるフィルタリングはサポートされていません。
- 偏差：
  - 以前は使用できたフィルターが、Exchange Online では制限されるようになりました。
ColdFusion 8：このタグが追加されました。

カテゴリ

通信タグ

シンタックス

{{{{
}}}} name = "filter type" {{{{
}}}} value = "filter value"> {1} {2} OR {3} {4} <cfexchangefilter <br> name = "filter type" <br> from = "date/time" <br> to = "date/time">

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

属性

属性	必須／オプション	説明
name	必須	使用するフィルターのタイプです。
from	オプション	フィルタ処理に使用する範囲の開始日または開始日時です。 value 属性とともに使用することはできません。 from 属性を指定して to 属性を指定しなかった場合は、指定した日付または時刻以降のすべてのエントリが選択されます。 ColdFusion が認識する任意の日付時刻形式を使用できますが、フィルターのタイプに適した値に対応している必要があります。
to	オプション	フィルタ処理に使用する範囲の終了日または終了日時です。 value 属性とともに使用することはできません。 to 属性を指定して from 属性を指定しなかった場合は、指定した日付または時刻以前のすべてのエントリが選択されます。 ColdFusion が認識する任意の日付時刻形式を使用できますが、フィルターのタイプに適した値に対応している必要があります。
value	オプション	日付や時刻の範囲を指定しないフィルタで使用する値です。 from 属性および to 属性とともに使用することはできません。内容を空にしてこの属性を指定すると、エラーになります。したがって、空の文字列を使用して空の値を検索することはできません。この属性を空の文字列 ("") に設定すると、指定したフィールドが空であるエントリが検索されます。 6.07

cfexchangeCalendar タグのフィルターでは、次の name 属性と value 属性、または to 属性および from 属性を使用することで、特定のアクションのフィルターパラメーターを指定できます。

name 属性	指定属性	指定属性の有効な値
maxRows	value	返す行の最大数を指定する正の整数です。デフォルトの最大行数は 100 です。 -1 を指定すると、一致する行がすべて返されます。
allDayEvent	value	ブール値です。
duration	value	分を示す整数値です。
endTime	from to	ColdFusion が日付時刻値として解釈できる文字列です。
fromID	value	Exchange ユーザー ID です。
hasAttachment	value	ブール値です。
importance	value	次のいずれかの値になります。 high normal low
isRecurring	value	ブール値です。
location	value	文字列です。
message	value	文字列です。
optionalAttendees	value	Exchange ユーザー ID のコンマ区切りリストです。
organizer	value	開催者を示す文字列です。この値は Exchange ID または電子メールアドレスである必要はありません。
requiredAttendees	value	Exchange ユーザー ID のコンマ区切りリストです。
sensitivity	value	次のいずれかの値になります。 normal personal private confidential
startTime	from to	ColdFusion が日付時刻値として解釈できる文字列です。
subject	value	文字列です。
UID	value	各カレンダーエントリを一意に識別する Exchange メッセージ UID です。大文字と小文字は区別されます。

cfexchangecontact タグのフィルターでは、次の name 属性と value 属性を使用できます。他のタグとは異なり、from 属性および to 属性は使用できません。

name 属性	value 属性
maxRows	返す行の最大数を指定する正の整数です。デフォルトの最大行数は 100 です。 -1 を指定すると、一致する行がすべて返されます。
assistant	文字列です。
businessAddress	Street、City、State、Zip、Country の各フィールドを含む構造体です。
businessFax	文字列です。
businessPhoneNumber	文字列です。
categories	カテゴリのカンマ区切りリストです。リスト内のすべてのカテゴリと一致する連絡先が検索されます。
company	文字列です。
説明	文字列です。
displayAs	文字列です。
email1	文字列です。
email2	文字列です。
email3	文字列です。
firstName	文字列です。
hasAttachment	ブール値です。
homeAddress	Street、City、State、Zip、Country の各フィールドを含む構造体です。
homePhoneNumber	文字列です。
jobTitle	文字列です。
lastName	文字列です。
mailingAddressType	次のいずれかの値になります。Home、Business、Other。
manager	文字列です。
middleName	文字列です。
mobilePhoneNumber	文字列です。
nickName	文字列です。
office	文字列です。
otherAddress	Street、City、State、Zip、Country の各フィールドを含む構造体です。
otherPhoneNumber	文字列です。
pager	文字列です。
profession	文字列です。
spouseName	文字列です。
webPage	文字列です。

cfexchangemail タグのフィルターでは、次の name 属性と value 属性、または to 属性および from 属性を使用することで、特定のアクションのフィルターパラメーターを指定できます。

name 属性	指定属性	指定属性の値
maxRows	value	返す行の最大数を指定する正の整数です。デフォルトの最大行数は 100 です。 -1 を指定すると、一致する行がすべて返されます。
bcc	value	Exchange メールアドレスまたは web メールアドレスのコンマ区切りリストです。
cc	value	Exchange メールアドレスまたは web メールアドレスのコンマ区切りリストです。
folder	value	Exchange メールボックスのルートから、検索するフォルダーまでの、スラッシュ区切りのパスです。デフォルトでは、受信トレイの最上位レベルを検索します。 cfexchangemail タグは、指定したフォルダーのみを検索し、サブフォルダーは検索しません。フォルダー名にスラッシュが含まれる場合は、xF8FF エスケープシーケンスを使用して名前のスラッシュ文字を指定します。 get アクションと move アクションの場合は、このフィールドの代わりに cfexchangemail タグの folder 属性を使用できます。ただし、このフィールドは、folder 属性で指定された値よりも優先されます。
fromID	value	Exchange メールアドレスまたは web メールアドレスです。
hasAttachment	value	ブール値です
importance	value	次のいずれかの値になります。 high normal low
isRead	value	ブール値です。
message	value	文字列です。
MessageType	value	次のいずれかの値になります。Mail、Meeting、Meeting_Cancel、Meeting_Request、Meeting_Response、All。この属性を省略した場合は、すべてのタイプのメッセージが取得されます。 Meeting 属性は、Meeting_Cancel、Meeting_Request、および Meeting_Response タイプのメッセージを取得します。
MeetingUID	value	Exchange カレンダーイベントの UID です。大文字と小文字は区別されます。会議 UID は、Meeting_request または Meeting_response メッセージタイプでのみ使用されます。 MessageType フィールドの値として Mail を指定する場合、このフィールドは指定しないでください。
sensitivity	value	次のいずれかの値になります。 normal personal private confidential
subject	value	文字列です。
timeReceived	from to	ColdFusion が日付時刻値として解釈できる文字列です。
timeSent	from to	ColdFusion が日付時刻値として解釈できる文字列です。
toID	value	Exchange メールアドレスまたは web メールアドレスのコンマ区切りリストです。
uid	value	Exchange メッセージの UID です。大文字と小文字は区別されます。

cfexchangetask タグのフィルターでは、次の name 属性と value 属性、または to 属性および from 属性を使用することで、特定のアクションのフィルターパラメーターを指定できます。

name 属性	指定属性	指定属性の値
maxRows	value	返す行の最大数を指定する正の整数です。デフォルトの最大行数は 100 です。 -1 を指定すると、一致する行がすべて返されます。
actualWork	value	時間数を表す数値です。分を指定するには小数を使用します。
billingInfo	value	文字列です。
companies	value	文字列です。
dateCompleted	value	ColdFusion が日付時刻値として解釈できる文字列です。
dueDate	from to	ColdFusion が日付時刻値として解釈できる文字列です。
mail_ID	value	Exchange メール ID のカンマ区切りリストです。このフィルタ値は、接続ユーザーが複数のユーザーにアクセス権を委任していて、その中から特定のユーザーのタスクを選択する場合に便利です。
message	value	文字列です。
mileage	value	文字列です。
percentCompleted	value	0～100 の数値です。
priority	value	次のいずれかの値になります。 high normal low
reminderDate	value	ColdFusion が日付時刻値として解釈できる文字列です。
startDate	from to	ColdFusion が日付時刻値として解釈できる文字列です。
status	value	有効な値は次のとおりです。 NOT_STARTED IN_PROGRESS COMPLETED WAITING DEFERRED
subject	value	文字列です。
totalWork	value	時間数を表す数値です。分を指定するには小数を使用します。
UID	value	Exchange の UID です。大文字と小文字は区別されます。

使用状況

cfexchangefilter タグでは、メールメッセージ、カレンダーエントリ、タスクまたは連絡先を取得するときに使用する条件を指定します。指定したフィルター条件に一致するエントリのみが、親タグの name 属性で指定した構造体に返されます。 Message や Subject などのテキスト文字列を取るフィールドをフィルターで指定すると、value 属性で指定した値と完全に一致する語句を含む項目が返されます。
cfexchangefilter タグは、action 属性の値が get に設定された cfexchangecalendar、cfexchangecontact、cfexchangemail または cfexchangetask タグの子タグである必要があります。cfexchangemail などの ColdFusion exchange タグの本文で複数の cfexchangefilter タグを指定した場合は、指定したフィルターが組み合わされ、すべての cfexchangefilter タグの条件に一致するレコードが選択されます。name 属性の値が同じである cfexchangefilter タグを複数指定した場合は、その属性を持つ最後のタグのフィルター条件が使用されます。

例

次の例では、adobe.com を含むメールアドレスからユーザーに先週送信されたメールメッセージを取得します。この例では、データを表示するのではなく、メッセージの取得に焦点を当てているので、cfdump タグを使用して結果を表示しています。

<cfset endTime = Now()>
<cfset startTime = DateAdd("d","-7", endTime)>
<cfexchangemail action="get" name="weeksMail" server="#exchangeServerIP#" <br> username ="#user1#" password="#password1#">
<cfexchangefilter name="FromID" value="adobe.com">
<cfexchangefilter name="TimeSent" from="#startTime#" to="#endTime#">
</cfexchangemail>

<cfdump var="#weeksMail#">

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

新規ユーザーの場合

cfexchangefilter

説明

履歴

カテゴリ

シンタックス

関連トピック

属性

使用状況

例

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

このページを共有

アドビサポートコミュニティ

サポート