CardDAVClients: Difference between revisions

From Open-Xchange
Line 34: Line 34:


=== Unsupported Properties ===
=== Unsupported Properties ===
* Generally, only those contact properties that are also available on the Open-Xchange server are used for synchronization, i.e. all unsupported properties are ignored and not saved.
* Generally, only those contact properties that are also available on the Open-Xchange server are recognized and transferred into attributes of OX contacts
* Starting with v7.8.0, the original vCard is also preserved, so that other extended or not mapped properties are still available there (see [[AppSuite:VCardMapping]] for details)
* Importing or exporting file attachments (property "ATTACH") is not supported via the CardDAV interface.
* Importing or exporting file attachments (property "ATTACH") is not supported via the CardDAV interface.
* Due to various different handlings of representing distribution list members in vCards, distribution lists are excluded from syncrhonization via CardDAV.
* Due to various different handlings of representing distribution list members in vCards, distribution lists are excluded from syncrhonization via CardDAV.


=== Unsupported Special Chars ===
=== Unsupported Special Chars ===


* The special char "/" in contact names is not supported. It will lead to an "HTTP/1.1 404 Not Found" error in webdav.
* The special char "/" in contact names is not supported. It will lead to an "HTTP/1.1 404 Not Found" error in webdav.

Revision as of 12:22, 19 October 2015

Open-Xchange Contacts synchronization with CardDAV

This site describes how the Open-Xchange server can be accessed via its CardDAV interface after the server has been configured as described in Caldav_carddav_Bundles. Depending on the used client software, different steps are necessary. Other clients may be configured similarly, but are not officially supported.

Mac OS X Contacts

For the Contacts application on Mac OS X 10.9 (Mavericks) and above, a CardDAV account can be configured as follows:

Carddav-account5.png
  • Click the "+" sign in Address Book -> Preferences -> Accounts.
  • In the "Account type" field keep "CardDAV" selected
  • In the "User name" field enter your username
  • In the "Password" field enter your password
  • In the "Server address" field enter your server address usually with the prefix "dav." (e.g. "dav.MYSERVER.TLD").
  • Click "Create"

iOS Contacts

Available since Open-Xchange Server v6.22

The iOS Contacts application on the iPhone, iPod or iPad can be configured as follows.

Ios carddav config.png
  • Open "Settings"
  • Select "Mail, Contacts, Calendars" -> "Add Account..." -> "Other" -> "Add CardDAV Account"
  • Enter the server address, username as password as shown in the screenshot
  • Click "Next"

General Limitations

Please consider the following known limitations for the CardDAV interface:

Unsupported Properties

  • Generally, only those contact properties that are also available on the Open-Xchange server are recognized and transferred into attributes of OX contacts
  • Starting with v7.8.0, the original vCard is also preserved, so that other extended or not mapped properties are still available there (see AppSuite:VCardMapping for details)
  • Importing or exporting file attachments (property "ATTACH") is not supported via the CardDAV interface.
  • Due to various different handlings of representing distribution list members in vCards, distribution lists are excluded from syncrhonization via CardDAV.

Unsupported Special Chars

  • The special char "/" in contact names is not supported. It will lead to an "HTTP/1.1 404 Not Found" error in webdav.