|Trumba Help Center||What’s New | FAQ | Support Forum | Email Support|
Prepare iCal files for import
The iCalendar (a.k.a. .ics) import allows events to be created, updated, or deleted on a Trumba calendar by sending an iCalendar (RFCs 2445 and 2446) format file to the Trumba server through an HTTP PUT operation.
By programmatically uploading iCal files to Trumba Connect, you can update data of existing events without duplication or alteration of other event data. For information about how to upload iCal files into Trumba Connect, see Programmatically upload iCal files.
Basic iCal file that can be uploaded into Trumba Connect
Below is a minimal sample iCal file that can be uploaded to Trumba Connect.
SUMMARY:Happy New Year!
The UID is required in all cases. This allows for existing event data to be modified. It must be unique for new events.
By default, event metadata such as timezone is inherited from the target Trumba calendar. Timezone can optionally be specified at the event level using the appropriate iCal syntax (e.g DTSTART;TZID).
Standard and required iCal fields used by Trumba Connect
The iCal file you publish to Trumba Connect, must contain certain fields and can optionally contain other fields. The table below summarizes how Trumba Connect's event form fields map to the field definitions in the iCal file.
You can import iCal files containing custom fields defined in Trumba Connect. Numeric identifiers are used for all event templates, custom fields and many built-in fields. This will ensure that values are imported into the correct fields even if the names of the fields change. This requires you to know the numeric identifiers of the fields you want to import from the iCal file. To get all of the numeric identifiers you need, you must perform sample exports of your existing data in the Trumba calendar.
Custom field import
Here are the steps needed to specify custom field values in events to be imported into Trumba Connect.
To import the above custom field "Comments", you must specify ID=10899 in the iCal import file.
The iCal file being imported requires only the ID and value. The TYPE and NAME attributes are ignored. Hence, the import of the "Comments" custom field could look like this;
or be simplified as shown below.
X-TRUMBA-CUSTOMFIELD;ID=10899:My Comments Amended
Images are specified by URL. This can be a URL to an external image on the internet or a URL to an image previously copied into the Trumba servers using the "manage images" feature.
Sample import file
Below is a sample iCal file with custom fields. It includes a range of Trumba Connect custom field types and an event image. The NAME and TYPE attributes have been left in the file to provide contextual information.
Tip The sample file demonstrates the use of the backslash (\) escape character in the Location, Description, and MultiLine text fields:
LOCATION:1200 Fifth Ave\, Seattle WA 98101
DESCRIPTION:Event Notes: This event starts at 8:00 a.m. PT on Jan 1\, 2010.
X-TRUMBA-CUSTOMFIELD;NAME="Event Type";ID=21;TYPE=Number:Contains all Custom Field Types
X-TRUMBA-CUSTOMFIELD;NAME="my single line of text";ID=12295;TYPE=SingleLine:This is a single line of text
X-TRUMBA-CUSTOMFIELD;NAME="my multiple lines of text";ID=12296;TYPE=MultiLine:This is line 1\nThis is line 2
X-TRUMBA-CUSTOMFIELD;NAME="my list of choices";ID=12297;TYPE=CustomAsset:my choice 2
X-TRUMBA-CUSTOMFIELD;NAME="my yes or no";ID=12298;TYPE=Boolean:Yes
X-TRUMBA-CUSTOMFIELD;NAME="my web link";ID=12301;TYPE=Url:http://www.trumba.com/calendars/icstest
X-TRUMBA-CUSTOMFIELD;NAME="my email address";ID=12302;TYPE=Email:firstname.lastname@example.org
X-TRUMBA-CUSTOMFIELD;NAME="my phone number no ext";ID=12303;TYPE=PhoneUS:206-696-7200
X-TRUMBA-CUSTOMFIELD;NAME="my international phone number";ID=12304;TYPE=PhoneInt:+011-206-696-7200
|Privacy | Terms | Public Calendars|
|© 2004–2014 Trumba Corporation. All rights reserved. Click for trademark information.|