Field Mapping
This section describes the conversions that occur when transferring data between the calendar application and your palm organizer's Date Book, Address Book and To Do List. Apart from the special conversion rules that apply to specific fields, some general rules apply:
- Text fields are cut to the maximum allowed length on the destination platform
- Dates that are not within the representable range of dates on the destination platform will get changed to the nearest representable date
- Details from the calendar application are truncated to the "maximum note size" before being sent to a palm organizer note
If the user changes a field on the palm organizer which he or she does not have the right to change in the calendar application (e.g. changing the time of an Event the user does not own), the change is rejected and the affected field is copied from the calendar application back onto the palm organizer.
Entries
Converting a calendar server Entry into a palm organizer Date Book item
| calendar server field |
Palm field |
Notes |
| Title
|
Description
|
|
| Location
|
Description
|
If the "Show Location" flag is set, the calendar server Entry's location is enclosed in parentheses and appended to the Palm Event's description, after its calendar server title. If the flag is not set, the calendar server Entry's location is ignored.
|
| Detail
|
Note
|
If the calendar server Entry is a Meeting, then its detail is copied to the Palm Event's note. If it is a Day Event or Daily Note, it is ignored. Also, if the "Show Location" flag is set and there is more than one attendee or its sole attendee is not the login user, then a textual list of attendee names is created and added to the Palm Event's note (which may or may not have been copied from the calendar server Entry's detail, depending on the Event's class).
|
| Start Time
|
Date / Start Time
|
The calendar server Entry's start time is split into two parts: the date and the time-of-day on that date. The date is always placed into the Palm Event's date field. If the calendar server Entry is a Meeting, then the time-of-day is placed into the Palm Event's start time. If the calendar server Entry is anything besides a Meeting (e.g. Day Event, Daily Note, Holiday), the Palm Event becomes an untimed Event.
|
| Duration
|
End Time
|
If the calendar server Entry is a Meeting, then its duration is added to its start time's time-of-day, and the result placed in the Palm Event's end time. The Palm does not allow Events to cross day boundaries. If that happens, the Event is truncated to end at midnight before being copied to the Palm (this does not affect the calendar server Entry).
|
| Reminder
|
Alarm
|
If the calendar server Entry does not have a reminder, the Palm Event does not get one either and the calendar server Entry's reminder length is checked. If it is a multiple of 1440 (the number of minutes in a day) or is greater than 7620 (the number of minutes in 127 hours), the Palm Event's alarm unit field is set to "Days". If it is a multiple of 60 or is greater than 127, the Palm Event's alarm unit field is set to "Hours" and the Palm Event's alarm unit field is set to "Minutes". The calendar server Entry's reminder length is then converted into the proper units. If the resulting number is greater than 127, it is changed to 127. This number is used in the Palm Event's alarm amount field.
|
| Access level
|
Private flag
|
If the calendar server Access level is Personal, the Palm Task's private flag is turned on. If the Access level is anything else, the Palm Task's private flag is turned off.
|
|
Repeat
|
Repeating Entries on the calendar server are always copied as individual instances, so this field is set to "No Repeat".
|
:
Table 1:
| Palm field |
calendar server field |
Notes |
| Description
|
Title
|
If the "Show Location" flag is set, the Palm Event's description is divided in two: a title part and location part. If the flag is not set, the entire Palm Event's description becomes the title part. If the calendar server Entry has an instance title, the title part is used as the instance title. If not, it is placed in the calendar server Entry 's title.
|
| Description
|
Location
|
If the "Show Location" flag is set, the Palm Event's description is split into two parts: a title part and location part. The location part is placed in the calendar server Entry's location. If the flag is not set, the calendar server Entry's location remains unchanged.
|
| Note
|
Detail
|
If the "Show Attendees" flag is set, the Palm Event's note is split into two parts: an attendee part and a note part. If not, the entire Palm Event's note becomes the note part. The attendee part is discarded. If the calendar server Entry is a Meeting, then the note part is copied to the calendar server Entry's detail. If not, it is ignored.
|
| Date / Start Time
|
Start Time
|
The Palm Event's date (and its start time, if it is not an untimed Event) are merged and placed into the calendar server Entry's start time. Note that if the Palm Event is changed from a timed Event into an untimed one or vice versa, that change is rejected and its original state is restored. (This is because it would amount to changing the class of a calendar server Entry, which we do not support.)
|
| End Time
|
Duration
|
If the calendar server Entry is a Meeting, then the Palm Event's date, start time and end time are combined to calculate its duration, which is then placed in the calendar server Entry's duration field.
|
| Alarm
|
Reminder
|
If the Palm Event does not have a reminder, the calendar server Entry does not get one either. If it does, the Palm Event's alarm amount is converted to minutes and placed in the calendar server Entry's reminder length field. If the Palm Event's alarm unit is "Minutes" or "Hours", then the calendar server Entry's reminder type is set to "Popup Window". If the Palm Event's alarm unit is "Days", then the calendar server Entry's reminder type is taken from the user's Entry defaults. Finally, if the default reminder type is "No Reminder", then the type is set to "Display Upcoming".
|
| Private flag
|
Access level
|
If the Palm Event's private flag is turned on, then the calendar server Entry's Access level becomes Personal. If the Palm Event's private flag is turned off, the calendar server Entry's Access level comes from the user's Entry defaults, unless the default Access level is Personal (the calendar server Access level is set to Confidential in this case).There is an exception to this rule: If the Palm Event's private flag is turned off and the flag has not changed since the last sync, and the calendar server Access level is anything except Personal, the calendar server Access level remains unchanged.
|
| Repeat
|
|
Repeating Events on the Palm are ignored. They are treated as if they were single-instance Events.
|
Converting a Date Book item on the palm organizer to the calendar application:
Tasks
Converting a the calendar application Task into a To Do item on the palm organizer:
| calendar server field |
Palm Field |
Notes |
| Description
|
Description
|
|
| Detail
|
Note
|
|
| Due Date
|
Due Date
|
|
| Priority
|
Priority
|
If the calendar server priority is between 1 and 5, it maps to the same priority on the Palm. If the calendar server priority is anything else, it maps to priority 5 on the Palm.
|
| Completion level
|
Completed flag
|
A calendar server completion level of 100% level flag maps to the Palm's completed flag being turned on. Any other completion level, the completed flag is turned off.
|
| Access level
|
Private flag
|
If the calendar server Access level is Personal, the Palm Task's private flag is turned on. If the Access level is anything else, the Palm Task's private flag is turned off.
|
|
Category
|
The To Do gets the default ("Unfiled") category.
|
Converting a To Do item on the palm organizer into a the calendar application Task:
Table 2:
| Palm field |
calendar server field |
Notes |
| Description
|
Description
|
|
| Note
|
Detail
|
|
| Due Date
|
Due Date
|
If there is no due date, any existing calendar server due date reminder is removed. If a due date is specified, a calendar server due date reminder is created if it does not already exist. Its type and length are taken from the user's defaults.
|
| Priority
|
Priority
|
The Priority level maps directly, with the following exception. If the Palm priority is 5, and it has not changed since the last sync, and the calendar server priority is anything else, then the calendar server priority remains the same.
|
| Completed flag
|
Completion level
|
The Palm completed flag maps to a calendar server completion level of 0% or 100%, depending on the state of the flag. There is an exception to this rule, however. If the Palm completed flag is off, and it has not changed since the last sync, and the calendar server completion level is between 1% and 99%, the calendar server completion level stays unchanged.
|
| Private flag
|
Access level
|
If the Palm Task's private flag is turned on, then the calendar server Task's Access level becomes Personal. If the Palm Task's private flag is turned off, the calendar server Task's Access level comes from the user's Task defaults, unless the default Access level is Personal (the calendar server Access level is set to Confidential in this case). There is an exception to this rule: If the Palm Task's private flag is turned off, and the flag has not changed since the last sync, and the calendar server Access level is anything except Personal, the calendar server Access level remains unchanged.
|
| Category
|
|
The Palm Task's category is ignored.
|
Address Book Entries
Address book Entries in the calendar application are categorized as business Entries and personal Entries on your palm organizer. If a the calendar application Entry has a business address only (i.e. no home address), that Entry is considered a business Entry. Conversely, if the Entry has a home address only, it is considered a personal Entry. If an Entry has both addresses, its category is taken from the "Default" value in CS Setup. Finally, if an Entry does not have any addresses, it is considered an "unknown" Entry.
Converting a calendar application Address Book Entry into a palm organizer address:
Table 3:
| calendar application field |
Palm field |
Notes |
| ---
|
category
|
Business Entries in the calendar application are placed in the "Business" category. Personal Entries in the calendar application are placed in the "Personal" category. Unknown Entries are placed in the "Unfiled" category.
|
| Last name
|
Last name
|
|
| First name
|
First name
|
|
| Assistant phone
|
---
|
|
| Business 1
|
A phone field
|
See below
|
| Business 2
|
A phone field
|
See below
|
| Fax 1
|
A phone field
|
See below
|
| Fax 2
|
A phone field
|
See below
|
| Home 1
|
A phone field
|
See below
|
| Home 2
|
A phone field
|
See below
|
| Mobile 1
|
A phone field
|
See below
|
| Mobile 2
|
A phone field
|
See below
|
| Pager
|
A phone field
|
See below
|
| E-mail 1
|
A phone field
|
See below
|
| E-mail 2
|
A phone field
|
See below
|
| Street
|
Address
|
Business or home address, depending on Entry category.
|
| City
|
City
|
Business or home address, depending on Entry category.
|
| Prov/State
|
State
|
Business or home address, depending on Entry category.
|
| Zip/Code
|
Zip Code
|
Business or home address, depending on Entry category.
|
| Country
|
Country
|
Business or home address, depending on Entry category.
|
| Relationship
|
---
|
|
| Title
|
Title
|
|
| Company
|
Company
|
|
| Department
|
---
|
|
| Office
|
---
|
|
| Assistant
|
---
|
|
| Industry Type
|
---
|
|
| Account #
|
---
|
|
| Birthday
|
---
|
|
| Anniversary
|
---
|
|
| Custom Date 1
|
---
|
|
| Custom Date 2
|
---
|
|
| Nickname
|
---
|
|
| Spouse
|
---
|
|
| Personal Notes
|
---
|
|
| User 1
|
Custom 1
|
|
| User 2
|
Custom 2
|
|
| User 3
|
Custom 3
|
|
| User 4
|
Custom 4
|
|
| Notes
|
Note
|
|
| ---
|
Private Flag
|
Ignored. The calendar application currently does not support security on a per-address basis.
|
Telephone fields on the palm organizer are allocated according to a fixed order. For each telephone number present in the the calendar application Entry, a telephone field on the palm organizer is allocated (up to a maximum to five) and given a corresponding label.
For business Entries, the order of allocation is as follows:
Table 4:
| calendar application Telephone # |
Palm Label |
| Business 1
|
Work
|
| Home 1
|
Home
|
| Fax 1
|
Fax
|
| E-mail 1
|
E-mail
|
| Mobile 1
|
Mobile
|
| Pager
|
Pager
|
| Business 2
|
Work
|
| Home 2
|
Home
|
| Fax 2
|
Fax
|
| E-mail 2
|
E-mail
|
| Mobile 2
|
Mobile
|
For personal Entries, the order of allocation is as follows:
Table 5:
| calendar application Telephone # |
Palm Label |
| Home 1
|
Home
|
| Business 1
|
Work
|
| Fax 1
|
Fax
|
| E-mail 1
|
E-mail
|
| Mobile 1
|
Mobile
|
| Pager
|
Pager
|
| Home 2
|
Home
|
| Business 2
|
Work
|
| Fax 2
|
Fax
|
| E-mail 2
|
E-mail
|
| Mobile 2
|
Mobile
|
Converting a palm organizer address into a calendar application Address Book Entry:
Table 6:
| Palm field |
calendar application field |
Notes |
| Category
|
---
|
The category is used to determine which address (business or home) to synchronize with.
|
| Last name
|
Last name
|
|
| First name
|
First name
|
|
| Phone 1
|
Business1
|
See below
|
| Phone 2
|
Business 2
|
See below
|
| Phone 3
|
Fax 1
|
See below
|
| Phone 4
|
Fax 2
|
See below
|
| Phone 5
|
Home 1
|
See below
|
| Address
|
Street
|
Business or home address, depending on Entry category.
|
| City
|
City
|
Business or home address, depending on Entry category.
|
| State
|
Prov/State
|
Business or home address, depending on Entry category.
|
| Zip Code
|
Zip/Code
|
Business or home address, depending on Entry category.
|
| Country
|
Country
|
Business or home address, depending on Entry category.
|
| Title
|
Title
|
|
| Company
|
Company
|
|
| Custom 1
|
User 1
|
|
| Custom 2
|
User 2
|
|
| Custom 3
|
User 3
|
|
| Custom 4
|
User 4
|
|
| Note
|
Notes
|
|
| Private flag
|
---
|
Ignored - The calendar application currently does not support security on a per-address basis.
|
Palm organizer telephone numbers are transferred to the calendar application depending on (1) their position and (2) their label. For example, the second telephone with a label of "Mobile" will end up in the "Mobile 2" field in the calendar application. The complete list of possibilities is as follows:
Table 7:
| 1st Occurrence on Palm |
Maps to |
| Work
|
Business 1
|
| Home
|
Home 1
|
| Fax
|
Fax 1
|
| Other
|
---
|
| E-mail
|
E-mail 1
|
| Main
|
---
|
| Pager
|
Pager
|
| Mobile
|
Mobile 1
|
Table 8:
| 2nd Occurrence on Palm |
Maps to |
| Work
|
Business 2
|
| Home
|
Home 2
|
| Fax
|
Fax 2
|
| Other
|
---
|
| E-mail
|
E-mail 2
|
| Main
|
---
|
| Pager
|
---
|
| Mobile
|
Mobile 2
|
