6
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

The following table shows how calendar application Entries are converted to Palm organizer Date Book items and vice versa.

Table 6-1  Calendar Application Entries and Palm Organizer Date Book Items

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".

Tasks

The following table shows how calendar application Tasks are converted to To Do items on the Palm organizer and vice versa.

Table 6-2  Calendar Server Tasks and Palm Organizer To Do Items

Calendar Server Field	Palm Field	Notes
Description	Description
Detail	Note
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.

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.

The following table shows how a calendar application Address Book Entry is converted to a Palm organizer address and vice versa.

Table 6-3  Calendar Application Address Book Entries and Palm Organizer Addresses

Calendar Server 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	N/A
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
Page	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	N/A
Title	Title
Company	Company
Department	N/A
Office	N/A
Assistant	N/A
Industry Type	N/A
Account #	N/A
Birthday	N/A
Anniversary	N/A
Custom Date 1	N/A
Custom Date 2	N/A
Nickname	N/A
Spouse	N/A
Personal Notes	N/A
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 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 and personal Entries, the order of allocation is as follows:

Table 6-4  Palm Organizer Business and Personal Entries

Calendar Application Telephone #	Palm Label
Business1	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

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 6-5  How Palm Organizer Telephone Numbers Transfer to the Calendar Application

1st Occurrence on Palm	Maps To
Work	Business 1
Home	Home 1
Fax	Fax 1
Other	N/A
E-mail	E-mail 1
Main	N/A
Pager	Pager
Mobile	Mobile 1

Table 6-6  How Palm Organizer Telephone Numbers Transfer to the Calendar Application

2nd Occurrence on Palm	Maps To
Work	Business 2
Home	Home 2
Fax	Fax 2
Other	N/A
E-mail	E-mail 2
Main	N/A
Pager	N/A
Mobile	Mobile 2