CalDAVClients - Revision history

Martin.schneider at 12:52, 9 April 2020

2020-04-09T12:52:56Z

← Older revision		Revision as of 12:52, 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/caldav_clients.html

	= Open-Xchange Calendar synchronization with CalDAV =		= Open-Xchange Calendar synchronization with CalDAV =

Tobias.friedrich at 06:48, 20 October 2016

2016-10-20T06:48:40Z

← Older revision		Revision as of 06:48, 20 October 2016
Line 30:		Line 30:
	* disabling CalDAV HTTP activity logging:		* disabling CalDAV HTTP activity logging:
	defaults write com.apple.iCal LogHTTPActivity -boolean FALSE		defaults write com.apple.iCal LogHTTPActivity -boolean FALSE

			Starting with Mac OS 10.12 ("Sierra"), the log can be retrieved by the log utility from the commandline, e.g. via
			log stream --level=all --process CalendarAgent

			In previous versions, the logs are available in the "console" application.

	'''Pay attention''': If you change these settings it might be needed to kill the CalendarAgent process with <code>killall CalendarAgent</code> just restarting the MacOS calendar application might not be enough. So in case you won't see any additional log output in the syslog, or the additional log output doesn't vanish after switching off these setting, please try killing the CalendarAgent process.		'''Pay attention''': If you change these settings it might be needed to kill the CalendarAgent process with <code>killall CalendarAgent</code> just restarting the MacOS calendar application might not be enough. So in case you won't see any additional log output in the syslog, or the additional log output doesn't vanish after switching off these setting, please try killing the CalendarAgent process.

Tobias.friedrich at 12:59, 14 December 2015

2015-12-14T12:59:10Z

← Older revision		Revision as of 12:59, 14 December 2015
Line 111:		Line 111:
	* On iOS devices, when a custom default alert time is configured via Settings -> Mail, Contacts, Calendars -> Default Alert Times, this setting may also affect appointments you don't participate in. This is a client-specific feature and can't be influenced by the server.		* On iOS devices, when a custom default alert time is configured via Settings -> Mail, Contacts, Calendars -> Default Alert Times, this setting may also affect appointments you don't participate in. This is a client-specific feature and can't be influenced by the server.
	* Due to incompatible handling of reminders in the Mozilla Thunderbird / Lightning client, especially for reminders in recurring appointments, it's recommended to turn off reminders in synchronized calendar folders there (from the context menu of a calendar, select 'Properties' and uncheck 'Show Alarms').		* Due to incompatible handling of reminders in the Mozilla Thunderbird / Lightning client, especially for reminders in recurring appointments, it's recommended to turn off reminders in synchronized calendar folders there (from the context menu of a calendar, select 'Properties' and uncheck 'Show Alarms').

			=== Attachments ===

			Since v7.8.1, the OX server has support for synchronizing appointment attachments via CalDAV. Attachments are included as so-called managed attachments in the iCal data, which are basically ATTACH properties whose value is a link to the attachment's binary data on the server. More details are available at https://datatracker.ietf.org/doc/draft-daboo-caldav-attachments/ .

			Depending on the used client, some specials apply:

			==== Mac OS Calendar ====
			* For appointments with existing attachments, the client sometimes refuses to apply local updates and displays a "Are you sure you want to delete the attachment" warning
			* Occasionally, the client crashes when working with appointments having attachments (due to an uncaught internal error)
			* In recurring appointments, there is no separation between the series itself and possible exceptions, i.e. the client displays a combined view of attachments for both the series itself, as well as those files that are attached to an exception instance
			* The same goes for all attachment-related operations in recurring events, i.e. attachments are added, updated and removed from the main series only, regardless of an exception being selected
			* To offer at least basic support for attachments, the server tries to mimic a CalDAV server not being able to support storing managed attachments on a per-recurrence instance basis (i.e., they can only be added to all instances as a whole), which correlates to the "calendar-managed-attachments-no-recurrence" capability)

			====eM Client====
			* In recurring appointments, the client displays both the attachments of the main series, as well as those from the exception. However, not the other way around, i.e. attachments targeting the exception explicitly don't show up in the main series.
			* Besides displaying both attachments from the series as well as those from exception occurrences, the client also indicates all those attachments again when editing an exception again. Therefore, such attachments that already exist in the main series are skipped implicitly when importing the updated appointment again.


	=== Unsupported Properties ===		=== Unsupported Properties ===
	* Generally, only those appointment and task 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 appointment and task properties that are also available on the Open-Xchange server are used for synchronization, i.e. all unsupported properties are ignored and not saved.
	* The "URL" property for iCal resources is not supported by the OX server and is discarded.		* The "URL" property for iCal resources is not supported by the OX server and is discarded.
	* Importing or exporting file attachments (property "ATTACH") is not supported via the CalDAV interface.		* Importing or exporting file attachments (property "ATTACH") is not supported via the CalDAV interface prior v7.8.1.

	=== Private Appointments ===		=== Private Appointments ===

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

2015-11-25T15:08:43Z

Mac OS X Calendar

← Older revision		Revision as of 15:08, 25 November 2015
Line 9:		Line 9:
	{\|		{\|
	\| [[image:caldav-account4.png\|thumb]] \|\| style="width:85%"\|		\| [[image:caldav-account4.png\|thumb]] \|\| style="width:85%"\|
	* ~~Click the~~ "+" ~~sign in iCal~~ -> ~~Preferences~~ -~~> Accounts~~		* Choose "Calendar" -> "Add Account..." from the Calendar App main Menu
	* As "Account ~~type~~" ~~select~~ "~~CalDAV~~"		* In the "Choose Calendar Account Provider..." Menu choose "Other CalDAV-Account..."
			* In the "Add a CalDAV Account" Menu choose "Account Type" "Manual"
	* 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." ~~and a slash as suffix~~ (e.g. "dav.~~MYSERVER~~.~~TLD/~~")'''		* In the "Server address" field enter your server address '''with the prefix "dav." (e.g. "dav.myserver.tld")'''.
	* Click "~~Create"~~		* Click "Sign In"
	* Click "Continue"
	\|}		\|}

Dennis Sieben: /* Debug Options */

2015-11-09T14:44:25Z

Debug Options

← Older revision		Revision as of 14:44, 9 November 2015
Line 31:		Line 31:
	defaults write com.apple.iCal LogHTTPActivity -boolean FALSE		defaults write com.apple.iCal LogHTTPActivity -boolean FALSE

			'''Pay attention''': If you change these settings it might be needed to kill the CalendarAgent process with <code>killall CalendarAgent</code> just restarting the MacOS calendar application might not be enough. So in case you won't see any additional log output in the syslog, or the additional log output doesn't vanish after switching off these setting, please try killing the CalendarAgent process.

	== iOS Calendar ==		== iOS Calendar ==

Tobias.friedrich at 09:56, 16 June 2015

2015-06-16T09:56:35Z

@@ Line 17: / Line 17: @@
 * Click "Continue"
 |}
 == iOS Calendar ==

Khgras at 20:01, 10 March 2015

2015-03-10T20:01:35Z

← Older revision		Revision as of 20:01, 10 March 2015
Line 5:		Line 5:
	== Mac OS X Calendar ==		== Mac OS X Calendar ==

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

	{\|		{\|

Tobias.friedrich at 09:30, 30 July 2014

2014-07-30T09:30:44Z

← Older revision		Revision as of 09:30, 30 July 2014
Line 3:		Line 3:
	This site describes how the Open-Xchange server can be accessed via its CalDAV 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 CalDAV 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 ~~iCal /~~ Calendar ==		== Mac OS X Calendar ==

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

	~~=== Mac OS X iCal (for version 10.6 Snow Leopard) ===~~
	{\|
	~~\| [[image:caldav-account3.png\|thumb]] \|\| style="width:85%"\|~~
	* Click the "+" sign in iCal -> Preferences -> Accounts
	* As "Account type" select "CalDAV"
	* In the "User name" field enter your username
	* 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") '''
	* Click "Create"
	* Click "Continue"
	\|}

	~~=== Mac OS X iCal (for version 10.7 Lion) / Mac OS X Calendar (for version 10.8 Mountain Lion and 10.9 Mavericks) ===~~
	{\|		{\|
	\| [[image:caldav-account4.png\|thumb]] \|\| style="width:85%"\|		\| [[image:caldav-account4.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." and a slash as suffix (e.g. "dav.MYSERVER.TLD/")'''		* In the "Server address" field enter your server address '''usually with the prefix "dav." and a slash as suffix (e.g. "dav.MYSERVER.TLD/")'''
	* Click "Create"		* Click "Create"
	* Click "Continue"		* Click "Continue"
	\|}		\|}

	~~=== Debug Options ===~~
	You can enable a Debug Menu inside the iCal 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 iCal:
	~~defaults write com.apple.iCal IncludeDebugMenu 1~~
	* disabling the Debug Menu in iCal:
	~~defaults write com.apple.iCal IncludeDebugMenu 0~~
	Mac OS X 10.6 Snow Leopard lacks the ability to enable the logging of all CalDAV HTTP activities to the systems log (/var/log/system.log) via a Debug Menu option in iCal. To enable this in Mac OS X 10.6 iCal proceed as follows:
	* enabling CalDAV HTTP activity logging in Mac OS X 10.6:
	~~defaults write com.apple.iCal LogHTTPActivity yes~~
	* disabling CalDAV HTTP activity logging in Mac OS X 10.6:
	~~defaults write com.apple.iCal LogHTTPActivity no~~

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

	== iOS Calendar ==		== iOS Calendar ==
Line 68:		Line 39:
	* Latest versions of the Mozilla Thunderbird E-Mail client and the Lightning Add-on (check https://addons.mozilla.org/thunderbird/addon/lightning/ and http://www.mozilla.org/thunderbird/ for details)		* Latest versions of the Mozilla Thunderbird E-Mail client and the Lightning Add-on (check https://addons.mozilla.org/thunderbird/addon/lightning/ and http://www.mozilla.org/thunderbird/ for details)
	* In the Mozilla Thunderbird client, an E-Mail account for the user's Open-Xchange mailbox needs to be setup before configuring the CalDAV access		* In the Mozilla Thunderbird client, an E-Mail account for the user's Open-Xchange mailbox needs to be setup before configuring the CalDAV access
	* Starting with Open-Xchange Server v6.22, the process of adding a Calendar may be simplified using the Add-on "CALDAV - Easy calendar configuration" (http://addons.mozilla.org/thunderbird/addon/caldav-easy-calendar-config/), where the available CalDAV URLs are discovered automatically


	=== Discover the CalDAV URL of your Calendar Folders ===		=== Discover the CalDAV URL of your Calendar Folders ===

Tobias.friedrich: /* Tasks */

2014-04-25T13:44:20Z

Tasks

← Older revision		Revision as of 13:44, 25 April 2014
Line 140:		Line 140:
	=== Tasks ===		=== Tasks ===
	* Only simple tasks (no participants, no recurrence) are supported.		* Only simple tasks (no participants, no recurrence) are supported.
			* Only tasks from personal folders (no shared or public folders) are supported.
	* Only the properties "DTSTART", "DUE", "CATEGORIES", "SUMMARY", "PRIORITY", "DESCRIPTION", "VALARM", "STATUS", "PERCENT-COMPLETE" and "COMPLETED" are synchronized, other ones are discarded by the server.		* Only the properties "DTSTART", "DUE", "CATEGORIES", "SUMMARY", "PRIORITY", "DESCRIPTION", "VALARM", "STATUS", "PERCENT-COMPLETE" and "COMPLETED" are synchronized, other ones are discarded by the server.

Khgras: /* iOS Calendar */

2013-12-02T13:46:21Z

iOS Calendar

← Older revision		Revision as of 13:46, 2 December 2013
Line 58:		Line 58:
	* 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".~~

	== Thunderbird/Lightning ==		== Thunderbird/Lightning ==