Name
calendar-data
Namespace
urn
Purpose
Specified one of the following
1. A supported media type for calendar object resources when nested in the CALDAV:supported-calendar-data property;
2. The parts of a calendar object resource should be returned by a calendaring report;
3. The content of a calendar object resource in a response to a calendaring report.
Description
When nested in the CALDAV property, the CALDAV:calendar-data XML element specifies a media type supported by the CalDAV server for calendar object resources.
When used in a calendaring REPORT request, the CALDAV:calendar- data XML element specifies which parts of calendar object resources need to be returned in the response. If the CALDAV: calendar-data XML element doesn't contain any CALDAV:comp element, calendar object resources will be returned in their entirety.
Finally, when used in a calendaring REPORT response, the CALDAV: calendar-data XML element specifies the content of a calendar object resource. Given that XML parsers normalize the two- character sequence CRLF (US-ASCII decimal 13 and US-ASCII decimal 10) to a single LF character (US-ASCII decimal 10), the CR character (US-ASCII decimal 13) MAY be omitted in calendar object resources specified in the CALDAV:calendar-data XML element. Furthermore, calendar object resources specified in the CALDAV: calendar-data XML element MAY be invalid per their media type specification if the CALDAV:calendar-data XML element part of the calendaring REPORT request did not specify required properties (e.g., UID, DTSTAMP, etc.), or specified a CALDAV:prop XML element with the "novalue" attribute set to "yes".
Note
The CALDAV and responses inside the DAV:prop XML element as if it were a WebDAV property. However, the CALDAV:calendar-data XML element is not a WebDAV property and, as such, is not returned in PROPFIND responses, nor used in PROPPATCH requests.
Note: The iCalendar data embedded within the CALDAV:calendar-data XML element MUST follow the standard XML character data encoding rules, including use of <, >, & etc. entity encoding or the use of a construct. In the later case, the iCalendar data cannot contain the character sequence "]]>", which is the end delimiter for the CDATA section.
Definition
when nested in the CALDAV:supported-calendar-data property to specify a supported media type for calendar object resources;
when nested in the DAV:prop XML element in a calendaring REPORT request to specify which parts of calendar object resources should be returned in the response;
PCDATA value: iCalendar object
when nested in the DAV:prop XML element in a calendaring REPORT response to specify the content of a returned calendar object resource.
content-type value: a MIME media type version value: a version string
attributes can be used on all three variants of the CALDAV:calendar-data XML element.