• How to get detailed information about meeting requests, cancellation notices, and responses to invitations
• How to specify event recurrence

Working with meeting notices and requests

• Sends you a meeting request
• Cancels a meeting in your calendar
• Responds to a meeting request that you sent and tells Exchange to notify you The information provided by the cfexchangemail tag with the get action does not provide detailed information about meeting. It only includes the following meeting-related information:

• The event UID
• The type of message type: a meeting request, response, or cancellation
• If the message is a response to a meeting request, an indication whether the meeting was accepted, declined, or tentatively accepted Also, a meeting request does not appear in your calendar (so you cannot get detailed information about it using the cfexchangecalendar tag) until you accept it. To get detailed information about a meeting message, use the cfexchangemail tag with the getMeetingInfo action. After getting the information, you can take the necessary action, such as using an cfexchangecalendar tag with the response action to accept or decline a meeting request.

Get meeting message details and respond to meeting requests

1. Get the mail messages that contain the meeting notifications by using a cfexchangemail tag with an action attribute value of get and a cfexchangefilterchild tag with the following attributes:
   • A name attribute with a value MessageType
   • A value attribute with a value of Meeting, Meeting_Request, Meeting_Response, or Meeting_Cancel. A value of Meeting gets all meeting notifications. You can use additional cfexchangefilter tags to further limit the messages you get.When the cfexchangemail tag completes processing, the MeetingUID column of the structure specified by the cfexchangemail tag name attribute contains the UIDs of the meetings.
2. For each meeting, get the information about the meeting by using a cfexchangemailtag with the following attributes:
   • An action attribute value of getMeetingInfo.
   • A meetingUID attribute value with the value from the MeetingUID column of the structure specified by the cfexchangemail tag name attribute.
   • (Optional) A mailuid attribute with the UID of the message that contained the meeting notification. Use this attribute to identify a specific message if the Inbox contains multiple messages about a single meeting.
3. Use the information returned in step 2 in application-specific logic to determine the required messages and actions. For example, you could display all meeting requests in a form that lets a user submit a response to each message.
4. To respond to a meeting request, use the cfexchangecalendar tag with an action value of respondand set the following the attributes:
   • Set the uid attribute to the Meeting UID you received in step 2. Do not use the Message UID.
   • Specify a responseType value of accept, decline, or tentative.
   • (Optional) Specify a notify value of true (the default value) or false to control whether the event owner receives a meeting response message.
   • If the owner receives a notification, you can also specify a message attribute with a text message that is included in the response. The following example shows how you can use this process. It displays all meeting invitations in the Inbox and lets the user respond to each request and send a message with the response:

Specifying Calendar recurrence

• Set the IsRecurring field to true.
• Specify a RecurrenceType field value of DAILY, WEELY, MONTHLY, or YEARLY.
• (Optional) Specify one of the following mutually exclusive fields: RecurrenceCount, RecurrenceEndDate, or RecurrenceNoEndDate.
  Note: If you omit all three of these fields, the event is created with no end date, and if you specify a count or end date, the RecurrenceNoEndDate value is automatically false; therefore, Specify a RecurrenceNoEndDate field only if you are changing an existing event with a recurrence count or end date to one with no end date.

• Specify the recurrence details in additional fields that depend on the recurrence type. To change an event recurrence, including to change whether the event recurs, you specify only the fields whose values change. To stop an event from recurring, set the IsRecurring field to false. To convert an event from nonrecurring to recurring, set the IsRecurring field to true and set all the necessary recurrence fields. The following sections describe how to specify each type of recurrence. For detailed descriptions of the fields that you use, see cfexchangecalendar in the CFML Reference.

Specifying daily recurrence

• Define a RecurrenceFrequency field to specify the frequency of the event, in days. To schedule a meeting for every third day, for example, specify RecurrenceFrequency="3".
• Specify RecurEveryWeekDay="true" to specify a meeting that is held five days a week. You cannot use daily recurrence to schedule a single event that occurs a multiple number of times, but only on week days. To schedule such an event, specify a weekly recurrence with multiple recurrence days. The following CFScript code sample sets daily recurrence for every three days and sets the event to occur 20 times:

Specifying weekly recurrence

• Define a RecurrenceFrequency field to specify the frequency of the event, in weeks. If you omit this field, the event occurs every week. To schedule a meeting for every fourth week, for example, specify RecurrenceFrequency="4".
• Specify a RecurrenceDays field with a comma-delimited list of one of more of the following strings: MON, TUE, WED, THUR, FRI, SAT, SUN. If you omit this attribute, the event recurs on the day of the week determined by the startTime field value. The following CFScript code sample sets an event that occurs on Tuesday and Thursday of every other week until December 3, 2007.

Specifying monthly recurrence

• Events that occur on the same date of each scheduled month, for example, on the tenth day of every three months.
• Events that occur on the same week of the month and the same day of the week, for example, on the second thursday of every month, or on the last Friday of every six months. To specify a date-based monthly event, you only specify the recurrence type, and, if the recurrence is not every month, the frequency. ColdFusion schedules the event to occur on the day of the week determined by the startTime field value. To schedule a meeting that occurs on the start date every four months, specify the following recurrence fields:

Specifying yearly recurrence

• Events that occur on the same date of each year, for example, on every August 10.
• Events that occur on a specific day week and month, for example, on the second Thursday of August. To specify a date-based yearly event, you only specify the recurrence type. ColdFusion schedules the event to occur each year on the date determined by the startTime field value. To schedule a meeting that occurs on the start date every year, specify the following recurrence fields:

Example: Setting calendar recurrence