CalDAV

Objekty kalendářních zdrojů obsažené v kolekci nesmí obsahovat více než jeden typ komponenty (VEVENT, VTODO, VJOURNAL, atd.), s výjimkou komponenty VTIMEZONE, která je specifikována pro každý jedinečný parametr TZID v objektu iCalendar. Hodnota vlastnosti UID komponenty v kalendářním objektu musí být unikátní v rámci kolekce, ve které je uložena. Pokud existují komponenty se stejnými UID vlastnostmi, značí to komponentu, opakující se v určitém intervalu. Všechny instance opakující se komponenty musí být uloženy v jednom objektu kalendářních zdrojů a zároveň v něm nesmí být komponenta s jinou hodnotou UID vlastnosti. Následuje příklad objektu iCalendar:

BEGIN:VCALENDAR
PRODID:-//Example Corp.//CalDAV Client//EN
VERSION:2.0
BEGIN:VEVENT
UID:[email protected]
SUMMARY:One-off Meeting
DTSTAMP:20041210T183904Z
DTSTART:20041207T120000Z
DTEND:20041207T130000Z
END:VEVENT
BEGIN:VEVENT
UID:[email protected]
SUMMARY:Weekly Meeting
DTSTAMP:20041210T183838Z
DTSTART:20041206T120000Z
DTEND:20041206T130000Z
RRULE:FREQ=WEEKLY
END:VEVENT
END:VCALENDAR

Kalendářní kolekce obsahuje objekty kalendářních zdrojů, které reprezentují komponenty obsažené v rámci kalendáře. Může být vytvořena automaticky při vytvoření účtu nebo pomocí metody MKCALENDAR. Kalendářní kolekce se klientovi jeví WebDAV kolekce definovaní pomocí URL. Kalendářní kolekce musí splňovat následující dvě podmínky:

• Kalendářní kolekce mohou obsahovat pouze objekty kalendářních zdrojů nebo nekalendářní kolekce (to zajišťuje, že se klient nemusí zabývat nekalendářními daty v kalendářní kolekci).
• Kolekce v kalendářní kolekci nesmí obsahovat kalendářní kolekci v jakékoliv hloubce.

Server s podporou kalendářních funkcí musí mít v odpovědi na dotaz s metodou OPTIONS zahrnuto pole „calendar-access“ v DAV hlavičce (pokud je dotaz směřován na zdroj, který podporuje kalendářní vlastnosti, metody, atd.). Odpověď serveru na dotaz klienta s metodou OPTIONS:

HTTP/1.1 200 OK
Allow: OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, COPY, MOVE
Allow: PROPFIND, PROPPATCH, LOCK, UNLOCK, REPORT, ACL
DAV: 1, 2, access-control, calendar-access
Date: Sat, 11 Nov 2006 09:32:12 GMT
Content-Length: 0

Kalendářní kolekce má oproti specifikaci kolekce u standardu WebDAV přidáno několik následujících vlastností, které jsou definovány ve jmenném prostoru urn:ietf:params:xml:ns:caldav. Jsou to: popis kalendáře, časová zóna kalendáře, podporované komponenty, typ kalendářních dat, maximální velikost objektu kalendářních zdrojů (v bajtech), minimální akceptovatelné datum, maximální akceptovatelné datum, maximální počet instancí opakované komponenty, maximální počet vlastností komponenty.

CalDAV server musí podporovat a dodržovat požadavky na standard WebDAV ACL, definovaný RFC 3744, a tím poskytovat rámec pro rozšiřitelnou sadu oprávnění, která mohou být použita na kolekce nebo pouze zdroje v ní obsažené. Díky těmto oprávněním může být klientům omezen přístup ke zdrojům.

Kromě tohoto standardu je protokol CalDAV rozšířen o možnost poskytnout uživatelům (pomocí oprávnění CALDAV:read-free-busy) náhled pouze na obsazený čas v cizím kalendáři, bez zobrazení dalších detailů kalendářních komponent. Oprávnění může být použito na kalendářní kolekce, běžné kolekce nebo objekty kalendářních zdrojů a musí být vnořené do DAV:read oprávnění.

Zaslání dotazu na server s metodou MKCALENDAR vytvoří novou kalendářní kolekci. Při použití metody MKCALENDAR nesmí vytvářená kalendářní kolekce již existovat a umístěna musí být v povolené oblasti. Protože některé úložiště mohou podporovat pro jednoho uživatele pouze jeden kalendář, který je většinou předem vytvořen. Proto je podpora metody MKCALENDAR na serveru pouze doporučena. Pro přehlednost by měl klient používat vlastnost DAV:displayname pro zadání jména kalendáře. Dále je uveden příklad dotazu pro vytvoření kalendářní kolekce:

MKCALENDAR /home/lisa/calendars/events/ HTTP/1.1
Host: cal.example.com
Content-Type: application/xml; charset="utf-8"
Content-Length: xxxx
<?xml version="1.0" encoding="utf-8" ?>
<C:mkcalendar xmlns:D="DAV:"
              xmlns:C="urn:ietf:params:xml:ns:caldav">
  <D:set>
    <D:prop>
      <D:displayname>Lisa's Events</D:displayname>
      <C:calendar-description xml:lang="en">
        Calendar restricted to events.
      </C:calendar-description>
      <C:supported-calendar-component-set>
        <C:comp name="VEVENT"/>
      </C:supported-calendar-component-set>
      <C:calendar-timezone>
        <![CDATA[
        BEGIN:VCALENDAR
        PRODID:-//Example Corp.//CalDAV Client//EN
        VERSION:2.0
        BEGIN:VTIMEZONE
        ...
        specifikace komponenty
        ...
        END:VTIMEZONE
        END:VCALENDAR
        ]]>
      </C:calendar-timezone>
    </D:prop>
  </D:set>
</C:mkcalendar>

Do vytvořených kalendářních kolekcí nahrává klient své objekty kalendářních zdrojů. Při jejich nahrání pomocí metody PUT může být URL zadáno zcela nezávisle na vztahu k obsahujícím datům, avšak dané URL nesmí být již využíváno. Pokud by tomu tak nebylo, nejednalo by se o vytvoření, ale o aktualizaci.

Pro servery není obtížné zajistit, aby měl vytvořený zdroj zatím neexistující URL, ale pro klienta to jednoduchá záležitost není. Musí prozkoumat URL všech zdrojů a uzamknout kalendářní kolekci, aby nedošlo ke kolizi. Až poté si může být klient jist jedinečností URL ve jmenném prostoru. Následuje kód pro vytvoření objektu kalendářních dat:

PUT /home/lisa/calendars/events/qwue23489.ics HTTP/1.1
Host: cal.example.com
Content-Type: text/calendar
Content-Length: xxxx
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Example Corp.//CalDAV Client//EN
BEGIN:VEVENT
UID:[email protected]
DTSTAMP:20060712T182145Z
DTSTART:20060714T170000Z
DTEND:20060715T040000Z
SUMMARY:Bastille Day Party
END:VEVENT
END:VCALENDAR

Vlastnost DAV:getetag, sloužící pro synchronizaci dat, musí být podporována CalDAV serverem a nastavena ve všech objektech kalendářních zdrojů.

Pokud po odeslání PUT dotazu server navrátí hodnotu entity tagu v hlavičce ETag, znamená to, že akce byla správně provedena a klient může hodnotu uložit a dále s ní pracovat. V případě, že je klient schopen provést dotaz PROPFIND na objekt kalendářních zdrojů, může navrácenou hodnotu vlastnosti DAV:gatetag porovnat s hodnotou entity tagu, doručenou v PUT odpovědi. Pokud si jsou obě hodnoty rovny, objekty se v danou chvíli nemusí synchronizovat.

Odpověď serveru na GET požadavek, mířený na objekt kalendářního zdroje, musí také obsahovat ETag hlavičku s aktuální hodnotou. Příklad odpovědi serveru na dotaz PUT:

HTTP/1.1 201 Created
Content-Length: 0
Date: Sat, 11 Nov 2006 09:32:12 GMT
ETag: "123456789-000-111"