Mozilla Address Book Sync for Palm Devices
Mozilla
Address Book Sync for Palm 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
Troubleshooting
Field Mapping
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
- Any Palm-compatible
Platform device (e.g., Palm III and above, Palm m100 series, Palm m500 series and above, Handspring 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:
- Start Mozilla Address
Book Palm Sync:
- Open the Windows
Start menu.
- Choose Programs.
- From the Programs
menu, choose Mozilla.
- From the Mozilla
menu, choose Palm Tools.
- 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.
- 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:
- Start the Mozilla
Address Book Palm Sync uninstaller:
- Open the Windows
Start menu.
- Choose Programs.
- From the Programs
menu, choose Mozilla.
- From the Mozilla
menu, choose Palm Tools.
- 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. (Cavin to check.)
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 Pilot category created IF there is an
available category. The Pilot 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.
|
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. |
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 Pilot field for Display
name. The Pilot 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 Pilot 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 Pilot. Work,
Home, Fax, Email, and Mobile are synchronized. |
Cellular |
Mobile |
|
Prefers to receive rich text (HTML) mail |
|
Not synchronized. |