Support for integration with Microsoft Exchange Server 2010
Adobe ColdFusion can interact with Microsoft Exchange Server 2010 SP1. The enhancements offer support for Microsoft Exchange Web Services (EWS) which brings in efficacy with the following operations:
- Folder operations such as create, modify, or delete.
- Get rooms and roomlist in the exchange organization.
- Information on user availability, that helps effective scheduling.
- Conversation operations such as find conversation details, copy, move, and the status if the conversation is read.
Note: In ColdFusion 9, the protocol support was limited to WEBDAV. |
Note: If you are installing the J2EE configuration of ColdFusion, all JARs in the ews folder (residing in cfusion/lib) have to be present in the system classpath while deploying. |
Note: This release does not support form-based authentication to Microsoft Exchange Server 2010. |
Setting your Microsoft Exchange Server version
At application level
You can specify the Microsoft Exchange Server version at the application level by providing a value for the variable exchangeServerVersion as follows:<cfset this.exchangeserverversion="version">This corresponds to the attribute with the same name in the tag cfapplication.
In cfapplication
A new attribute exchangeServerVersion has been added to cfapplication.
Syntax
<cfapplication name="app_name" exchangeServerVersion="2010"> |
Attribute
Attribute |
Required/Optional |
Default |
Description |
|---|---|---|---|
exchangeServerVersion |
Optional |
2007 |
Specifies the Microsoft Exchange Server version. The values are:
|
Usage
Use this attribute to specify the version of Microsoft Exchange Server that ColdFusion interacts with. You can also set the version in the Application.cfc
At tag level in any of the cfexchange tags
New attribute serverVersion has been added to the following tags:
- cfexchangeconnection
- cfexchangemail
- cfexchangecalendar
- cfexchangetask
- cfexchangecontact
Attribute |
Required/Optional |
Default |
Description |
|---|---|---|---|
serverVersion |
Optional |
2007 |
Specifies the Microsoft Exchange Server version. The values are:
|
New attribute folderID added to cfexchangemail
A new attribute folderID supports the following actions: get, move, and set. This is the case-sensitive Exchange UID value that uniquely identifies the folder.If not specified, folder is used. If either folder or folderID are not specified, the inbox is used as the default folder to perform the operation.
New actions added to the tag cfexchangecalendar
Added the following three actions:
- getUserAvailability: To effectively schedule meetings and find the availability of users.
- getRoomsList: To find the list of rooms in an organization.
- getRooms: To find the list of rooms in a room list.
Modifications to the tag cfexchangecalendar
For all the cfexchangecalendar actions, the value of the attribute uid is as follows:
- If exchangeServerVersion is set to 2003 or 2007: The uid indicates the ID of the appointment in the mailbox of the organizer.
- If exchangeServerVersion is set to 2010: The uid indicates the ID of the received appointment in the mailbox of the attendee.
In the case of interaction with Microsoft Exchange server 2003 or 2007, whenever an appointment is created, the UID of the organizer can be used by the attendee for any operation such as responding, deleting, or getting attachments. In the case of Microsoft Exchange server 2010, the behavior is different. If attendees have to perform appointment-related actions, they have to first search for the appointment in their mailbox and then use the UID of that appointment.