{docbook}
<note>
<para>
The <emphasis role="bold">Address Book</emphasis> portlet and its services are deprecated. It remains fully supported for eXo customers, however it will not receive any enhancement and will be removed from the product scope in the future.
</para>
</note>
{docbook}

Before starting to use *Address Book*, you should familiarize yourself with the *Address Book* interface, which has six basic elements.

!images/address_book_interface.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

||Number||Details||
|!images/No1.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Toolbar* allows you to add a new contact/address book, import/export an address book, view and customize the layout.|
|!images/No2.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Action bar* allows quick access to actions on contacts, such as moving, deleting, copying, printing, adding tags to selected contacts.|
|!images/No3.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Contacts list* shows all contacts in a specific address book.|
|!images/No4.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Contact view pane* displays details of the selected contact.|
|!images/No5.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Search pane* which allows you to do the quick and advanced searches to find contacts.|
|!images/No6.png|width="4mm" fo:scalefit="1" html:scalefit="0"!|The *Navigation pane* contains search pane, address books list and tags list.|

The layout can also be customized. You can hide or show specific parts of the *Address Book* interface.
To change the layout, click !images/layout_button.png|width="17mm" fo:scalefit="1" html:scalefit="0"! on the main toolbar, then select the layout you want to hide or display from the drop-down menu.

h1. View contacts {anchor:id="CSUser_guide.How_to_use_Address_book.View_contacts"}
At present, your contacts can be viewed in 2 modes: *List* or *VCards*.

!images/Contact_View_menu.png|align="center" width="200" fo:scalefit="1" html:scalefit="0"!

*List view*:

The list view displays all contacts in the list pane and detailed information of the selected contact in the Contact view pane. On the toolbar, click !images/View_button.png|width="15mm" fo:scalefit="1" html:scalefit="0"!, then select *List* from the drop-down menu.

The contacts are displayed in a list as below.

!images/Contact_List_View_example.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

*VCards view*:

VCard is a file format standard for electronic business cards. It is a powerful new means of Personal Data Interchange that is automating the traditional business card. On the *Toolbar*, click !images/View_button.png|width="15mm" fo:scalefit="1" html:scalefit="0"!, then select *VCards* from the drop-down menu.

The contacts are displayed in separate cards as below:

!images/Contact_Vcard_View_example.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

h1. Create a new contact {anchor:id="CSUser_guide.How_to_use_Address_book.Create_new_contact"}

*1.* Open the *Add/Edit Contact* form by following either of two ways:

*The first way*

Click !images/add_contact_button.png|width="15mm" fo:scalefit="1" html:scalefit="0"! on the *Toolbar*.

*The second way*

Right-click an address book in the *Address Books* pane, then select *Add* from the drop-down menu.

{docbook}
<tip>
<para>
You can also add a new contact from the <emphasis role="bold">Mail</emphasis> application as covered in the <link linkend="Add_new_contact">Add a new contact</link> section.
</para>
</tip>
{docbook}

*2.* Input information into fields of each tab in the *Add/Edit Contact* form.

!images/add_edit_contact.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

*Details:*

*i.* The *Profile* tab

||Field||Description||
|*Asterisk (*)*|This mark next to each field means that it is required to enter values in the field.|
|*First Name*|The first name of your contact which must be between 1 and 40 characters.|
|*Last Name*|The last name of your contact. Its length must be between 1 and 40 characters.|
|*Nick Name*|The nick name of your contact with any unlimited length.|
|*Gender*|Gender of your contact. Simply tick the two available checkboxes: Male or Female.|
|*Birthday*|Birthday of your contact. Click the relevant down arrows to select the day, month and year from the drop-down menu.|
|*Job Title*|The job title of your contact. Its length must be between 0 and 40 characters.|
|*Email*|The email address of your contact.|

{docbook}
  <citetitle>
  <para>
    <emphasis role="bold">Change contact's avatar</emphasis>
  </para>
  </citetitle>
{docbook}

* Click *Update* below the avatar to upload photos from your device.
* Remove your uploaded image by simply clicking *Delete* below the avatar.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Add contact's email address</emphasis>
</para>
</citetitle>
{docbook}

* Enter the email address into the *Email* field. If you want to add more email addresses, simply click !images/plus_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to show another *Email* field.
* Remove your email address by clicking !images/Delete_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"!.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Add contact's instant message information</emphasis>
</para>
</citetitle>
{docbook}

* The *Work* tab

All fields in this tab are optional. In this tab, you can provide the contact's job-related information without any limitations of character types or length.

* The *IM Contact* 

In this tab, you can enter information about the contact chat identity (IM stands for Instant Message). The default text messaging service is the *Chat* application of eXo Platform, but you can select other services by clicking !images/plus_down_arrow.png|width="18" fo:scalefit="1" html:scalefit="0"! to open the drop-down menu.

!images/add_edit_contact_IM.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

* The *Work*, *Home* and *Note* tabs

In these tabs, you can further provide many information related to the contact's work, home and note.

*3.* Click *Save* to accept adding a new contact.

h1. Edit contact details {anchor:id="CSUser_guide.How_to_use_Address_book.Edit_contact_details"}
This function allows you to update information of contacts whenever you like. 

*1.* Right-click your desired contact in the list, then select *Edit* from the drop-down menu. The *Add/Edit Contact* form will appear with the selected contact's current information that is similar when [creating a new contact|#CSUser_guide.How_to_use_Address_book.Create_new_contact].

*2.* Make your desired changes on fields, then click *Save* to accept.

{docbook}
<note>
<para>
You can only edit a contact of your personal and shared address books (if you have the <emphasis role="bold">Edit</emphasis> permission).
</para>
</note>
{docbook}

{docbook}
<tip>
<para>
You can also edit contact details in Mail. For more information, see the <link linkend="Edit_contact_details">Edit contact details</link> section.
</para>
</tip>
{docbook}

h1. Tag a contact {anchor:id="CSUser_guide.How_to_use_Address_book.Tag_contact"}

*The first way*

Right-click the relevant contact, and select *Tag* from the drop-down menu.

*The second way*

Select the contacts by ticking their respective checkboxes, then click !images/tag_contacts_icon.png|width="5mm" fo:scalefit="1" html:scalefit="0"! on the *Action bar*.

!images/tag_contact.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*The third way*

Drag and drop contacts to a specific tag in the *Tags* list in the left pane to open the *Add/Remove Tag* form.

!images/add_remove_tag.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

In this form, you can add a new tag, remove or reassign a tag to a contact.

{docbook}
<tip>
<para>
To add a new tag quickly, click <emphasis role="bold">Add</emphasis> in the <emphasis role="bold">Tag</emphasis> pane.
</para>
<mediaobject>
<imageobject role="html">
    <imagedata fileref="images/tag_panel.png" format="PNG" align="center" scalefit="0" width="50mm"/>
</imageobject>
<imageobject role="fo">
    <imagedata fileref="images/tag_panel.png" format="PNG" align="center" scalefit="1" width="50mm"/>
</imageobject>
</mediaobject>
</tip>
{docbook}


h2. Edit a tag {anchor:id="CSUser_guide.How_to_use_Address_book.Edit_tag"}
*1.* Right-click a tag in the tag area, then select *Edit* from the drop-down menu.

*2.* Make changes in the *Edit Tag* form, then click *Save* to accept your changes.

h2. Delete a tag {anchor:id="CSUser_guide.How_to_use_Address_book.Delete_tag"}
*1.* Right-click a tag you want to delete, then click *Delete* from the drop-down menu.

*2.* Click *OK* in the confirmation to accept your deletion.

h1. Send a mail to a contact {anchor:id="CSUser_guide.How_to_use_Address_book.Send_mail_to_contact"}

{docbook}
<note>
    <para>
    This function allows you to send a mail directly to one or more contacts in your address book. To take this action, you first need to:
    </para>
    <para>Have at least one account in <emphasis role="bold">Mail</emphasis>.</para>
    <para>Have the email address of the contact which you want to send mail.</para>
    <para>Email address of the selected account will be used to send mail to a contact.</para>
</note>
{docbook}

{docbook}
<citetitle>
<para>
<emphasis role="bold">Send a mail to a contact</emphasis>
</para>
</citetitle>
{docbook}

*1.* Open the *Email* function by following either of 3 ways:

*The first way*

Right-click the contact to whom you want to send mail, then select *Email* from the drop-down menu.

*The second way*

Select the contacts that you want to send mail by ticking their respective checkboxes, then click !images/mail_icon.png|width="5mm" fo:scalefit="1" html:scalefit="0"! on the *Action bar*.

*The third way*

Right-click the address book and select *Email* from the drop-down menu. By this way, you will send mail to all contacts in that address book.

The *Send Email* form will appear.

!images/Send_email_form.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Input the recipients' email addresses in the *To* field if needed.

You just need to enter one character included in your desired email address. There will be a list of addresses matching your entered character for you to select quickly.

!images/to_email3.png|align="center" width="250" fo:scalefit="1" html:scalefit="0"!

*3.* Enter the subject and content of your message in the *Subject* field and mail body respectively.

*4.* Click the *Send Mail* button.

h1. Copy/Paste a contact {anchor:id="CSUser_guide.How_to_use_Address_book.Copy_paste_contact"}

This function allows you to make the copies of contacts from an address book and to store in another ones.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Copy a contact</emphasis>
</para>
</citetitle>
{docbook}

*The first way*

*1.* Select contacts by ticking their respective checkboxes.

*2.* Click !images/paste_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the *Action bar*.

*The second way*

{docbook}
<note>
<para>
This way is to copy all contacts of an address book.
</para>
</note>
{docbook}

*1.* Right-click one address book.

*2.* Select *Copy* from the drop-down menu. 

{docbook}
<citetitle>
<para>
<emphasis role="bold">Paste a contact</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<note>
    <para>
    The <emphasis role="bold">Paste</emphasis> action is only activated after your desired contacts have been copied.
    </para>
</note>
{docbook}

*1.* Right-click one destination address book to which you want to move your copied contacts.

*2.* Click *Paste* to accept moving your contacts.

h1. Move a contact {anchor:id="CSUser_guide.How_to_use_Address_book.Move_contact"}
It is simple to move one or more contacts from one address book to another.

*The first way*

Right-click a contact and select *Move* from the drop-down menu.

*The second way*

Select contacts you want to move, then click !images/move_button.png|width="15" fo:scalefit="1" html:scalefit="0"! on the *Action bar*.
 
The *Move Contact* form will appear, allowing you to select a destination address book where your moved contacts are stored.

!images/move_contact.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*The third way*

Use the drag-and-drop function to move one or more contacts to a new address book.

!images/drag_drop_contact.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

The drag-and-drop function is done more easily in the VCards view.

{docbook}
<note>
    <para>
    You can only move contacts of  a personal or shared address book if you have the <emphasis role="bold">Edit</emphasis> permission. You cannot move contacts in the address book which you do not have the <emphasis role="bold">Edit</emphasis> permission or contacts in a public address book.
    </para>
</note>
{docbook}

h1. Delete a contact {anchor:id="CSUser_guide.How_to_use_Address_book.Delete_contact"}
*The first way*

*1.* Right-click a contact you want to remove, then select *Delete* from the drop-down menu.

*2.* Click *OK* in the confirmation message to accept your deletion.

*The second way*

{docbook}
<note>
<para>
This way allows you to delete multiple contacts.
</para>
</note>
{docbook}

*1.* Tick checkboxes corresponding to contacts you want to delete, then click !images/Delete_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the *Action bar*.

*2.* Click *OK* in the confirmation message to accept your deletion.

h1. Export contacts {anchor:id="CSUser_guide.How_to_use_Address_book.Export_contacts"}
This feature allows you to export one or more contacts into a file to be used in another address book applications. These exported contacts will have the same information in all address books you use. You can export a single contact or multiple contacts flexibly.

*1.* Right-click one contact, or address book if you want to export all contacts of the address book, then select *Export* from the drop-down menu.

The *Export Address Books* form will appear.

!images/export_contacts.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

*2.* Select contacts to export by ticking their respective checkboxes.

*3.* Enter the file name and select the export format. At present, only *x-vcard* is supported.

*4.* Click *Export All* to export all contacts in all pages; 

Or, click the *Export Selected Only* button to export your selected contacts only.


h1. Import contacts {anchor:id="CSUser_guide.How_to_use_Address_book.Import_contacts"}
This function allows you to import one or more contacts from your device to a selected address book.

*1.* Open the *Import Contacts* form via either of the following ways:

*The first way* 

Click !images/import_button.png|width="15mm" fo:scalefit="1" html:scalefit="0"! on the toolbar.

*The second way*

Right-click a personal or shared address book which you have the *Edit* permission, then click *Import* from the drop-down menu. By this way, you can quickly select the destination address book for the imported contacts.

!images/import_contacts.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Click !images/down_arrow_icon1.png|width="4mm" fo:scalefit="1" html:scalefit="0"! in the *Address Book* field, then select your desired address book into which you want to import your contacts from the drop-down menu;

Or, click !images/plus_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to quickly create a new address book. 

*3.* Select the file format in the *Import Format* field. At present, only *x-vcard* is supported.

*4.* Click *Browse...* to open the *File Upload* form.

*5.* Select the file you want to import from your device, then click *Open* to upload your selected file.

*6.* Click *Save* to finish your import.

h1. Print contacts {anchor:id="CSUser_guide.How_to_use_Address_book.Print_contacts"}
The *Print* function allows you to print information of your selected contacts. You can print one or more contacts at the same time.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Print one contact</emphasis>
</para>
</citetitle>
{docbook}

*1.* Right-click the contact you want to print, then select *Print* from the drop-down menu.

The single Contact Print Preview will appear with the detailed information:

!images/detailed_information.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

*2.* Click the *Print* button to print.

{docbook}
<note>
<para>
When you are in the <emphasis role="bold">VCards</emphasis> view, the print process is a quite different. You first need to click <emphasis role="bold">View Details</emphasis> to display the contact's details. After that, click <emphasis role="bold">Print Preview</emphasis> to open the Preview page, then select the <emphasis role="bold">Print</emphasis> button.
</para>
</note>
{docbook}

{docbook}
<citetitle>
<para>
<emphasis role="bold">Print multiple contacts</emphasis>
</para>
</citetitle>
{docbook}

*1.* Select contacts you want to print by ticking their respective checkboxes, then click !images/print_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the *Action bar*.

!images/print_contacts.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

The *Print Preview* page will appear with their summary information.

!images/print_preview.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

*2.* Click *Print* to print information of your selected contacts.

h1. Print an Address Book {anchor:id="CSUser_guide.How_to_use_Address_book.Print_address_book"}
This function allows you to print the summary information of contacts in form of name cards. You can also print all contacts in an address book at the same time.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Print an address book</emphasis>
</para>
</citetitle>
{docbook}

*1.* Right-click the address book which you want to print, and select *Print* from the drop-down menu.

The *Print Preview* page will appear.

!images/print_preview1.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

*2.* Click *Print* to start printing.

h1. Share contacts {anchor:id="CSUser_guide.How_to_use_Address_book.Share_contacts"}
This function allows you to share contacts with other users or groups. The shared users/groups may have *View* or *Edit* permissions on the shared contacts.

* The *View* permission allows users to view, copy, export, print, delete but cannot move your shared contacts. The shared users cannot make changes on the information of the shared contacts or move your shared contacts if they only have the *View* permission.

* The *Edit* permission allows users to view, copy, export, print, move, delete and edit the shared contacts. If you have the *Edit* permission on the shared contacts, you can share them with another users.

{docbook}
<note>
    <para>
    The shared users can move or delete the shared contact only from their address books. It means that the shared contact still exists in the <emphasis role="bold">Shared</emphasis> address book of another shared users and of the creator/author. 
	The shared contact will be permanently deleted in the <emphasis role="bold">Shared</emphasis> address books of the shared users or cannot be shared with other users if it is removed by the creator/author.
    </para>
</note>
{docbook}

{docbook}
<citetitle>
<para>
<emphasis role="bold">Share contacts with other users</emphasis>
</para>
</citetitle>
{docbook}

*1.* Right-click the contact you want to share, then select *Share* from the drop-down menu;

Or, drag and drop this contact to the *Shared* address book in the *Address Books* pane.

The *Share a contact with other users* form will appear. {anchor:id="Share_contact_with_other_users_form"}

!images/Share_contact_with_others_form.png|align="center" width="80mm" fo:scalefit="1" html:scalefit="0"!

*2.* Select users or groups that you want to share. {anchor:id="Share_selected_users_and_groups"}

*i.* Click !images/user_selector_icon.png|width="10" fo:scalefit="1" html:scalefit="0"! to open the *User Selector* form;

!images/user_selector.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

In this form, tick the checkboxes corresponding to your desired users, then click *Add*. Also, you can use the *Search* function to look for your desired users quickly.

*ii.* Or, click !images/group_selector_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to open the *Group Selector* form.

!images/group_selector.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

In this form, select the group in the left pane, and its child group in the right pane.

*3.* Tick the *Edit Permission* checkbox if you want to grant the edit permission to your selected users or groups.

The shared users/groups will be updated in the Shared Users/Groups table of the [Share a contact with other users|#Share_contact_with_other_users_form] form.

* Click !images/print_icon.png|width="5mm" fo:scalefit="1" html:scalefit="0"! if you want to change the *Edit* permission of specific users/groups. Click !images/remove_icon1.png|width="5mm" fo:scalefit="1" html:scalefit="0"! to remove the shared users/groups.

*4.* Click *Save* to accept your sharing.

h1. Search for contacts {anchor:id="CSUser_guide.How_to_use_Address_book.Search_for_contacts"}

This function allows you to find contacts easily and quickly via two search modes: [Quick search|#CSUser_guide.How_to_use_Address_book.Quick_search] and [Advanced search|#CSUser_guide.How_to_use_Address_book.Advanced_search].

h2. Quick search {anchor:id="CSUser_guide.How_to_use_Address_book.Quick_search"}
This function allows you to do a quick search with specific keywords in all your contacts. All contacts having the text matching your search term will be displayed in the *Search Result* dialog.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Do a quick search for contacts</emphasis>
</para>
</citetitle>
{docbook}

*1.* Enter your search term in the *Search* textbox in the left pane.

*2.* Click !images/search_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to perform your search.

Your search results will be displayed in the right *Search Result* pane.

h2. Advanced search {anchor:id="CSUser_guide.How_to_use_Address_book.Advanced_search"} 
With this mode, you can refine your search by using a variety of criteria. Your search results will be limited as follows:

*1.* Click !images/advanced_search_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! next to the search box to open the *Advanced Search* form.

*2.* Define your search criteria. You can set the search criteria by: Text, Full Name, First Name, Last Name, Nick Name, Job Title, Email and Gender.

*3.* Click the *Search* button to search. All contacts matching your criteria will be shown in the *Search Result* dialog.

h1. Manage Address Books {anchor:id="CSUser_guide.How_to_use_Address_book.Manage_address.book"}
By default, there are 3 Address Book categories:

* *Personal* contains contacts/address books which are created by yourself. Each group may contain more than one contact.
** *My Contacts* is the default group which contains your own default contact generated from your registration information.
** *Collected Addresses* contains all contacts with information updated automatically when you send any message to a new email address from the Mail, Address Book and Calendar applications. That is, when you send an email to a new address, this address will be automatically added to *Collected Addresses*.
* *Shared* contains contacts/address books which have been shared with you by another users. You can view and update the shared contacts if you are granted the *Edit* permission.
* *Public Groups* contains address books of groups to which you belong. Each group contains all default contacts of group members that can be viewed only.


h2. Create an address book {anchor:id="CSUser_guide.How_to_use_Address_book.Create_address_book"}

*1.* Open the *Add/Edit Address Book* form via one of the following ways.

*The first way*

Click !images/address_book_button.png|width="17mm" fo:scalefit="1" html:scalefit="0"! on the *Toolbar*.

*The second way*

Click !images/Down_arrow_addressbook_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! in the *Address Book* pane, and select *Add* from the drop-down menu.

!images/add_contact.png|align="center" width="40mm" fo:scalefit="1" html:scalefit="0"!

*2.* Type name and description for your new address book in the *Name* and *Description* fields respectively in the *Add/Edit Address Book* form. {anchor:id="Add_edit_address_book_form"}

!images/add_edit_address_book.png|align="center" width="100mm" fo:scalefit="1" html:scalefit="0"!

*3.* Click *Save* to accept adding your address book.

{docbook}
<tip>
    <para>
    You can also create a new address book from <emphasis role="bold">Mail</emphasis>. For more information, see the <link linkend="Add_address_book">Add a new address book</link> section in <emphasis role="bold">Mail</emphasis>.
    </para>
</tip>
{docbook}

h2. Edit an address book {anchor:id="CSUser_guide.How_to_use_Address_book.Edit_address_book"}

*1.* Right-click an existing address book, and select *Edit* from the drop-down menu.

*2.* Make changes on information of your address book in the [Add/Edit Address Book form|#Add_edit_address_book_form].

*3.* Click *Save* to accept your changes.

{docbook}
<note>
    <para>
    You can only edit a Personal or Shared address book that you have the <emphasis role="bold">Edit</emphasis> permission. You cannot edit a Group address book.
    </para>
</note>
{docbook}

h2. Remove an address book {anchor:id="CSUser_guide.How_to_use_Address_book.Remove_address_book"}
*1.* Right-click an existing address book, then select *Delete* from the drop-down menu.

*2.* Click *OK* in the confirmation message to accept your deletion.

{docbook}
<note>
    <para>
    You cannot delete your default and group address books.
    </para>
</note>
{docbook}



h2. Export an address book {anchor:id="CSUser_guide.How_to_use_Address_book.Export_address_book"}
*1.* Open the *Export Address Books* form via one of the following ways.

*The first way*

Click !images/export_button.png|width="15mm" fo:scalefit="1" html:scalefit="0"! in the *Toolbar*.

*The second way*

Click !images/Down_arrow_addressbook_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! in the *Address Books* pane, and select *Export* from the drop-down menu.

The *Export Address Books* form will appear with a list of all existing address books.

*2.* Tick checkboxes corresponding to address books that you want to export. If you want to select all the address books, tick the checkbox next to *Name*.

*3.* Enter the file name in the *Name* field, and select the export format from the *Export Format* form. At present, only *x-vcard* is supported.

*4.* Click *Export All* to start exporting all the address books or click *Export Selected Only* to export your selected ones only.


h2. Import an address book {anchor:id="CSUser_guide.How_to_use_Address_book.Import_address_book"}
Once you have exported your address books, you can retrieve them easily at any time. Others can also import your address book to store in their address book. The process to import address books is simple as exporting address books.

*1.* Open the *Import Address Books* form via one of the following ways.

*The first way*

Click the *Import* button in the *Toolbar*.

*The second way*

Click !images/Down_arrow_addressbook_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! in the *Address Books* pane, then select *Import* from the drop-down menu.

The *Import Address Books* form will be displayed.

!images/import_address_books.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Select the address book which stores your imported address book contact from the *Address Book* drop-down menu; 

Or, click !images/plus_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to [create a new address book|#CSUser_guide.How_to_use_Address_book.Create_address_book]. 

*3.* Select the import format. At present, only *x-card* is supported.

*4.* Click *Browse...* to open the *File Upload* form. 

*5.* Select the address book file to import from your device, then click *Open* to upload your selected file.

*6.* Click *Save* to finish. You will see a notification of your successful import on the top right corner.

h2. Share a personal address book {anchor:id="CSUser_guide.How_to_use_Address_book.Share_personal_address_book"}

This feature allows you to share personal address books with specific users or groups. The shared users/groups can view, export, add, edit or delete a shared address book (if they have the *Edit* permission). The shared address book is distinguished from other address books by a hand symbol.

!images/Shared_address_book.png|align="center" width="50mm" fo:scalefit="1" html:scalefit="0"!

*1.* Right-click the address book you want to share, and select *Share* from the drop-down menu.

The *Share an Address Book with other users* form will appear. {anchor:id="Share_Address_Book_form"}

!images/Share_Address_book_form.png|align="center" width="80mm" fo:scalefit="1" html:scalefit="0"!

*2.* Select users or groups that you want to share. For more details, see [here.|#Share_selected_users_and_groups]

* The shared users/groups will be updated in the Shared Users/Groups table of the [Share an Address Book with other users|#Share_Address_Book_form] form.
* Click !images/edit_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to change the *Edit* permission or !images/remove_icon1.png|width="4mm" fo:scalefit="1" html:scalefit="0"! to remove specific users/groups from the Share Users/Groups table.

*3.* Tick the *Edit Permission* checkbox if you want to grant the *Edit* permission to your selected users/groups. 

*4.* Click *Save* to finish. 

h2. Grant permissions on a public address book {anchor:id="CSUser_guide.How_to_use_Address_book.Grant_permissions_public_address_book"}

You can grant the *Read/Manage* permission on your managed public address books to specific users, groups or memberships.

* A user with the *Read* permission can see the address book.

* A user with the *Manage* permission can view/edit/rename and manage permissions on the address book.

By default, any member of a group has the *Read* permission and the group manager has the *Manage* permission.

{docbook}
<citetitle>
<para>
<emphasis role="bold">Grant a permission on a public address book</emphasis>
</para>
</citetitle>
{docbook}

*1.* Right-click your managed public address book, and select *Permission* from the drop-down menu.

The *Permissions* form appears.

!images/Permissions_form.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

*2.* Select certain users or groups you want to grant permissions. For more details, see [here.|#Share_selected_users_and_groups]

*3.* Tick the *Can manage?* checkbox if you want to grant the *Manage* permission to your selected users/group.