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 Specification

Feature Test Spec: Mail and News Component

Mail and News Component: Address Book/General

Written by Esther Goes, Fenella Gor, Ninoschka Baca

References:

UI Specification: Address Book UI Specification
Other: How To Create Address Books, Cards, Lists, Directories, etc.

Address Book
Managing Address Books
Address Book
1. Visual - Verify the Address Book as the following:
  1. Window Title "Address Book" and a close "X" button
  2. Window is resizable and moveable
  3. Menubar (see Sea-Monkey Messenger Address Book for Menubar lists)
  4. Toolbar (see Sea-Monkey Messenger Address Book Toolbar buttons) Note: Search button disabled unless LDAP Directory selected.
  5. Directory (Address Book) pane
    1. Two Local Address Book: Personal Address Book" and the "Collected Addresses.
      1. Personal Address Book is the user's default Address Book
      2. "Collected Addresses" address book is associated with the "Email Address Collection" feature
    2. Users are able to create additional Local Address Books as desired
    3. A separator bar
    4. This pane should display a scroll bar if contents does not fit in pane.
  6. Results Pane (upper right side of Address Book window)
    1. Displays a list of cards and lists for the selected Address Book
    2. Default columns include: "Name" "Email", "Work Phone", "Organization" and "ScreenName".
    3. Should display a scroll bar if contents does not fit in pane.
  7. Card View Pane (lower right side of Address Book window)
    1. Displays the contents of the selected card.
    2. Title for the Card "Card for (name or person goes here)" in large bold font.
    3. Should display a scroll bar if contents does not fit in the pane.
    4. Should display a buddy icon for screen names (requirements: screen name is present, an email is present and an IM is sent between the recipients to see the buddy icon appear)
2. Points of Entry
  1. "Address Book" icon in the Task bar within the "Quick Access" area included in each of the components (Navigator, Messenger)
  2. "Address Book" menu item listed under "Tasks" from each of the components (Navigator, Messenger, Address Book etc)
  3. "Address" button on Toolbar of Mail Composition window
3. Functionality
  1. Verify the Address Book pane can be collapsed and expanded using vertical split bar.
  2. Verify the Card View pane can be collapsed and expanded using the horizontal split bar.
  3. Verify the lists in the left pane can be collapsed and expanded using the expand/collapse icons (right arrow/downward arror) located to the left of the Address Book.
  4. Verify that <Tab> will change the focus to the next logical control as follows:
    1. Directory Pane-Address Book at top of the list
    2. Results Pane-Card at the top of the list
    3. Card View Pane (links in the pane in this order down left side, then down right side)
  5. Verify the Address Books, expanded Lists and subscribed LDAP Directories are displayed in the Directory pane
  6. Verify the drag and drop action for Card(s) and List(s)
    1. right pane-Card(s) to List=copy
    2. right pane-Card(s) to left pane-Address Book=copy
    3. right pane-Card(s) to left pane-List in the same address book=copy
    4. right pane-Card(s) to left pane-List in a different address book=copy
    5. either pane-List(s) to any List or Address book=copy
  7. Verify the Command/Control Key action for Card(s) and List(s) (This is known as the using the modifier key, Windows uses Shift+drag)
    1. right pane-Card(s) to List=move
    2. right pane-Card(s) to left pane-Address Book=move
    3. right pane-Card(s) to left pane-List in the same address book=move
    4. right pane-Card(s) to left pane-List in a different address book=move
  8. Verify the functionality in Directory Pane
    1. single click on Address Book=selects the address book and displays the contents of the Address Book in the Results list
    2. double click on Address Book=Brings up Address Book Information
    3. double click on a Directory=brings up the Directory Server Informatin dialog which can be edited
    4. single click on mailing list=selects the mailing list and displays the mailing lists in the Results pane
    5. double click on mailing list in the Result pane=brings up the mailing list Mailing List dialog which can be edited
    6. single click on Directory=selects the directory, and displays either nothing or the last set of search results in the results list
    7. Control+Click(Win/X)=select a discontinuous group of Address Books/Lists and Directories, highlights the selection leaves Results pane and Card View pane alone with the last view still visible.
    8. Shift+Click=selects a contiuous group of Address Books/Lists and Directories, highlights the selection leaves Results pane and Card View pane alone with the last view still visible.
    9. Option+Click or Extended Press and Hold (Mac), Right Mouse Click (PC & Unix)= popup context menu for Address Book, List or Directory or list base on what was selected at the time of right mouse click (see Sea-Monkey Messenger Address Book spec listed above for menu list)
  9. Verify the functionality in Results Pane
    1. single click on a card= selects a single card and displays the detailed information in the Card View pane
      - verify this view only shows headings that contains information that the user has previoulsy entered (each card may display different headings)
      - verify this view only allows user to click a link to bring up a New Msg window, you cannot edit the information on the card in this view
    2. double click on a card=opens the "Card Dialog - Display" in a separate window for the card that was selected.
    3. single click on a mailing list=selects the mailing list
    4. double click on mailing list=brings up the mailing list Mailing List dialog which can be edited
    5. Control+Click(Win/X)=select a discontinuous group of cards/mailing lists and Card View pane displays nothing
    6. Shift+Click=selects a contiuous group of cards/mailing lists and Card View pane displays nothing
    7. Right Mouse Click = popup context menu for card or list base on what was selected at the time of right mouse click (see Sea-Monkey Messenger Address Book spec listed above for menu list)
    8. single click on a card with a screen name, select the IM button and verify the IM compose window appears prefilled with the screen name.
    9. select more than one card, each having a screen name, select the IM button and verify a chat process initiates.
  10. Verify the functionality in the Card View Pane
    1. Double click on a card in the result pane.
      1. Verify it opens a card dialog.
    2. Verify this dialog only shows headings of the card.
    3. Verify that user cannot edit the information on the card in this Display Window
    4. Verify Card pane can be collapsed by dragging the separator bar.
    5. Verify that data entered in the Card displayed in the card view pane.
    6. Click on email address.
      1. Verify that compose window opens with address fill in.
      2. Verify compose window has focus
    7. Click on URL link.
      1. Verify that browser window opens with URL displayed. Verify Address Book opens but browser window has focus
    8. Click on Screen name.
      1. Verify IM compose window opens with screen name filled. Address still opens but IM compose window has focus.
  11. Verify functionality in Card Dialog - Display ( lower right side)
    1. This dialog only shows headings
    2. Click on the Edit button = brings up the Card Dialog - Edit Mode
    3. Click on the Close button = closes the window
    4. Click on X widget to close the dialog
    5. Enter Name, Address, Inst Msg and Other into the card
      1. Verify info are displayed in the card view pane.
  12. Verify layout and functionality in Card Dialog - Edit Mode
    1. New card dialog can be launched:
      - In Address Book, From File->New Address Book Card
      - From Toolbar button, click on Edit (field has data)
      - From Address Book Menu item - New Card
      - From Address book, Menu Item, Edit-> Car Properties
      - From a stand alone Message Window imder Message menu list) - "Add Address to Address Books..."
      - Verify New Card if there is no match,
        
        Or existed card be prompted -should the card be updated.
      - From a stand alone Message Window under Message menu list) - Add All to Address Book..."
      - Verify New Card if there is no match,
        
        Or existed card be prompted -should the card be updated.
      - Context menu - New Card/Edit
      - Directory pane, selection on an Address Book, Mailing list or Directory (click New Card)
        
        Results pane, card or mailing list is selected - Edit Card
        
        Card View pane, double-click anywhere on the pane
    2. Verify layout for the Card Dialog - Edit mode is the same for both a New Card or Editing an existing Card (with exceptions noted below in first two bullet items *)
      - * New Card dialog has a title bar with the title "New Card". The title is completed with the Display name after clicking OK on the card. Existing card title "Card for [Display Name]". Also has a close "X" button
      - * For a New Card only, there is an "Add Card to:" drop down menu. This menu is not available for a card in Edit mode, it is replaced with static text "Location: [Name of Address Book where card is located]".
      - Verify dialog has a set of tabs in which the user can add information about a contact. The tabs include: Name, Address & Other.
      - Verify all fields for each Tab are active text entry fields.
      - Dialog OK, Cancel and Help buttons
      - Verify correct headings in Bold for each section on the tab.
      - Verify the Tab name is in Bold for the tab that has focus
    3. Verify functionality of text entry fields located on each Tab.
  13. Verify initial state when an address book directory is selected and the state after selection
    1. for an Address Book
      - Verify the first name is selected in the list when a personal address book is first selected
      - Verify that what was previously viewed in an address book, appears in the results pane when that address book is selected again in the same session
Managing Address Books
1. Placement of Added or Edited Cards
  1. A newly created Card should be listed in the Results pane, when the Address Book it was added to, is selected
  2. A newly created Card should be listed in the Results pane according to the Sort order of the Address Book at the time it is added. (Example, if sort order is by email|ascending and you add a card with the name AAA and an email address zzz@nowhere.com, this card should be placed at the bottom of the list in the Results pane.
  3. A newly created card that is added to the Address Book that is selected in the Directory pane, should display immedialtely in the Results pane.
  4. A newly created Card that is added to an Address Book that is not selected in the Directory pane, should display in the Results pane only when that address book is selected
  5. An edited Card should change location in Results pane immediately, if the change is in the field the list is sorted by.
2. Adding Cards using the Email Address Collection Feature
  1. Verify in the Preferences for the Mail & Newsgroups|Addressing panel that the checkbox to Add email addresses to the Personal Address Book is selected by default.
    1. Verify sending a message places the recipients email address in the Personal Address Book
  2. Verify changing the Email Address Collection feature works when it uses the Collected Address Book instead of the Personal Address Book. When sending a message the recipients email address should be placed in the Collected Address Book.
  3. Verify changing the Email Address Collection feature works when it uses a user defined address book. When sending a message the recipients email address should be placed in the user defined address book.
3. Adding and Editing Lists (for basic information on how to create a list see link above on How to Create...)
  1. Verify layout of a New List
    1. Verify the dialog title "Mailing List" and a close "X" button
    2. Verify this dialog is moveable and resizable
    3. Verify the dialog consists of the following:
      - Verify the "Add to:" pop-up" list defaults to the Personal Address Book at the top for the list in the Directory pane.
      - List Name
      - List Nickname
      - Description
      - List Bucket titled "Type names or drag addresses into the mailing list below
      - Stop button
      - Remove button
      - Up and Down arrow buttons for reordering names in List bucket
      - Action buttons (OK,Cancel,Help)
      - Status bar indicating Secure and Online/Offline
    4. Verify the placement of the List dialog when New List is selected or Edit|Properties is selected when a list is to be edited
      1. New List - placement is to the right of the Address Book window
      2. Editing a List - placement is to the right of the Address Book window
    5. Verify the placement of the List in Address Book Window
      - Creating a List while a mailing list is selected in the Directory pane=the new list will appear in the Directory pane (in alphabetical order) under the Address Book where the currently selected list is located (even though it is a sub-list). It will also show in the Results pane as part of the content for the selected list .
      - Creating a List when an address book is selected=the new list will appear under the address book that it was created in and in the Results pane
    6. Verify placement of names in a new list is in order of entry.
    7. Verify order of names on list can be changed using the Up and Down arrow. Verify this order is save after closing the application and reopening it.
    8. Verify a message addressed to a list, sends the message with the names in the addressing field in the order as they appear on the list.
  2. Adding data to a New List
    1. Verify you can change to another Address book using the pop-up list and the list is saved in the target Address book selected.
    2. Enter data for a List Name
      1. verify valid names (unique name for selected Address Book) are accepted.
      2. verify invalid names (non-unique for selected Address Book) are not accepted an gives proper error message
    3. Enter data for a List Nickname
      1. verify valid names work
      2. verify invalid names (non-unique for selected Address Book) gives proper error message
    4. Enter data for the Description
      1. valid description
      2. verify there is no invalid description
    5. Enter no data in any field, OK, verify you get an error message "You must enter a list name". Note:You can not save this list with no name.
    6. Enter long lines of data in various fields, OK card, open this card to verify data was saved, no truncation, no crash.
    7. Enter data in various fields, check the HTML box, OK, open this card to verfiy the HTML box is still checked.
    8. Enter data in various fields, Cancel, verify this card was not created
      - Description
      - valid description
        
        verify there is no invalid description
    9. Verify the placement of the List in Address Book Window
      - Creating a List while a mailing list is selected in the Directory pane=the new list will appear in the Directory pane (in alphabetical order) under the Address Book where the currently selected list is located (even though it is a sub-list). It will also show in the Results pane as part of the content for the selected list .
      - Creating a List when an address book is selected=the new list will appear under the address book that it was created in and in the Results pane
    10. Verify order of names on list can be changed using the Up and Down arrow. Verify this order is save after closing the application and reopening it.
    11. Verify a message addressed to a list, sends the message with the names in the addressing field in the order as they appear on the list.
  3. Editing a List
    1. Verify that from the Directory and Results pane you can select and edit a list by clicking the Edit button on the toolbar
    2. Verify Edit and OK works and it is saved.
    3. Verify Edit and Cancel works and it doesn't save the changes
4. New Msg:
  1. Verify that when click on New Msg, it brings up a Compose window that contains a
    1. populated email address in the To field if email address is selected.
    2. populated mail list in the To field if mail list is selected.
5. Moving Cards and Lists
  1. Verify that you can drag and drop from pane to pane (see Drag and Drop section above)
  2. Verify that you can drag and drop to/from Address Book (see Drag and Drop section above)
  3. Verify that you can drag and drop a person's name from a Directory to an Address Book (see Drag and Drop section above)
6. Deleting Cards and Lists
  1. Verify you can delete a Card in top level of an Address Book using the following, verifying the card is removed from the Address Book. Cards are only listed in the Results pane.
    1. Menu item (Edit/Delete Card) single selection
    2. Menu item (Edit/Delete) multiple selections
    3. Toolbar Delete button
    4. Accelerator Key
    5. Mnemonic
  2. Delete a Card on a mailing list using the following:
    1. verify the card is removed only from the selected mailing list. (Note: if user upgraded or imported from 4.5x, cards will be in both the Address Book and lists as they were in 4.5x. However, unlike 4.5x when cards are deleted from lists using 5.0 they are not going to be deleted from the Address Book too.) Cards are only listed in the Results pane.
      1. Menu item (Edit/Delete) single selection
      2. Menu item (Edit/Delete) multiple selections
      3. Toolbar Delete button
      4. Accelerator Key
      5. Mnemonic
  3. Deleting a List from the Directory pane:
    1. Menu item (Edit/Delete) single selection
    2. Menu item (Edit/Delete) multiple selections
    3. Toolbar Delete button
    4. Accelerator Key
    5. Mnemonic
  4. Deleting a List from an Address Book that is displayed in the Results pane:
    1. Menu item (Edit/Delete) single selection
    2. Menu item (Edit/Delete) multiple selections
    3. Toolbar Delete button
    4. Accelerator Key
    5. Mnemonic
  5. Deleting a List from the Results pane when it is the child of a selected lists in the Directory pane using:
    1. Menu item (Edit/Delete) single selection
    2. Menu item (Edit/Delete) multiple selections
    3. Toolbar Delete button
    4. Accelerator Key
    5. Mnemonic
7. Creating and Editing Address Books (for basic information on how to create an Address Book see link above on How to Create...)
  1. Create a New Address Book using File|New Address Book
    1. Verify the dialog title "New Address Book"
    2. Verify the dialog layout contains the following :
      - "Name" text field
      - Action buttons (OK, Cancel)
    3. Verify valid names (unique) are accepted
    4. Verify invalid names (not unique) gives a prompt "You already have an address book or directory with this name. Please enter a different name."
    5. Verify OK works, by typing in a unique name then clicking "OK" , new address book should be listed in left (Directory) pane.
    6. Verify the placement of the Address books are listed below the topmost address book or directory in left (Directory) pane.
    7. Verify Cancel works, by typing in a unique or non-unique name, then clicking Cancel. Valid name should not show up anyplace in Address book. Canceling an Invalid name should not remove the name that was unique to the invalid name.
    8. Verify Address books and Directories are reorderable.
  2. Editing an Address Book
    1. Verify you can select an address book for editing.
    2. Verify you can open the address book properties using: right mouse click|Properties, Edit toolbar button, Edit|Properties from menu bar and double clicking on selected address book.
    3. Verify valid names (same as above)
    4. Verify invalid names give a prompt (same as above)
    5. Verify OK works, by typing in a new unique name then clicking "OK" , newly named address book should be listed in left (Directory) pane in same place as before edit.
    6. Verify Cancel works, by typing in a unique or non-unique new name, then clicking Cancel. Address book name should not change.
8. Deleting Address Books selected in the Directory pane using:
  1. Menu item
  2. Toolbar Delete button
  3. Accelerator Key
  4. Mnemonic
  5. For each of the above verify you get a prompt:
    1. Verify OK will delete the selected address book.
    2. Verify Cancel does not delete the address book or any of it's cards or mailing lists.
    3. Verify that you are not allowed to delete the Collected and Personal address books.
9. Result pane functionality
  1. Verify that Result pane contains the following headings:
    1. Name
    2. Email
    3. Work Phone
    4. Organization
    5. ScreenName
  2. Verify that you can resize the column headings
  3. Verify that after exit and relaunch, column heading width sticks.
  4. Verify that you may sort each of the columns
  5. Verify that when you sort, the upward and downward arrow exists in the column heading.
10. Adding a New Directory using the menu item New Directory, includes: Visual layout of dialog, Offline settings and functionality of Action buttons. (this is covered in the LDAP test spec, LDAP Test Spec)
11. Editing an existing Directory (this is covered in the LDAP test spec, LDAP Test Spec)
12. Removing a Directory listing from Directory pane (this is covered in the LDAP test spec, LDAP Test Spec)
Gray area means feature is not available.

Mozilla

Feature Test Spec: Mail and News Component

Mail and News Component: Address Book/General

References:

Contents

Address Book

Managing Address Books