Netscape Address Book Sync for Palm Devices
Author: Robin Clark

## Mozilla Address Book Sync for PalmTM Devices

Mozilla Address Book Sync for PalmTM devices lets you transfer data between Mozilla address books and your Palm-compatible device.
Note: For information on HotSync® setup, consult your Palm device's documentation.

Getting Started
Requirements
Using Mozilla Address Book Palm Sync
Synchronizing With Your Palm Device
Uninstalling Mozilla Address Book Sync
Troubleshooting
HotSync Problems
Record Problems
Field Mapping
Categories and Address Books

# Getting Started

When you are ready to begin transferring data between your Mozilla address book and your Palm device, follow the instructions under Using Mozilla Address Book Palm Sync.

#

## Requirements

- Mozilla
- Any Palm-compatible Platform device (e.g., Palm III and above, Palm m100 series, Palm m500 series and above, HandspringTM Visor)
- Palm Desktop 3.5.3 or greater and HotSync version 3.1.1 or greater. If you have an older version, you can download an upgrade from the Palm web site (www.palm.com).

## Using Mozilla Address Book Palm Sync

Before using Mozilla Address Book Palm Sync, make sure your Palm device contains the latest address book data. If you have updated or entered new address book data in your Palm Desktop software, you should first perform a HotSync to update your Palm device's address books with the latest data. This will insure that your latest Palm address book data will be synchronized with your Mozilla address books.
The Mozilla Address Book Palm Sync installer utility lets your Palm device synchronize directly with your Mozilla address books by replacing the Palm Desktop Address Book Sync with Mozilla Address Book Sync.
To start using Mozilla Address Book Palm Sync:

1. Start Mozilla Address Book Palm Sync:

1. Open the Windows Start menu.
2. Choose Programs.
3. From the Programs menu, choose Mozilla.
4. From the Mozilla menu, choose Palm Tools.
5. From the Palm Tools menu, choose Address Book Palm Sync Install.

Note: If Mozilla is already running, it uses the address books in the current user profile for synchronization. If Mozilla is not running, it starts and displays the Profile Manager (if you have more than one profile) so that you can choose the profile to use for synchronization.

2. Press the HotSync button on your Palm device to start synchronizing.

Note: To install Mozilla Address Book Palm Sync from the command line, change to the directory where you installed Mozilla and enter the command PalmSyncInstall.exe.

## Synchronizing With Your Palm Device

After you synchronize with your Palm device, your Palm address book will contain all the records in your Mozilla address books. Each Mozilla address book is listed as a category in your Palm address book. Your Mozilla address book will contain a new address book for each category in your Palm address book. For more information, see Field Mapping.
Synchronizing With Another Mozilla User Profile
To synchronize your Palm device with a different Mozilla user profile, you must first quit Mozilla. Start Mozilla again, and choose the user profile you want to synchronize with. Press the HotSync button on your Palm device to synchronize.
Synchronizing With Another Program
If you want to synchronize with another program, you must first uninstall Mozilla Address Book Palm Sync.
Verifying that Netcape Address Book Palm Sync Is Installed
To verify that you have established a HotSync connection with Mozilla, right-click the HotSync Manager icon in the system tray, and choose Custom. The Custom dialog box should display "Mozilla Address Book" in the Conduit list.

### Synchronization Guidelines

Maximum number of address books
A maximum of 15 address books can be synchronized.

- Mozilla Address Book Palm Sync can synchronize only the first 15 address books due to the Palm device's limit of 15 categories. Before you synchronize, make sure that the total number of categories plus the total number of Mozilla address books does not exceed 15. Palm categories that have the same name as a Mozilla address book will be merged when you synchronize, so they should only be counted once.
- If your Palm address book already contains 15 categories, you can either remove some categories before you synchronize or make sure that your Mozilla address books are named the same as the Palm categories, so that they will get merged when you synchronize.

Mozilla address book fields
Mozilla address book fields, with the exception of the Notes and Address fields, cannot contain multiple lines. When you synchronize, field values in your Palm address book will be converted to single line entries in your Mozilla address book, with each line separated by a comma.
Palm Categories and Mozilla Address Books
On your Palm device, address records are stored in categories. In Mozilla, address records are stored in address books. Mozilla Address Book Sync matches Palm categories and Mozilla address books. After a successful synchronization, each Palm device category will have a corresponding Mozilla address book.
Palm category names are limited to 15 characters, so if you have a Mozilla address book name that is longer than 15 characters, its corresponding category name will be truncated on the Palm device.

### Uninstalling Mozilla Address Book Palm Sync

You only need to uninstall Mozilla Address Book Palm Sync if you want to synchronize your Palm Device with a different program. If you only plan to synchronize with Mozilla, you don't need to uninstall Address Book Palm Sync.
Note: Before uninstalling Mozilla Address Book Palm Sync, make sure your Palm device contains the latest address book data. If you have updated or entered new address book data in your Mozilla address book, you should perform another HotSync to update your Palm device's address books with the latest data. This will insure that your Palm address book contains the latest data from your Mozilla address books before you uninstall Mozilla Address Book Palm Sync.
To uninstall Mozilla Address Book Palm Sync:

1. Start the Mozilla Address Book Palm Sync uninstaller:

1. Open the Windows Start menu.
2. Choose Programs.
3. From the Programs menu, choose Mozilla.
4. From the Mozilla menu, choose Palm Tools.
5. From the Palm Tools menu, choose Address Book Palm Sync Uninstall.

Note: To uninstall Mozilla Address Book Palm Sync from the command line, change to the directory where you installed Mozilla and enter the command PalmSyncInstall.exe /u.
You have successfully uninstalled Mozilla Address Book Palm Sync. The Palm Desktop Address Book Sync is now enabled. You can synchronize your Palm device with your Mozilla address book again at any time by following the instructions under Installing Mozilla Address Book Palm Sync.

##

# Troubleshooting

#

## HotSync Problems

Problem: I cannot get my Palm organizer to HotSync with my Mozilla address book.
Possible Solutions:

- Make sure that you installed the HotSync Manager software, and that the HotSync Manager icon appears in your system tray.
- Make sure that you started the Mozilla Address Book Palm Sync Install utility.
- Close all HotSync windows on your PC.
- Verify that your Palm device is securely placed in its cradle.
- Make sure that no other programs are using the same serial port as the HotSync manager. To verify your serial port settings, click the HotSync Manager icon in the system tray and choose Setup.
- Close the HotSync Manager and then open it again.

Problem: The HotSync Manager keeps timing out.
Possible Solution:

- The time out interval for HotSync Manager is one minute. If HotSync times out while waiting for Mozilla to launch, make sure that you start Mozilla before starting synchronization.

Problem: The HotSync process takes a long time.
Possible Solutions: You can reduce the time it takes to synchronize by doing the following:

- Please note that depending on the number of address book records and the speed of your PC, the first time you synchronize may take a while. Subsequent synchronizations will be faster.
- Set unused applications to Do Nothing in the HotSync Manager Custom menu.

## Record Problems

Problem: Some Mozilla records do not appear in the Palm device after synchronizing.
Possible Solution:

- Only the first 15 address books are synchronized. Make sure the records are in an address book that actually got synchronized.

Problem: Some records appear duplicated.
Possible Solution:

- Delete the unwanted records either from your Palm device or from your Mozilla address book.
- If a HotSync terminates unexpectedly (due to a power loss, for example), it is possible that the next time you perform a HotSync, some records will be duplicated.

Problem: Changes I made to a record on my Palm device were not transferred to my Mozilla address book.
Possible Solution:

- Make sure that the field that changed is supported. See Field Mapping.

Problem: Some Palm device fields appear in a different order after synchronizing.
Possible Solution:
On the Palm device, there are five phone fields. When you synchronize, the order of these fields is reset according to the current field mapping.
Problem: Fields that contain multiple lines get changed when I synchronize.
Possible Solution:

- Unlike fields on the Palm device, all Mozilla fields, with the exception of the Notes and Address fields, cannot consist of multiple lines. When synchronizing, field values on the Palm device that contain multiple lines will be changed to single line entries, with each line separated by a comma.

# Field Mapping

This section describes the conversions that occur when transferring data between Mozilla address book(s) and your Palm device's address book. Apart from the special conversion rules that apply to specific fields, some general rules apply:

- Text fields are truncated to the maximum allowed length on the destination platform.
- Text fields that can contain multiple lines on the Palm device but not in Mozilla will be changed to single line entries with each line separated by a comma.
- Fields that are available in Mozilla but not on the Palm device and vice versa will not be modified during synchronization.

Categories and Address Books
The following table describes what happens to categories and address books during synchronization.

Mozilla Address Book action | Palm category action | Synchronization
--- | --- | ---
New address book created | n/a | New Palm category created if there is an available category. The Palm device can only contain 15 categories. If the maximum has been reached then this address book will not be synchronized.
Address book deleted | Category not changed, or category deleted | All of the records from this address book will be deleted and if the category still exists it will be deleted as well.
Address book renamed | n/a | All of the records from this address book remain in the same category. The category is not renamed on the Palm device. However, after syncing, the Mozilla address book will be renamed to match the category name on the Palm device. Therefore, to rename a Mozilla address book, rename it on the Palm device and then sync.
n/a | New category created | A new address book with the same name as the category will be created in Mozilla. All new records filed in the category will be created in the new address book.
n/a | Category deleted | Records go to the Unfiled Mozilla address book.
n/a | Category renamed | The category will be renamed to match the address book it corresponds to. To rename a Mozilla address book, rename it on the Palm device and then sync.
n/a | Records in "Unfiled" category | Records appear in the Unfiled Mozilla address book.

Fields

Mozilla field | Palm field | Notes
--- | --- | ---
First name | First name |
Last name | Last name |
Display name |  | There is no Palm field for Display name. The Palm can be configured to list records by Last name, First name or Company, Last name
Email Address | E-mail |
Nickname |  | Not synchronized
Title | Title |
Organization | Company |
Department |  | There is no corresponding Palm field for Department.
Notes | Note | Multiple lines are allowed in this field.
Address | Address | Multiple lines are allowed in this field.
City | City |
State | State |
Zip | Zip Code |
Country | Country |
Work phone | Work |
Home phone | Home |
Fax | Fax |
Pager |  | Only 5 phone fields are available on the Palm. Work, Home, Fax, Email, and Mobile are synchronized.
Cellular | Mobile |
Prefers to receive rich text (HTML) mail |  | Not synchronized.

12 May 2003
Copyright© 1994-2003 The Mozilla Organization.