2.2.2.21 Exception

  • Article

The Exception element is an optional container ([MS-ASDTYPE] section 2.2) element that specifies an exception to the calendar item's recurrence pattern. It is a child element of the Exceptions element (section 2.2.2.22) and is defined as an element in the Calendar namespace.

A command request or response has between zero and 256 Exception child elements per Exceptions element.

The Exception element can have the following child elements. Some of these elements are not supported by certain protocol versions as a child elements of the Exception element. See the details about protocol versions at the end of this section.

  • Deleted (section 2.2.2.16): This element is optional.

  • ExceptionStartTime (section 2.2.2.23): One instance of this element is required.

  • Subject (section 2.2.2.43): This element is optional.

  • StartTime (section 2.2.2.42): This element is optional.

  • EndTime (section 2.2.2.20): This element is optional.

  • airsyncbase:Body (section 2.2.2.7.1): This element is optional.

  • calendar:Body (section 2.2.2.7.2): This element is optional.

  • airsyncbase:Location ([MS-ASAIRS] section 2.2.2.28): This element is optional.

  • calendar:Location (section 2.2.2.27): This element is optional.

  • airsyncbase:Attachments ([MS-ASAIRS] section 2.2.2.8): This element is optional.

  • Categories (section 2.2.2.11): This element is optional.

  • Sensitivity (section 2.2.2.41): This element is optional.

  • BusyStatus (section 2.2.2.9): This element is optional.

  • AllDayEvent (section 2.2.2.1): This element is optional.

  • Reminder (section 2.2.2.38): This element is optional.

  • DtStamp (section 2.2.2.18): This element is optional.

  • UID (section 2.2.2.46): This element is required.

  • airsyncbase:InstanceId ([MS-ASAIRS] section 2.2.2.25): This element is required.

  • MeetingStatus (section 2.2.2.28): This element is optional.

  • Attendees (section 2.2.2.4): This element is optional.

  • AppointmentReplyTime (section 2.2.2.2): This element is optional in command responses. It is not included in command requests.

  • ResponseType (section 2.2.2.40): This element is optional in command responses. It is not included in command requests.

  • OnlineMeetingConfLink (section 2.2.2.33): This element is optional in command responses. It is not included in command requests.

  • OnlineMeetingExternalLink (section 2.2.2.34): This element is optional in command responses. It is not included in command requests.

Protocol Versions

The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.

Protocol version

Element support

2.5

Yes

12.0

Yes

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes

The calendar:Body element and the UID element are supported as a child elements of the Exception element only when protocol version 2.5 is used. The airsyncbase:Body element is used instead of the calendar:Body element with protocol versions 12.0, 12.1, 14.0, 14.1, 16.0 and 16.1.

The following elements are supported as a child elements of the Exception element only when protocol version 14.0, 14.1, 16.0, or 16.1 is used: Attendees, AppointmentReplyTime, and ResponseType.

The following elements are supported as a child elements of the Exception element only when protocol version 14.1, 16.0 or 16.1 is used: OnlineMeetingConfLink and OnlineMeetingExternalLink.

The ExceptionStartTime element is a required child element of the Exception element only when protocol version 2.5, 12.0, 12.1, 14.0, or 14.1 is used.

The InstanceId, airsyncbase:Location, and airsyncbase:Attachments elements are supported as child elements of the Exception element only when protocol version 16.0 or 16.1 is used.