Calendar:Import Export: Difference between revisions

(→‎Comma Separated Value: Field Mapping)
m (add sort key 'Import Export')
 
(4 intermediate revisions by one other user not shown)
Line 9: Line 9:
CSV import and export are optimized for collaboration with Outlook which can't handle the iCalendar format in the necessary extent. CSV offers an easy way to exchange data with spreadsheets or word processors too.
CSV import and export are optimized for collaboration with Outlook which can't handle the iCalendar format in the necessary extent. CSV offers an easy way to exchange data with spreadsheets or word processors too.


Currently Calendar imports only "well formed" CSV files. The first line should contain the header names. Each header name and each data field has to be enclosed in double quotes. Data fields need to be separated with commas.  
Currently Calendar imports only "well formed" CSV files. The first line should contain the header names. Each header field and each data field has to be enclosed in double quotes. Fields need to be separated with commas.


Effective as of version 0.8: Mandatory are the two fields "Subject" and "Start Date" in their localized naming only. Recommended date format is <code>YYYY-MM-DD</code> with a '''four''' digit year at the beginning. Time format should be <code>HH:MM:SS</code> with 24-hour values. Calendar will also understand dates and times in the locale scheme of the operating system but data format must not change within a file. The universal indicators <code>AM</code>, <code>a.m.</code>, <code>PM</code> and <code>p.m.</code> are always recognized.  
Mandatory are the two fields "Subject" and "Start Date" in their localized naming only (since 0.8).  


The header names are localized and follow Outlook. Column order is not important. If the two mandatory headers could not be recognized all files with 22 headers are assumed to have the column order of an [https://bugzilla.mozilla.org/attachment.cgi?id=302178 English CSV file] from Outlook .
The header names are localized and follow Outlook. Column order is not important. If the two mandatory headers were not recognized a fall back attempt is made for a file with 22 headers. It is assumed to have the column order of an [https://bugzilla.mozilla.org/attachment.cgi?id=302178 English CSV file] regardless of its headers.


Sample CSV file
Event and task headers and Outlook boolean field values are case sensitive and localized. Currently only events are imported and fields in parenthesis are skipped.
 
Sample CSV file:
  "Subject","Start Date"
  "Subject","Start Date"
  "Berlin Wall came down","1989-11-09"
  "Berlin Wall came down","1989-11-09"
"Genscher at embassy in Prague","1989-09-30"


=== Field Mapping ===
Future development goals are in the [[Calendar:Feature_Implementations:ImportExport:CSV|Feature Implementations]]
{|
| # || '''Events<br />header''' || '''Tasks<br />header''' || '''Calendar<br />property''' ||| '''Outlook<br />field values'''
|-
| 1 || Subject || eq. || SUMMARY ||
|-
| 2 || Start Date || eq. || DTSTART ||
|-
| 3 || Start Time || - || DTSTART ||
|-
| 4 || End Date || - || DTEND ||
|-
| 5 || End Time || - || DTEND ||
|-
| 6 || All day event || - || VALUE=DATE attribute || True, False
|-
| 7 || Reminder on/off || Reminder On/Off || VALARM component || True, False
|-
| 8 || Reminder Date || eq. || TRIGGER ||
|-
| 9 || Reminder Time || eq. || TRIGGER ||
|-
| 10 || Meeting Organizer || - || (ATTENDEE) ||
|-
| 11 || Required Attendees || - || (ATTENDEE) ||
|-
| 12 || Optional Attendees || - || (ATTENDEE) ||
|-
| 13 || Meeting Resources || - || - ||
|-
| 14 || Billing Information || eq. || none ||
|-
| 15 || Categories || eq. || CATEGORIES ||
|-
| 16 || Description || - || DESCRIPTION ||
|-
| 17 || Location || - || LOCATION ||
|-
| 18 || Mileage || eq. || none ||
|-
| 19 || Priority || eq. || (PRIORITY) || High, Normal, Low
|-
| 20 || Private || eq. || PRIVACY || True, False
|-
| 21 || Sensitivity || eq. || (CLASS) || Normal, ....
|-
| 22 || Show time as || - || (TRANSP) || 2, ...
|-
| 23 ||  || Status || (STATUS) ||
|-
| 24 ||  || Due Date || (DUE) ||
|-
| 25 ||  || Date Completed || (COMPLETED (in UTC!)) ||
|-
| 26 ||  || % Complete || (PERCENT-COMPLETE) || Fractions of one
|-
| 27 ||  || Total Work || - ||
|-
| 28 ||  || Actual Work || - ||
|-
| 29 ||  || Companies || - ||
|-
| 30 ||  || Contacts || - ||
|-
| 31 ||  || Notes || (DESCRIPTION)
|-
| 32 ||  || Role || -
|-
| 33 ||  || Schedule+ Priority || -
|}
 
Currently only events are imported and fields in parenthesis are skipped.


=== Hypertext Markup Language ===
=== Hypertext Markup Language ===
Line 97: Line 29:




[[category:calendar]]
[[category:calendar|Import Export]]

Latest revision as of 13:18, 24 August 2008

<< Back to Calendar Home Page

Calendar can import data in iCalendar (iCal) and Comma Separated Value (CSV) formats. Export is possible in these formats and is additionally in Hypertext Markup Language (HTML).

iCalendar

Recommended for data exchange. The format is standardized in RFC 2445 and widely used.

Comma Separated Value

CSV import and export are optimized for collaboration with Outlook which can't handle the iCalendar format in the necessary extent. CSV offers an easy way to exchange data with spreadsheets or word processors too.

Currently Calendar imports only "well formed" CSV files. The first line should contain the header names. Each header field and each data field has to be enclosed in double quotes. Fields need to be separated with commas.

Mandatory are the two fields "Subject" and "Start Date" in their localized naming only (since 0.8).

The header names are localized and follow Outlook. Column order is not important. If the two mandatory headers were not recognized a fall back attempt is made for a file with 22 headers. It is assumed to have the column order of an English CSV file regardless of its headers.

Event and task headers and Outlook boolean field values are case sensitive and localized. Currently only events are imported and fields in parenthesis are skipped.

Sample CSV file:

"Subject","Start Date"
"Berlin Wall came down","1989-11-09"
"Genscher at embassy in Prague","1989-09-30"

Future development goals are in the Feature Implementations

Hypertext Markup Language

HTML export gives an event list with the todo items on top of that list.