|Trumba Help Center||What’s New | FAQ | Support Forum | Email Support|
Prepare iCal files for import
One of the event import file formats Trumba supports is the iCalendar or iCal format. iCal files have an .ics extension. For example, an iCal file might be called myevents.ics.
By sending an an iCalendar format file to the Trumba server through an HTTP PUT operation, you can modify existing events without duplicating them or altering other event data. Learn more.
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.
The following URL points to an image stored on the Trumba servers.
Sample import files
Below are two sample iCal files with custom fields. The files each contain a record for a single event (defined by the content between the
The files also include examples of 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.
The second sample file shows a record for a repeating group cycling event that started on Monday, September 10, 2012 and extends until Monday, December 15, 2014. The
Tip The sample files demonstrate the use of the backslash (\) escape character in the Location, Description, and MultiLine text fields:
SUMMARY:Sample Event 1
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:email@example.com
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
SUMMARY:Sample Event 2 - Repeating
DESCRIPTION:Enjoy group cycling on stationery bikes designed for all lev
els. Instructor will guide you through a unique strength and cardiovascu
lar workout. A variety of methods will be used including visualization\,
interval training\, watts and distance as you cycle to music.
X-TRUMBA-CUSTOMFIELD;NAME="Event Template";ID=21;TYPE=Number:Group Exerc
X-TRUMBA-CUSTOMFIELD;NAME="Type of Exercise";ID=23893;TYPE=CustomAsset:I
X-TRUMBA-CUSTOMFIELD;NAME="Cost";ID=23895;TYPE=SingleLine:Free to member
s\, $15 for non members
Different programs output iCalendar files in different ways so it's not unusual for the iCal file you're trying to import to contain content that Trumba can't interpret.
By following these troubleshooting tips, you may be able to resolve the issues and import the file.
Tip Troubleshooting iCal files can be time consuming. If you can't quickly identify the blocking issues with a file you're trying to import, it may well be faster to add events manually in Trumba.
Tips for resolving import problems
|Privacy | Terms | Public Calendars|
|© 2004–2014 Trumba Corporation. All rights reserved. Click for trademark information.|