====iCalendar Events====

===Information===

Reads entries from an **iCalendar** file as ARDI events.

iCalendar files (which usually have the file extension //ICS//) are a common format of file used to share and distribute calendar events.

^Driver Info^Detail^
|Driver Type:|**Event**|
|Platforms:|**All**|

===Driver Settings===

^Option^Description^
|URL/Path|The web or file URL to the iCalendar file|
|Format|The format of the file - either **Normal** or **JSON**|
|Update Rate|The number of seconds in between the file being re-downloaded|
|Timezone|The timezone all of the dates in the file are in|

===Notes===

The **Update Rate** parameter controls how often the driver fetches a new version of the file.

When using local, quick-moving update data (ie. production schedules, inspection schedules etc.) this might be '1' or '0', indicating that the file should be re-read every time new events are requested.

However, some iCalendar files are extremely slow to update - such as a list of national public holidays. To avoid sending an large number of queries to a resource that hasn't changed, the driver will 'remember' the last set of events for the given number of seconds.

For example, a setting of 86400 will re-download the calendar once per day.