CardDAVClients - Revision history

Martin.schneider at 12:53, 9 April 2020

2020-04-09T12:53:43Z

← Older revision		Revision as of 12:53, 9 April 2020
Line 1:		Line 1:
			This article is valid until the version 7.10.2 of the Open Xchange Server. For newer versions please visit https://documentation.open-xchange.com/develop/middleware/miscellaneous/caldav_carddav/carddav_clients.html

	= Open-Xchange Contacts synchronization with CardDAV =		= Open-Xchange Contacts synchronization with CardDAV =

Thomas.siedentopf: /* Mac OS X Contacts */

2015-11-25T15:14:34Z

Mac OS X Contacts

← Older revision		Revision as of 15:14, 25 November 2015
Line 13:		Line 13:
	* In the "User name" field enter your username		* In the "User name" field enter your username
	* In the "Password" field enter your password		* 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~~")'''.		* In the "Server address" field enter your server address '''usually with the prefix "dav." (e.g. "dav.myserver.tls")'''.
	* Click "Create"		* Click "Create"
	\|}		\|}

Thomas.siedentopf: /* General Limitations */

2015-11-25T14:09:30Z

General Limitations

← Older revision		Revision as of 14:09, 25 November 2015
Line 40:		Line 40:

	=== 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~~.		=== Client Restrictions ===
			* The Mac Contacts App does not Support CalDAV Collections. Open-Xchange by default recognizes this and exposes an aggregated collection of the CalDAV Collections. As a consequence new contacts entered in subfolders on OX side will not appear in subfolders (or Contact Groups) on the Mac Contacts App but inside of the aggregated Collection itself. Additionally Contact Groups from the Contacts App are not synced to OX - however the Contacts itself will be synced to the OX Address Book. Creating a new Contacts Group from within the Contacts App using the OX CardDAV Account is not possible - the name will revert to “untitled group” and will not be synced to OX App Suite.

Tobias.friedrich: /* Unsupported Properties */

2015-10-19T12:22:04Z

Unsupported Properties

← Older revision		Revision as of 12:22, 19 October 2015
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.

Khgras: /* Mac OS X Contacts */

2015-03-10T19:59:46Z

Mac OS X Contacts

← Older revision		Revision as of 19:59, 10 March 2015
Line 5:		Line 5:
	== Mac OS X Contacts ==		== Mac OS X Contacts ==

	For the Contacts application on Mac OS X 10.~~8 "Mountain Lion"~~ and above, a CardDAV account can be configured as follows:		For the Contacts application on Mac OS X 10.9 (Mavericks) and above, a CardDAV account can be configured as follows:

	{\|		{\|

Tobias.friedrich at 09:32, 30 July 2014

2014-07-30T09:32:08Z

← Older revision		Revision as of 09:32, 30 July 2014
Line 3:		Line 3:
	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.		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 ~~Address Book /~~ Contacts ==		== Mac OS X Contacts ==
	~~''Available since Open-Xchange Server v6.20.1''~~

	~~Depending~~ on ~~the used~~ Mac OS X ~~version~~, ~~slightly different steps are necessary.~~		For the Contacts application on Mac OS X 10.8 "Mountain Lion" and above, a CardDAV account can be configured as follows:

	~~=== Mac OS X Address Book (for version 10.6 Snow Leopard) ===~~
	{\|
	~~\| [[image:carddav-account2.png\|thumb]] \|\| style="width:85%" \|~~
	* Click the "+" sign in Address Book -> Preferences -> Accounts.
	* In the "Account type" field keep "CardDAV" selected
	* In the "User name" field enter your username '''replacing "@" with ""''' (e.g. enter "peter.fraserCONTEXTNAME" if you normally log in to OX with the username "peter.fraser@CONTEXTNAME".)
	* In the "Password" field enter your password
	* In the "Server address" field enter your server address '''with the prefix "dav." and ":443" or ":80" as suffix (e.g. "dav.MYSERVER.TLD:443")'''.<br/> Use '''443''' if you normally type '''https''' in your browser to reach your installation, '''80''' otherwise.
	* Click "Create"
	\|}

	~~=== Mac OS X Address Book (for version 10.7 Lion) / Mac OS X Contacts (for version 10.8 Mountain Lion) ===~~
	{\|		{\|
	\| [[image:carddav-account5.png\|thumb]] \|\| style="width:85%" \|		\| [[image:carddav-account5.png\|thumb]] \|\| style="width:85%" \|
Line 26:		Line 13:
	* In the "User name" field enter your username		* In the "User name" field enter your username
	* In the "Password" field enter your password		* In the "Password" field enter your password
	* In the "Server address" field enter your server address '''with the prefix "dav." (e.g. "dav.MYSERVER.TLD")'''.		* In the "Server address" field enter your server address '''usually with the prefix "dav." (e.g. "dav.MYSERVER.TLD")'''.
	* Click "Create"		* Click "Create"
	\|}		\|}

	~~=== Debug Options ===~~
	You can enable a Debug Menu inside the Address Book application which gives you access to advanced debugging and logging options. Please notice that some of these options may increase the size of the log files of your system and/or could also log sensitive data like passwords if enabled. Keep also in mind that any setting changed here will remain active until the setting itself will be reverted or changed again which means that disabling the Debug Menu itself is not sufficient to reset any debug settings to their defaults. All settings are case sensitive.

	~~Open a terminal window (Applications > Utilities > Terminal) and issue the following command for~~
	* enabling the Debug Menu in the AddressBook:
	~~defaults write com.apple.AddressBook ABShowDebugMenu -bool true~~
	* disabling the Debug Menu in the AddressBook:
	~~defaults write com.apple.AddressBook ABShowDebugMenu -bool false~~

	~~'''PLEASE NOTE:''': The debug menu is not available in Mac OS X 10.8.~~


	== iOS Contacts ==		== iOS Contacts ==

Antje: /* Unsupported Special Chars */

2014-05-09T11:56:18Z

Unsupported Special Chars

← Older revision		Revision as of 11:56, 9 May 2014
Line 66:		Line 66:
	=== 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.

Antje: /* Unsupported Special Chars */

2014-05-09T11:39:35Z

Unsupported Special Chars

← Older revision		Revision as of 11:39, 9 May 2014
Line 66:		Line 66:
	=== 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.		* The special char "\" in contact names is not supported. It will lead to an "HTTP/1.1 404 Not Found" error in webdav.

Antje: /* Unsupported Properties */

2014-05-09T11:37:23Z

Unsupported Properties

← Older revision		Revision as of 11:37, 9 May 2014
Line 62:		Line 62:
	* 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 ===

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

Khgras: /* iOS Contacts */

2013-12-02T12:54:36Z

iOS Contacts

← Older revision		Revision as of 12:54, 2 December 2013
Line 54:		Line 54:
	* Click "Next"		* Click "Next"
	\|}		\|}

	~~'''PLEASE NOTE:''' For our product Open-Xchange Advanced Server Edition and Server Edition for UCS it isn't necessary to use "dav".~~


	== General Limitations ==		== General Limitations ==