GNOMEEvolution

[Clients] WebDAV Implementation Notes

• GNOME Evolution
  • External Links
  • Facts
  • Debugging
    • Contacts
      • Details
  • Calendar
    • REPORT Request 1
    • REPORT Request 2
  • Contacts
    • Special vCard Attributes
    • PUT Requests
  • Journal / Memos
  • Tasks

GNOME Evolution

OpenGrouwpare Coils Client Id: 2f398cabd700444ca54e132b20b50aa0

External Links

• Project Home Page

Facts

• Supports the use of "getctag" property to detect changes in collections and thus the need to refresh. Caveat is that is seems to always ask for the property twice, in two (redundant) PROPFIND requests.

Debugging

Contacts

Contacts are managed in WebDAV/CardDAV backend via the evolution-addressbook-factory component. To debug this component make sure Evolution UI and this component are stopped. Then run:

WEBDAV_DEBUG=all /usr/lib/evolution-data-server/evolution-addressbook-factory --keep-running --wait-for-client

Then start the Evolution UI. It will connect to this instance of the component which will log server interactions - and any errors - to standard-out.

Details

• Evolution 3.6.3 Creating A New Contact

Calendar

REPORT Request 1

<C:calendar-query xmlns:C="urn:ietf:params:xml:ns:caldav" xmlns:D="DAV:">
  <D:prop>
    <D:getetag/>
  </D:prop>
  <C:filter>
    <C:comp-filter name="VCALENDAR">
      <C:comp-filter name="VEVENT">
        <C:time-range start="20130311T155329Z" end="20130520T155329Z"/>
      </C:comp-filter>
    </C:comp-filter>
  </C:filter>
</C:calendar-query>

REPORT Request 2

<C:calendar-query xmlns:C="urn:ietf:params:xml:ns:caldav" xmlns:D="DAV:">
  <D:prop>
    <D:getetag/>
  </D:prop>
  <C:filter>
    <C:comp-filter name="VCALENDAR">
      <C:comp-filter name="VEVENT"/>
    </C:comp-filter>
  </C:filter>
</C:calendar-query>

Contacts

Special vCard Attributes

• X-EVOLUTION-FILE-AS
• X-EVOLUTION-MANAGER
• X-EVOLUTION-ASSISTANT
• X-EVOLUTION-SPOUSE
• X-EVOLUTION-BLOG-URL
• X-EVOLUTION-VIDEO-URL

PUT Requests

• Clients likes to send empty attributes.

Example PUT

PUT /dav/Contacts/Favorites/23510.vcf HTTP/1.0
Host: coils.wmmi.net
X-Real-IP: 10.66.1.101
X-Real-Port: 80
X-Forwarded-For: 10.66.1.101
Connection: close
User-Agent: Evolution/3.6.1
If-Match: 23510:9
Content-Type: text/vcard
Authorization: Basic YXdpbGxpYW06ZnJlZDEyMw==
Content-Length: 617

BEGIN:VCARD
VERSION:3.0
TEL;X-EVOLUTION-UI-SLOT=2;TYPE=CELL:mmm.mmm.mmmm
TEL;X-EVOLUTION-UI-SLOT=1;TYPE=HOME,VOICE:111.222.3333
CLASS:PUBLIC
FN:Baggins\, Bilbo
N:Baggins;Bilbo;;;
SOURCE:coils://e26fbb72-8bb2-47c7-b44e-13385053cabc/23510
X-COILS-ACCOUNT:NO
X-EVOLUTION-FILE-AS:Baggins\, Bilbo
X-MOZILLA-HTML:FALSE
URL:
TITLE:
ROLE:
X-EVOLUTION-MANAGER:
X-EVOLUTION-ASSISTANT:
NICKNAME:
X-EVOLUTION-SPOUSE:
NOTE:
X-EVOLUTION-BLOG-URL:
CALURI:
FBURL:
X-EVOLUTION-VIDEO-URL:
EMAIL;X-EVOLUTION-UI-SLOT=1;TYPE=OTHER:bilbo@example.com
EMAIL;X-EVOLUTION-UI-SLOT=3;TYPE=WORK:dude@example.com
END:VCARD

HTTP/1.0 204 Updated
Server: BaseHTTP/0.3 Python/2.7.3
Date: Sun, 02 Dec 2012 13:49:21 GMT
Content-Length: 0

Journal / Memos

Tasks

[Adam Tauno Williams]

A dialog with Evolution 3.8.x to discover available task lists.