ImportICS Method

Imports iCal data (contained in an ICS file) into the component's property list.

Syntax

caldav.importICS(calendarData, [callback])

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for this method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This method is used to load calendar data from an external source into the class. You may then submit this data with a call to PutCalendarEvent. If you edit any of the class properties between importing and calling PutCalendarEvent, the class will re-generate the PUT request itself. If no properties are changed, the imported data will be submitted unaltered when calling PutCalendarEvent.

Note that the CalendarData you wish to import must contain a single VEVENT, VTODO, or VJOURNAL inside of a VCALENDAR. (A VTIMEZONE may be optionally contained inside the VCALENDAR as well). If multiple calendar objects are included in the imported data they will not be parsed correctly into properties, and the server's response to the PutCalendarEvent method is undefined.