cfexchangefilter

描述

指定过滤器参数，用来控制cfexchangemail, cfexchangecalendar, cfexchangetask, 和 cfexchangecontact的动作，获得结果。

语法

<cfexchangefilter
    name = "filter type"
    value = "filter value">

或者

<cfexchangefilter
    name = "filter type"
    from = "date/time"
    to = "date/time">

注: 你可以在attributeCollection 中指定这个标签的属性，作为一个结构的value,在attributeCollection 中指定结构的名称,并使用这个标签的属性名称作为这个结构的Keys.

属性

属性	必选/可选	描述
name	必选	使用的过滤器的类型
from	可选	过滤器开始使用的日期或者日期加时间的组合范围。不能和值属性一起使用。如果你指定了一个`from`属性，没有一个 `to`属性，该过滤器就会选择所有时间或是在指定的时间或日期之后。该值可以使任何格式的时间和日期，可以被ColdFusion确认就可以，但是对应的值必须是适当的过滤器类型。
to	可选	过滤器使用的时间范围内表示结束的日期或者日期和时间。不能和`value`属性一起使用。如果你指定了一个to给属性，没有指定`from`属性，过滤器就会选择所有的时间或者选择在指定的日期或时间之前。该值可以使任何格式的时间和日期，可以被ColdFusion确认就可以，但是对应的值必须是适当的过滤器类型。
value	可选	所有过滤器中不能确定一个时间或者日期范围的过滤器的值不能和 `from` 以及 `to` 属性一起使用`。` 如果你用一个空的文本指定这个属性，ColdFusion就会产生一个错误。因此，你不能使用空的字符串来寻找空的值。

这个 cfexchangeCalendar标签过滤器可以有以下的命名属性和相关的value, 或者是 to 和 from 这些你用来为过滤器动作指定过滤器参数的属性。

命名属性	规格属性	有效验证属性值
`maxRows`	`值`	一个正整数，指定符合的row最大值返回。默认row的最大值是 100。
`allDayEvent`	`值`	一个Boolean值
`duration`	`值`	分钟的整数部分
`endTime`	`from` `to`	ColdFusion解读为日期-时间值的一个字符串。
`fromID`	`值`	一个Exchange的用户 ID
`hasAttachment`	`值`	一个 Boolean 值.
`importance`	`值`	以下的值之一： `high` `normal` `low`
`isRecurring`	`值`	一个 Boolean 值.
`location`	`值`	一个字符串
`message`	`值`	一个字符串
`optionalAttendees`	`值`	一个用逗号隔开的Exchange用户ID的清单。
`organizer`	`值`	一个字符串，确定了组织者。该值不一定是一个Exchange ID 或者 e-mail 地址。
`requiredAttendees`	`值`	一个用逗号隔开的Exchange用户ID的清单。
`sensitivity`	`值`	以下值之一： `normal` `personal` `private` `confidential`
`startTime`	`from` `to`	一个ColdFusion会读取为日期-时间值的字符串。
`subject`	`值`	一个字符串。
`UID`	`值`	一个区分大小写的Exchange信息 UID，该 UID独特地定义了一个信息。

cfexchangecontact标签过滤器可以有以下的命名属性和相关的 value。和其他标签不同的是，你不用使用 from 或者 to 属性。

命名属性	值属性
`maxRows`	一个正整数，指定符合的row最大值返回。默认row的最大值是 100。
`assistant`	一个字符串
`businessAddress`	一个结构，拥有以下域： Street, City, State, Zip, Country.
`businessFax`	一个字符串
`businessPhoneNumber`	一个字符串
`categories`	一个用逗号隔开的类别清单。过滤器搜索符合清单里所有类别的关联。
`company`	一个字符串
`description`	一个字符串
`displayAs`	一个字符串
`email1`	一个字符串
`email2`	一个字符串
`email3`	一个字符串
`firstName`	一个字符串
`hasAttachment`	一个 Boolean 值.
`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标签过滤器可以有以下命名属性和相关的 value, 或者to 和 from这些你用来为指定动作指定过滤器参数的属性：

命名属性	规格属性	规格属性值
`maxRows`	`值`	一个正整数，指定符合的row最大值返回。默认row的最大值是 100。
`actualWork`	`值`	一个代表小时数的数字。使用小数点的数来表示分钟。
`billingInfo`	`值`	一个字符串
`companies`	`值`	一个字符串
`dateCompleted`	`值`	一个字符串，ColdFusion可以读作一个日期-时间值。
`dueDate`	`from` `to`	一个字符串，ColdFusion可以读作一个日期-时间值。
`mail_ID`	`值`	一个用逗号隔开的 Exchange mail ID清单。如果连接的用户有多个用户的delegate的权力，你想选取用户有限的任务，该过滤器的值是非常有用的。
`message`	`值`	一个字符串
`mileage`	`值`	一个字符串
`percentCompleted`	`值`	一个从0到100之间的数字。
`priority`	`值`	以下的值之一： `high` `normal` `low`
`reminderDate`	`值`	一个字符串，ColdFusion可以读作一个日期-时间值。
`startDate`	`from` `to`	一个字符串，ColdFusion可以读作一个日期-时间值。
`status`	`值`	必须是以下值之一： `NOT_STARTED` `IN_PROGRESS` `COMPLETED` `WAITING` `DEFERRED`
`subject`	`值`	一个字符串
`totalWork`	`值`	一个代表小时数的数字。使用小数来表示分钟。
`UID`	`值`	一个区分大小写的Exchange UID

使用方法

当ColdFusion取得mailcalendar entries, tasks, 或 contacts信息的时候，cfexchangefilter 标签指定了匹配的条件。只有那些匹配指定过滤器条件的entrie会返回给结构，该结构是用parent标签的命名属性指定的。如果过滤器指定了一个带有文本字符串的域，比如说 Message 或者 Subject, ColdFusion就会返回包含了你在value属性里制定的确切的条目。

cfexchangefilter标签必须是一个带有取得的动作属性值的cfexchangecalendar, cfexchangecontact, cfexchangemail, 或者 cfexchangetask标签的子标签。

如果你在一个 ColdFusion exchange 标签里指定了多个cfexchangefilter标签，比如说cfexchangemail，指定的过滤器是累计，选择的记录和cfexchangefilter标签里指定的条件很吻合。如果你用同样的命名标签值指定了多个 cfexchangefilter标签，带有该属性的最后标签指定过滤器的条件。

范例

下面的例子取得的mail 信息是上周发送给一个用户的，所有的 e-mail 地址里都包含adobe.com。终点是为了取得信息，而不是显示数据，这个例子使用了 cfdump标签来展示结果。

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

<cfdump var="#weeksMail#">

Adobe ColdFusion 8

cfexchangefilter

相关资料

帮助资源中心