描述

创建、删除、修改和取得 Microsoft Exchange 任务，并取得任务的附件。

注: 对于所有的动作，请看 cfexchangeconnection的附加属性，如果你不指定连接的属性的话。

语法

create
<cfexchangetask
    required
    action = "create"
    task = "#task information structure#" 
    optional
    connection = "connection ID"
    result = "variable for event UID">

delete
<cfexchangetask
    required
    action = "delete"
    uid = "task UID,task UID, ..."
    optional
    connection = "connection ID">

deleteAttachments
<cfexchangetask
    required
    action = "deleteAttachments"
    uid = "task UID"
    optional
    connection = "connection ID">

get
<cfexchangetask
    required
    action = "get"
    name = "query identifier"
    optional
    connection = "connection ID">

getAttachments
<cfexchangetask
    required
    action = "getAttachments"
    name = "query identifier"
    uid = "task UID"
    optional
    attachmentPath = "directory path"
    connection = "connection ID">

modify
<cfexchangetask
    required
    action = "modify""
    task = "#task information structure#"
    uid = "task UID">
    optional
    connection = "connection ID">

注: 对于所有的运行来说，如果没有指定连接属性，你需要查看使用的cfexchangeconnection的附加属性。如果你忽略了连接属性，你就必须在cfexchangecalendar标签里指定的cfexchangeconnection标签属性来创建一个临时连接。更多细节，请看 cfexchangeconnection 的“Open”命令。

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

属性

下面的表格提供了关于每个属性的细节信息。它列出了属性的名字，动作 (动作属性值) 给它所要提供、请求或选择、默认的动作，还提供了必要的属性细节描述和有效值。

当你指定了创建或修改动作，任务属性必须指定一个包含了定义的事件的信息的结构。该结构可以有以下域。在设置和改动的时候必须只包含以下域。

用途

cfexchangetask 标签在Exchange服务器上控制任务 的记录。使用 cfexchangetask标签拉力运行以下动作：

• 创建一个任务。
• 删除一个或者多个任务。
• 取得一个或者多个适合过滤器规格的任务记录，比如说 姓, 工作主题, 或是家庭电话号码，等等。
• 取得一个指定任务记录的附件。
• 修改现存的任务

为了使用这个标签，你必须有一个 Exchange 服务器的连接。如果你正在使用的多个标签和 exchange 服务器有互动,比如说如果你在创建一些任务记录, 你应该使用cfexchangeconnection 标签来创建一个永久连接。然后你在每一个cfexchangetask里制定连接标识符，或者是在其他的 ColdFusion Exchange 标签,如果你也登陆了 calendar entries, contacts, 或 mail的话。这样做就为每一个标签避免了创建和关闭连接的负荷。

相对来说,你可以创建一个临时的连接，它只持续用在ColdFusion 运行单个 cfexchangetask 标签的时间。这样做的话，你可以直接在cfexchangetask标签里指定连接属性。更多连接的细节，请看 cfexchangeconnection  标签。

delete

当你指定了删除动作的时候，你必须指定一个带有用逗号隔开的清单的uid属性，该清单里有一个或者多个指定删除的任务的Exchange UID。你可以使用get动作，用一个适当的过滤器表达式，来定义指定的 UID 值。

如果所有你指定的 UID都是有效的，cfexchangetask标签会生成一个错误。如果至少有一个 UID是有效的，该标签就会忽略三哟有无效的UID，并删除用有效的UID指定的items 。

get

当你指定了 get 动作的时候, 被命名属性指定的query对象包含了每一个检索任务的记录。 该 query 对象如果有同样名字的栏目，有被列为任务属性结构的清单的域的数据格式，就有以下的不同：

• query 对象有一个 Boolean HasAttachment 栏目,没有附件栏目。如果 HasAttachment 域值是 yes,可以使用getAttachments 动作来检索附件。
• query对象有一个附加的 UID 栏目，该栏目在Exchange服务器里有为任务的独特的标识符。你可以在指定了请求的任务的 getAttachments, delete, 和 modify 动作的uid属性里使用该值。
• query对象有一个附加的HtmlMessage 栏目。 Message 栏目由一个纯文本版本的任务描述,而且 HtmlMessage 栏目包括了HTML 版本的描述。

你可以使用子标签 cfexchangefilter 来指定信息去取得。更多细节，请看 cfexchangefilter.

getAttachments

当你使用 getAttachments 动作的时候,你必须指定一个单个的UID 和一个命名属性。cfexchangetask 标签声明了一个被带有指定名字的命名属性指定的query对象，每一个记录都有指向被指定的任务的附件的信息记录。

如果你忽略了 attachmentPath 属性, ColdFusion 不会取得任何的附件。它只取得关于附件的信息。这让你定义了事件的附件，而不用导致取得附件文件时造成负荷。

modify

如果你指定了修改动作，这 uid 属性必须指定一个单个Exchange UID。任务结构只需要指定你改动的域。所有你没有指定的域都不会改动。更多任务结构的内容描述，请看属性章节。

如果一个任务有附件，当你修改任务的时候你指定了附件，新的附件就添加给预先的附件，不会覆盖他们。你必须使用 deleteAttachments 动作来移动任何的附件。

范例

这个范例是一个动态连接来创建一个单个的任务：

<!--- Create a structure with the task fields --->
<cfscript>
    stask=StructNew();
    stask.Priority="high";
    stask.Status="Not_Started";
    stask.DueDate="3:00 PM 09/14/2007";
    stask.Subject="My New Task";
    stask.PercentCompleted=0;
    Message="Do this NOW!";
</cfscript>    

<!--- Create the task using a transient connection. --->
<cfexchangetask action="create" 
    username ="#user1#"
    password="#password1#"
    server="#exchangeServerIP#"
    task="#stask#"
    result="theUID">
    
<!--- display the UID to confirm that the action completed. --->
<cfdump var="#theUID#">