IC/VC 40Hz

IC/VC

IC/VC is an iCalendar/vCard import/export utility for the Newton. It plugs into the regular application framework and allows sending of items from the Names and Dates application in iCalendar or vCard format as well as importing data from the Inbox application. It can also be used to put away packages from the Inbox which have been downloaded via Nitro or NHttpLib.

Version: 2.4.3

Authors: Eckhart Köppen with support from Gavin McKenzie

License: LGPL 2.0

Download: ICVC-2.4.3.sit (NHttpLib is needed as well)

Usage

Export

IC/VC adds a vCard format choice to the Names application and iCalendar and vCalendar format choices to the Dates application. These format options will also show up in applications that are based on the Names and Dates soups, e.g. Dateman.

The iCalendar and vCard format choices are available for any transport that permits sending of text data, including E-Mail and IrOBEX.

Import

Import of received iCalendar, vCalendar and vCard data is possible from the Inbox application when the data has been received by IrOBEX or NHttpLib's Fetch URL transport. Other transports can make use of IC/VC as well if they save the data in body.data slot of an Inbox soup entry and set the body.class slot to '|text/calendar| or '|text/directory|.

Import behaviour is controlled via the preferences panel, accessible from the Inbox application. The preferences specify the action to take when an item to import matches an existing item. Matching is defined as same first and last name for Names and same start date and description for Dates entries. Possible actions are keeping the original and replacing the original entry for Names and Dates. In addition, merging the original and the new entry is possible for Names. This preserves fields with the same values in the original and new data but adds any new fields from the to be imported data. It is further possible to overwrite existing information with new data but keep the rest of the data in a Names entry untouched by chosing the overwrite option.

Automatic Filing

IC/VC can use the CATEGORIES field in iCal and vCard data to file items automatically. Automatic filing is enabled in the preferences. IC/VC will use the first category from the CATEGORIES field as the folder name, other categories are ignored.

Package Import

IC/VC also lets you put away packages downloaded via Nitro or the Fetch URL transport of NHttpLib. Overwriting any already installed package can be controlled via the preferences setting.

iCal Subscription

The IC/VC application is used to subscribe to calendar data in the iCal format. Subscribed calendars are accessed from any web server via HTTP. To subscribe to a calendar, a new subscription item needs to be created in the IC/VC app and at least the URL field needs to be filled in. If the URL is given as a webcal URL, the "webcal://" part of the URL can be replaced with "http://".

IC/VC can file meetings and appointments in different folders which can be used e.g. by DateMan. Filing can either use the CATEGORIES field in the calendar data or items can be filed in the available calendar folders. Subscribed calendars are updated manually via the "Update" menu item in the Action menu. IC/VC can remove existing subscribed meetings before adding new items from the subscribed calendar.

Limitations

The data format and data fields used by the Newton are not completely compatible with vCard and iCalendar. Some fields will not be represented at all, some have a limitation regarding their values.

Character Set

The default character set on the Newton is Unicode (16 bit characters), iCalendar and vCard use however 8 bit characters. IC/VC uses UTF-8 to represent wide characters (i.e. codes above 255), it depends on the receiving application to recognize those.

Exporting vCards

Pagers and anniversary events are not exported.

Importing vCards

The following vCard fields are ignored: NICKNAME, PHOTO, LABEL, MAILER, TZ, GEO, SOUND, UID.

Exporting iCalendar Entries

Location and invitees are not exported. Recurring events are supported, except those that are set to repeat on a specific week in the month or year.

Importing iCalendar Entries

There is only limited support for recurring events. iCalendar allows very complex recurrance rules which the Newton cannot support natively. Also, the ATTENDEE field is ignored. IC/VC does not support VALARM, VTODO, VJOURNAL and VTIMEZONE objects. It honours the alarms setting in Dates for meetings (not all-day events) and adds an alarm according to the preference settings for Dates.

Changes

Version 2.4.3: Workaround for downloading iCal data from .mac (wrong MIME type)

Version 2.4.2: Fixes for multiple URL/IM field, better error handling

Version 2.4.1: Bugfix for distinguishing duplicate calendar entries

Version 2.4: Some internal rewrites, fixed a bug with nested VEVENT/VALARM data

Version 2.3: Improved vCard 3.0 support, minor bug fixes, added TITLE and department support

Version 2.2: Added UTF-8 and Unicode support (again)

Version 2.1: Fixed a number of bugs related to meeting notes

Version 2.0: Added iCal Subscription

Version 1.1: Handle DBAY import

Version 1.0: Added progress views

Files