You are currently viewing a snapshot of www.mozilla.org taken on April 21, 2008. Most of this content is highly out of date (some pages haven't been updated since the project began in 1998) and exists for historical purposes only. If there are any pages on this archive site that you think should be added back to www.mozilla.org, please file a bug.

You are here: Mozilla MailNews Functional / UI Tests > Address Book Palm Synchronization

Feature Test Spec: Mail and News Component

Mail and News Component: Address Book Palm Synchronization

Written by Gregg Meehan, updated by Ninoschka Baca

References

Palm Sync Technical Specification by Rajiv Dayal

Description

The Palm OS has an address book application. For easier address book maintenance the Palm Desktop software is used to create, modify and delete data from the address book. When a HotSync is performed then both the Palm device and the Palm Desktop software have corresponding data.

The Mozilla Address Book can be used in place of the Palm Desktop software. After installing the Address Book Palm Sync Installer and selecting the HotSync button then a synchronization occurs between the Palm device and the Mozilla Address Book.

Terms:

The Palm device uses the term "Record" which includes the name, address, email address, phone number etc... for a user.
The Palm device uses "Categories" to describe a group of records (i.e. you could have a category for your Doctors).
Mozilla does not use "Category" as a term but after a HotSync the categories become separate address books (i.e. after a HotSync the user would have a Personal Address Book and a Doctors address book in the Mozilla Address Book window)
AB= Address Book
HotSync= press the HotSync button on the palm's cradle

Supported Palm Software/Hardware: TBD

Any Palm Compatible Platform device (e.g. Palm III and above, Palm m100 Series and above, Handspring Visor)
- More Palm examples, i.e. Palm m500 series, etc.
Primary platform for the Palm Desktop is 4.1. and HotSync version 4.0.x
Secondary platform Palm Desktop 3.5 and HotSync version 3.1.x

Use the logging facility:
If problems occur then use the logging facility to see more details. It will also be helpful to attach the file to a bug report.

Create an environment variable MOZ_CONDUIT_LOG. For example, set MOZ_CONDUIT_LOG to a file path like C:\\TEMP\\ConduitLog.txt.

Some Mozilla build users may have problems installing the Address Book Palm Sync Conduit:
To enable Palm sync you need 2 files which are redistributable by Palm. However, Mozilla can not redistribute them since they are not open source. Select this link for instructions on correcting the problem.

Visual

Verify after the installation that the "Address Book Palm Sync Install" and the "Address Book Palm Sync Uninstall menu items appear off of the Window's Start menu.

Functionality

Verify the AB HotSync process is initiated:
1. Verify the AB HotSync process is initiated with the Mozilla application closed and Quick Launched turned off
2. Verify the AB HotSync process is initiated with the Mozilla application closed and Quick Launch is turned on
3. Verify the AB HotSync process is initiated with the Mozilla application running with the Browser window open
4. Verify the AB HotSync process is initiated with the Mozilla application running with Mail window open
5. Verify the AB HotSync process is initiated with the Mozilla application running with the Address Book window open
6. Verify the AB HotSync process is initiated with the Mozilla application closed, preferences set for Mail to open and Browser not to open and Quick Launch turned off.
7. Verify the AB HotSync process is initiated with the Mozilla application closed, preferences set for Mail to open and Browser not to open and Quick Launch turned on.
Verify data created in the Mozilla Address Book appears on the palm device after a HotSync
1. Verify creating one card in Mozilla's AB displays on the palm device after a HotSync
2. Verify creating an address book with no cards in Mozilla's AB displays on the palm device after a HotSync. The newly created category should have no records.
3. Verify creating a second card in a newly created address book in Mozilla's AB displays on the palm device. The second card should appear as a new record in the newly created category (i.e. Doctors)
4. Verify creating another card an existing address book (i.e. Doctors) in Mozilla's AB displays on the palm device. In this case the category for Doctors already exists so the record should just be added.
5. Verify creating multiple cards in multilple address books in Mozilla's AB displays on the palm device. If some/all of the corresponding address books don't exist on the palm device, they will be created as catergories and the new records will be added to them.
6. Verify creating a list in a Mozilla AB does not display in the palm device after a HotSync
Verify records created in the palm device appear in the Mozilla Address Book after a HotSync
1. Verify creating one record in the palm device displays in the Mozilla AB after a HotSync
2. Verify creating one category with no records in the palm device displays in the Mozilla AB after a HotSync. The newly created category should appear as a separate address book with no cards.
3. Verify creating a second record in a newly created category in the palm device displays in the Mozilla AB. The second record should appear as a card in a newly created address book in the Mozilla AB (i.e. Doctors)
4. Verify creating another record in an existing category (i.e. Doctors) in the palm device displays in Mozilla's AB. In this case the address book for Doctors already exists so the new record should appear as a card.
5. Verify creating multiple records in multiple categories in the palm device displays in Mozilla's AB. If some/all of the corresponding records do not exist in the Mozilla AB, they will be created as new cards in the corresponding address books.
Verify data/records created on the palm device and the Mozilla Address Book window with different data appear on both sides after a HotSync
1. Verify creating one record in the palm device and a card in the Mozilla AB (having different data) appear on both sides after a HotSync
2. Verify creating a new category in the palm device and a new address book in the Mozilla AB (using different names) appear on both sides after a HotSync
3. Verify creating multiple records in the palm device and multiple cards in the Mozilla AB (having different data) appear on both sides after a HotSync
4. Verify creating multiple records in multiple categories in the palm device and multiple cards with multiple address books in the Mozilla AB appear on both sides after a HotSync.
Verify data/records created on the palm device and the Mozilla Address Book window with the same data appear as separate entries after a HotSync
1. Verify creating one record in the palm device and a card in the Mozilla AB (with the same data) appear as separate entries
2. Verify creating a new category in the palm device and a new address book in the Mozilla AB (with the same name) appear as separate entries.
3. Verify creating multiple records in the palm device and multiple cards in the Mozilla AB (with the same data) appear as separate entries.
4. Verify creating multiple records in multiple categories in the palm device and multiple cards with multiple address books in the Mozilla AB (with the same data) appear as seperate entries.
Verify categories created in the palm device and address books in the Mozilla Address Book window appear after a HotSync
1. Verify creating a new category in the palm device appears as an address book in the MozAB
2. Verfiy creating a new address book in the MozAB appears as a category in the palm device
3. Verify creating a new category in the palm device and a different address book in the MozAB results in both appearing on both sides.
4. Verify creating a new category in the palm device with the same address book name in the MozAB results in separate entries.
Verify modified data in the Mozilla Address Book displays on the palm device after a HotSync
1. Verify modifying one card in Mozilla's AB displays on the palm device after a HotSync
2. Verify modifying several cards in Mozilla's AB displays on the palm device after a HotSync
3. Verify modifying several cards in various Mozilla address books display on the palm device after a HotSync
4. Verify after moving cards from one address book to another address book that this change displays in the palm device after a HotSync
5. Verify after adding a new address in a list dialog in the Mozilla AB (which also makes a copy in the parent address book) that another record is added to the appropriate category.
6. Verify modifying all the data in one card in the Mozilla AB displays on the palm device
Verify modified records in the palm device appear in the Mozilla Address Book after a HotSync
1. Verify modifying one record in the palm device displays in the Mozilla AB after a HotSync
2. Verify modifying several records in the palm device displays in the Mozilla AB after a HotSync
3. Verify modifying serveral records in multiple categories in the palm device displays in Mozilla's AB after a HotSync
4. Verify modifying all the data in one record in the palm device displays in the Mozilla AB
Verify modified records on the palm device and different cards in the Mozilla Address Book window appear on both sides after a HotSync
1. Verify modifying one record on the palm device and a different card on the Mozilla AB appear on both sides after a HotSync
2. Verify modifying a category name in the palm device and a different address book in the Mozilla AB appear on both sides
3. Verify modifying several records on the palm device and several different cards in the Mozilla AB appears on both sides
4. Verify modifying several records in multiple categories and different cards and address books in the Mozilla AB appears on both sides
Verify modified data/records on the palm device and the corresponding cards in the Mozilla Address Book window appear as separate data/records after a HotSync
1. Verify modifying one record on the palm device and the same card on the Mozilla AB with different data appears as separate data/records on both sides.
2. Verify modifying several records on the palm device and the same cards in the Mozilla AB with different data appear as separate data/records on both sides.
3. Verify modifying several records in multiple categories and the same cards and address books in the Mozilla AB appear as separate data/records on both sides.
Verify modified categories/address books names on the palm device and the Mozilla Address Book window result in expected behavior after a Hot Sync (Strikethroughs ref: Currently renaming address books is not possible in MozAB)
1. Verify modifying an address book name in Mozilla's Address Book window displays in the palm device after a HotSync. Currently renaming address books is not possible.
2. Verify modifying a category name in the palm device displays in the Mozilla AB after a HotSync
3. Verify a modified category name in the palm device and a different modified address book name in the Mozilla AB appear on both sides?
4. Verify a modified category name in the palm device and the same modified address book name in the Mozilla AB appear?
Verify deleted cards in the Mozilla Address Book is updated on the palm device after a HotSync
1. Verify deleting one card in Mozilla's AB updates the palm device after a HotSync
2. Verify deleting several cards in Mozilla's AB updates the palm device after a HotSync
3. Verify deleting several cards in various Mozilla address books updates the palm device after a HotSync
4. Verify deleting a card in the MozAB that does not exist on the palm device results in no change to the palm device
Verify deleted data in a Mozilla Address Book card is updated on the palm device after a HotSync
1. Verify deleting all the data in one card in the Mozilla AB updates the palm device
2. Verify deleting half the data in a card in the Mozilla AB updates the palm device
Verify deleted lists and address books in a Mozilla Address Book performs the desired results after a HotSync
1. Verify deleting an address from a list in the Mozilla AB results in no change on the palm device
2. Verify deleting a list from a Mozilla AB results in no change on the palm device
3. Verify deleting an address book from a Mozilla AB updates the palm device
Verify deleted records on the palm device are updated in the Mozilla Address Book after a Hot Sync
1. Verify deleting one record in palm device updates the Mozilla AB after a HotSync
2. Verify deleting several records in palm device updates the Mozilla AB after a HotSync
3. Verify deleting several records in various categories in the palm device updates the Mozilla AB after a HotSync
4. Verify deleting a record on the palm device that does not exist on the MozAB results in no change on the MozAB
Verify deleted data in a record on the palm device is updated in the Mozilla Address Book after a HotSync
1. Verify deleting all the data in one record in the palm device updates the Mozilla AB
2. Verify deleting half the data in a record in the palm device updates the Mozilla AB
Verify deleted data/records from the palm device and the Mozilla Address Book with different data updates both sides after a HotSync
1. Verify deleting one record on the palm device and a different one on the Mozilla AB updates both sides
2. Verify deleting all the data in one record in the palm device and a different one on Mozilla AB updates both sides
3. Verify deleting half the data in a record in the palm device and a different one on Mozilla AB updates both sides
4. Verify deleting a category name in the palm device and a different address book in the Mozilla AB updates both sides
5. Verify deleting several records on the palm device and several different ones in the Mozilla AB updates both sides
6. Verify deleting several records in multiple categories and different cards and address books in the Mozilla AB updates both sides
Verify deleted data/records from the palm device and the Mozilla Address Book with the same data appear as expected after a HotSync
1. Verify deleting one record on the palm device and the same one on the Mozilla AB results in a deletion on both sides
2. Verify deleting all the data in one record in the palm device and the same on the Mozilla AB updates both sides
3. Verify deleting half the data in a record in the palm device and the other half the data on the same card in Mozilla AB results in two separate entries. (try this)
4. Verify deleting a category name in the palm device and the same address book in the Mozilla AB results in a deletion on both sides
5. Verify deleting several records on the palm device and the same ones in the Mozilla AB results in a deletion on both sides
6. Verify deleting several records in multiple categories and the same cards and address books in the Mozilla AB results in a deletion on both sides
Verify deleted categories/address books names on the palm device and the Mozilla Address Book window updates both sides after a HotSync.
Note1: When deleting a category that includes records, the palm device will move the records to the Unfiled category. After a sync the corresponding address book should be gone but the records should appear in Mozilla's Unfiled address book.
Note2: When deleting a Mozilla address book that includes records, this action completely removes the address book and the cards. After a sync the corresponding category also completely removes the category and its records.
1. Verify deleting one empty category in the palm device results in the corresponding Mozilla AB being deleted
2. Verify deleting a category with records results in the corresponding address book being deleted and its cards moved to the Unfiled address book.
3. Verify deleting multiple categories with records in the palm device results in the corresponding Mozilla ABs being deleted and their cards moved to the Unfiled address book.
4. Verify deleting one empty address book in the Mozilla AB results in the deletion of the corresponding category on the palm device.
5. Verify deleting a Mozilla address book with records results in the corresponding category/records being deleted
6. Verify deleting multiple Mozilla address books with records results in the corresponding categories/records being deleted
7. Verify deleting one category in the palm device and a different address book in the MozAB results in the corresponding address book being deleted with its cards moved to the Unfiled address book and the corresponding category/records being deleted.
8. Verify deleting one category in the palm device and the same address book in MozAB results in the category/address book not appearing on either side but the records/cards should appear in the Unfiled address book.
Verify modified and deleted records/cards in the palm device and the Mozilla Address Book window appear as expected after a HotSync
1. Verify deleting a record in the palm device while modifying the same card in the MozAB results in the modified version present on both sides.
2. Verify deleting a card in the MozAB while modifying the same record in the palm device results in the modified version present on both sides
Verify modified and deleted categories/address books in the palm device and the Mozilla Address Book window appear as expected after a HotSync
1. Verify deleting a category in the palm device while modifying the same address book in the MozAB displays the modified address book on both devices. Currently renaming address books is not possible.
2. Verify deleting an address book in the MozAB while modifying the same category in the palm device results in the modified version present on both sides.
Verify the Palm Sync Desktop application works after uninstalling the Mozilla Address Book Palm Sync
1. Verify the palm profiles appear when starting the palm desktop software
2. Verify a HotSync works between the palm device and the palm desktop software
3. Verify after reinstalling the Mozilla Address Book Palm Sync that the HotSync process works again between the palm device and the Mozilla AB.
Verify no data loss if interruptions occur
1. Verify no data loss when closing the application while a HotSync is in process
2. Verify no data loss if the system shuts down suddenly while a HotSync is in process
Limitations
1. Verify if the Mozilla address book has 16 address books and the palm device has zero that the first 15 address books appear in the palm device.
2. Verify if the Mozilla address book has 13 address books and the palm device has 3 categories that all appear on the palm device except for the last Mozilla AB since the palm device has a 15 category limitation.
3. Verify if a Mozilla address book has an address book with 15 characters that the entire name appears as a category on the palm device.
4. Verify if a Mozilla address book has an address book with more than 15 characters that the name is truncated to 15 characters as a category on the palm device due to the 15 character limitation for categories on the palm device
5. All Netscape fields with the exception of the Notes and Address fields cannot contain multiple lines. Verify when synchronizing, field values on the palm device that contain multiple lines will be changed to single line entries with each line separated by ",".
6. Verify the phone order appears as expected since the user can choose the label for each field on the palm device where as the Mozilla AB has static phone labels.
  1. Verify after entering numbers for each default phone entry that they appear in logical order in the Mozilla AB
  2. Verify after entering numbers for each phone entry and assigning a different label to each that they appear in logical order in the Mozilla AB
  3. Verify after entering numbers for each phone entry where each is assigned the same label (i.e. Home) that they appear in logical oder in the Mozilla AB?
Verify a HotSync with an LDAP directory works as expected
1. Verify an LDAP directory does not appear on the palm device after a Hot Sync?
2. Verify after replicating an LDAP directory (which makes it possible to search for addresses while offline) and a Hotsync that the entries appear on the palm device?
3. Verify editing an LDAP directory on the palm device has no effect on the LDAP directory in the Mozilla AB.
Variations
1. Use a variety of characters when creating records/cards or categories/address books
  1. lower case
  2. uppercase
  3. special characters such as "å"