Try out our new RRULE tool for creating RRULE compatible strings.

CalDAV Access (RFC 4791)

Abstract

This document defines extensions to the Web Distributed Authoring and Versioning (WebDAV) protocol to specify a standard way of accessing, managing, and sharing calendaring and scheduling information based on the iCalendar format. This document defines the "calendar-access" feature of CalDAV.

Author

C. Daboo, Apple; B. Desruisseaux, Oracle; L. Dusseault, Commercenet; March 2007

9.7.1. CALDAV:comp-filter XML Element

Name

comp-filter

Namespace

urn

Purpose

Specifies search criteria on calendar components.

Description

The CALDAV targeted at the calendar object (i.e., VCALENDAR) or at a specific calendar component type (e.g., VEVENT). The scope of the CALDAV:comp-filter XML element is the calendar object when used as a child of the CALDAV:filter XML element. The scope of the CALDAV:comp-filter XML element is the enclosing calendar component when used as a child of another CALDAV:comp-filter XML element. A CALDAV:comp-filter is said to match if:

* The CALDAV

comp-filter XML element is empty and the calendar object or calendar component type specified by the "name" attribute exists in the current scope;

or

* The CALDAV

comp-filter XML element contains a CALDAV defined XML element and the calendar object or calendar component type specified by the "name" attribute does not exist in the current scope;

or

* The CALDAV

comp-filter XML element contains a CALDAV XML element and at least one recurrence instance in the targeted calendar component is scheduled to overlap the specified time range, and all specified CALDAV:prop-filter and CALDAV:comp-filter child XML elements also match the targeted calendar component;

or

* The CALDAV

comp-filter XML element only contains CALDAV filter and CALDAV:comp-filter child XML elements that all match the targeted calendar component.

Definition

   

   
   name value: a calendar object or calendar component
               type (e.g., VEVENT)

9.7.2. CALDAV:prop-filter XML Element

Name

prop-filter

Namespace

urn

Purpose

Specifies search criteria on calendar properties.

Description

The CALDAV targeted at a specific calendar property (e.g., CATEGORIES) in the scope of the enclosing calendar component. A calendar property is said to match a CALDAV:prop-filter if:

* The CALDAV

prop-filter XML element is empty and a property of the type specified by the "name" attribute exists in the enclosing calendar component;

or

* The CALDAV

prop-filter XML element contains a CALDAV defined XML element and no property of the type specified by the "name" attribute exists in the enclosing calendar component;

or

* The CALDAV

prop-filter XML element contains a CALDAV XML element and the property value overlaps the specified time range, and all specified CALDAV:param-filter child XML elements also match the targeted property;

or

* The CALDAV

prop-filter XML element contains a CALDAV XML element and the property value matches it, and all specified CALDAV:param-filter child XML elements also match the targeted property;

Definition

   

   
   name value: a calendar property name (e.g., ATTENDEE)

9.7.3. CALDAV:param-filter XML Element

Name

param-filter

Namespace

urn

Purpose

Limits the search to specific parameter values.

Description

The CALDAV targeted at a specific calendar property parameter (e.g., PARTSTAT) in the scope of the calendar property on which it is defined. A calendar property parameter is said to match a CALDAV: param-filter if:

* The CALDAV

param-filter XML element is empty and a parameter of the type specified by the "name" attribute exists on the calendar property being examined;

or

* The CALDAV

param-filter XML element contains a CALDAV defined XML element and no parameter of the type specified by the "name" attribute exists on the calendar property being examined;

Definition

   

   
   name value: a property parameter name (e.g., PARTSTAT)

9.7.4. CALDAV:is-not-defined XML Element

Name

is-not-defined

Namespace

urn

Purpose

Specifies that a match should occur if the enclosing component, property, or parameter does not exist.

Description

The CALDAV match occurs if the enclosing component, property, or parameter value specified in a calendaring REPORT request does not exist in the calendar data being tested.

Definition

Page 26 of 29

This document was automatically converted to XHTML using an RFC to HTML converter with the original text document at the Internet Engineering Task Force web site at ietf.org .  The original text document should be referred to if there are any errors or discrepancies found in this document.

Need to test your iCalendar feeds?

The iCalendar Validator provides developers and testers a method to validate their iCalendar feeds, which can take data from either a URL, file or text snippet and compare it against the RFC 5545 specification.  We believe we have one of the best iCalendar validation tools available on the internet. More information about the validator can be found here.