描述

创建、删除、修改、取得和回应Microsoft Exchange日历事件，取得日历事件附件。

语法

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

delete 
<cfexchangecalendar
    required 
    action = "delete"
    uid = "event UID,event UID, ..."
    optional 
    connection = "connection ID"
    message = "string"
    notify = "yes|no">

deleteAttachments 
<cfexchangecalendar
    required 
    action = "deleteAttachments"
    uid = "event UID"
    optional 
    connection = "connection ID">

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

getAttachments 
<cfexchangecalendar
    required 
    action = "getAttachments"
    name = "query identifier"
    uid = "event UID"
    optional 
    attachmentPath = "directory path"
    connection = "connection ID">
    generateUniqueFilenames = "no|yes"

modify
<cfexchangecalendar
    required 
    action = "modify"
    event = "#event information structure#"
    uid = "event UID"
    optional 
    connection = "connection ID">

respond
<cfexchangecalendar
    required 
    action = "respond"
    responseType = "accept|decline|tentative"
    uid = "event UID"
    optional 
    connection = "connection ID"
    message = "string">
    notify = "yes|no">

属性

使用方法

该 cfexchangecalendar标签在Exchange服务器上控制日历事件。使用cfexchangecalendar 可以做以下运行：

• 创建一个任命或者会议事件。你可以创建全天的事件。
• 删除一个或者多个事件。
• （Get one or more events that conform to an optional set of filter specifications, such as the subject, sender or recipient ID, time received, and so on. ）取得一个或者多个符合可选的过滤规格的事件，比如说subject, sender 或者recipient ID, time received等等。
• Get the attachments for a specific event.为一个指定的事件取得附件。
• 修改一个现存的事件。
• 回应一个事件。

使用这个标签，你必须连接上一个 Exchange 服务器。如果你正在使用多个标签与 Exchange 服务器互动,比如说你正在创建一些联系记录，你可以使用cfexchangeconnection标签来创建一个永久连接。然后在每一个cfexchangecalendar标签里指定连接标识符，或是 在任意的其他ColdFusion Exchange 标签里指定。（如果你也存取任务， contacts, 或是 mail.） 这样做，为每一个标签 消除了间接的创建，关闭了连接。（Doing this eliminates the overhead of creating and closing the connection for each tag. ）

反过来说，你可以创建一个临时的连接，这个连接只持续在ColdFusion 运行单个cfexchangecalendar标签的时候。（lasts only for the time that ColdFusion processes the single cfexchangecalendar tag. ）这样做的话，就在cfexchangecontact标签里直接指定了连接属性。更多连接属性的信息，请看 cfexchangeconnection  标签。

The create action创建

当你指定了创建的动作的时候，该事件属性必须包含了一个确认了事件信息的结构。这个结构可以有以下内容：

下面的表格罗列了如果设置IsRecurring field 为yes的时候，你用来指定事件复发的元素。如何指定事件复发的细节，请看 ColdFusion Developer's Guide的"Specifying Calendar recurrence"

The delete action删除的动作

当你指定了删除了动作，你就必须指定一个uid 属性，该属性带有一个用逗号隔开的清单，清单里是一个或者更多的指定了删除的事件的Exchange UID。使用这个取得的动作，可以用一个 带有适当的过滤设置的表达式，来定义UID 值去指定。（Use the get action, with an appropriate filter expression, to determine the UID values to specify.）

如果所有你指定的UID都是无效的，cfexchangecalendar 标签就会产生一个错误。如果至少一个UID 是有效的，这个标签就会忽略所有无效的 UID并通过有效UID删除指定的项目。

The get action取得的动作

当你指定了取得的动作，可以使用child cfexchangefilter 标签来指定取得的信息。更多过滤器的信息，请看 cfexchangefilter。

当这个标签完成运行之后，该 query 对象就会通过包含了每一个retrieved信息的name属性来指定。每一个记录都有如下的栏目：

下面的表格描述了 From, HtmlMessage, Message, 和 UID fields.。关于其他 field的更多细节，请看创建动作的描述清单。

The getAttachments action

当你使用 getAttachments action用的时候,你必须指定一个单独的 UID 和一个名字属性。cfexchangecalendar标签填充了一个带有指定名字的 query 对象。每一个记录都有下面的关于一个用UID之能够的事件的属性信息。（. Each record has the following information about an attachment to the event specified by the UID:）

这个标签把目录放置在附件里，该目录是用attachmentPath属性来指定的。如果你忽略了 attachmentPath 属性，ColdFusion就不会取得任何的附件，它取得是附件的信息。它让你能够定义事件的属性，而不会导致取得附件文件的架空。（without incurring the overhead of getting the attachment files.）

The modify action修改的动作

当你指定了修改的动作的时候，你可以通过指定一个带有单个事件UID的uid属性选择事件来修改；多个UID是不允许的。你只能用改变中的fields来填充事件结构。更多fields的细节描述和他们的有效值，请看创建多的清单。

如果一个事件有附件，当你修改事件的时候指定了附件，新的附件就会被添加到预先的附件里。他们不会置换他们。你必须使用 deleteAttachments action 来删除任何的附件。

The respond action回应动作

你可以使用cfexchangemail标签来做一个回应的动作，回应收到的会议通知。一个会议不会出现在你的日历里，也不能用cfexchangecalendar标签来浏览，直到你回应了mail信息并接受或者暂定接受请求的时候才可以浏览。

当你要做一个回应的动作，你必须从通知的mail信息，指定你要回应的事件的 UID。你同时还要指定回应的类型；那就是，是否你接受，驳回，或者暂定接受这个事件。你可以选择性地指定一个信息来包含回应，还可以设置一个flag 是否通知你回应的事件的创建者。（ You can optionally specify a message to include in the response and set a flag whether to notify the creator of the event of your response. ）

更多使用回应动作的细节信息，请看ColdFusion Developer's Guide的 "Working with meeting notices and requests"

范例

下面的例子让你创建，然后修改了一个日历事件。当你第一次提交 form的时候, ColdFusion 创建了日历事件，重新显示了带有你登陆的数据的 form。你应该在你修改form和重新提交之前接受事件。当你第二次提交form 的时候, ColdFusion会 发送修改的信息。更多内容，请看 ColdFusion Developer's Guide.的 "Working with meetings and appointments"

这个例子重新发送了所有的事件数据（为限制例子的长度），但是你可以改写这个例子这样的话它就只发送修改过的数据了。（This example resends all the event data (to limit the example length), but you could change the example so that it only sends modified data.）

<!--- Create a structure to hold the event information. --->
<!--- A self-submitting form for the event information --->
<!--- This example omits recurrence to keep the code relatively simple --->
<cfparam name="form.eventID" default="0">

<!--- If the form was submitted, populate the event structure from it. --->
<cfif isDefined("Form.Submit")>
        <cfscript>
        sEvent.AllDayEvent="no";
        sEvent=StructNew();
        sEvent.Subject=Form.subject;
        if (IsDefined("Form.allDay")) {
            sEvent.AllDayEvent="yes";
            sEvent.StartTime=createDateTime(Year(Form.date), Month(Form.date),
                Day(Form.date), 8, 0, 0);
        }
        else {
            sEvent.StartTime=createDateTime(Year(Form.date), Month(Form.date),
                Day(Form.date), Hour(Form.startTime), Minute(Form.startTime), 0);
            sEvent.EndTime=createDateTime(Year(Form.date), Month(Form.date),
                Day(Form.date), Hour(Form.endTime), Minute(Form.endTime), 0);
        }
        sEvent.Location=Form.location;
        sEvent.RequiredAttendees=Form.requiredAttendees;
        sEvent.OptionalAttendees=Form.optionalAttendees;
        //sEvent.Resources=Form.resources;
        if (Form.reminder NEQ "") {
            sEvent.Reminder=Form.reminder;
        }
        else {
            sEvent.Reminder=0;
        }
        sEvent.Importance=Form.importance;
        sEvent.Sensitivity=Form.sensitivity;
        sEvent.message=Form.Message;
    </cfscript>
    
    <!--- If this is the first time the form is being submitted 
            Create a new event. --->
    <cfif form.eventID EQ 0>
    <!--- Create the event in Exchange --->
        <cfexchangecalendar action="create" 
            username ="#user1#"
            password="#password1#"
            server="#exchangeServerIP#"
            event="#sEvent#"
            result="theUID">
        <!--- Output the UID of the new event. --->    
        <cfif isDefined("theUID")>        
            <cfoutput>Event Added. UID is#theUID#</cfoutput>
            <cfset Form.eventID = theUID >
        </cfif>
    <cfelse>         
    <!--- The form is being resubmitted with new data, so update the event. --->    
        <cfexchangecalendar action="modify" 
            username ="#user1#"
            password="#password1#"
            server="#exchangeServerIP#"
            event="#sEvent#"
            uid="#Form.eventID#">
        <cfoutput>Event ID #Form.eventID# Updated.</cfoutput>

    </cfif>
</cfif>

<cfform format="xml" preservedata="yes" style="width:500" height="600">
    <cfinput type="text" label="Subject" name="subject" style="width:435"><br />
    <cfinput type="checkbox" label="All Day Event" name="allDay">
    <cfinput type="datefield" label="Date" name="date" validate="date" style="width:100">
    <cfinput type="text" label="Start Time" name="startTime" validate="time"
        style="width:100">
    <cfinput type="text" label="End Time" name="endTime" validate="time"
        style="width:100"><br />
    <cfinput type="text" label="Location" name="location" style="width:435"><br />
    <cfinput type="text" label="Required Attendees" name="requiredAttendees"
        style="width:435"><br />
    <cfinput type="text" label="Optional Attendees" name="optionalAttendees"
        style="width:435"><br />
    <cfinput type="text" label="Resources" name="resources" style="width:435"><br />
    <cfinput type="text" label="Reminder (minutes)" validate="integer" name="reminder"
        style="width:200">
    <cfselect name="importance" label="Importance" style="width:100">
        <option value="normal">Normal</option>
        <option value="high">High</option>
        <option value="low">Low</option>
    </cfselect> 
    <cfselect name="sensitivity" label="Sensitivity" style="width:100">
        <option value="normal">Normal</option>
        <option value="company-confidential">Confidential</option>
        <option value="personal">Personal</option>
        <option value="private">Private</option>
    </cfselect> 
    <cfinput type="textarea" label="Message" name="message" style="width:435;
        height:100">
    <cfinput type="hidden" name="eventID" value="#Form.EventID#">
    <cfinput type="Submit" name="submit" value="Submit">
</cfform>