# Contacts

## What Contacts is for

Contacts is the shared relationship-information list for the people your organisation works with.
Open it from the **Contacts** menu entry to find a contact, start contact creation, or open a saved
contact record.

| If you need to… | Go to |
|---|---|
| Find the shared Contacts list | [Understand the Contacts list](#understand-the-contacts-list) |
| Open a new-contact form or locate the new contact | [Create a contact](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-contact) |
| Review a saved contact record | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) |
| Review contacts associated with a saved sales job | [Contacts, L/Gs, and Last Modifications on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) |

## Before you start

The list is available only when the Contacts module is included in your subscription and a saved list
layout is available for the data grid. The controls also depend on your permissions and on the branch
that owns a row.

| Before list work | What it controls |
|---|---|
| The Contacts module is included in your subscription | The Contacts list is available instead of the subscription-upgrade surface. |
| A saved list layout is available | The data grid appears with its configured columns. |
| Permission to create contacts | **New** appears. |
| Permission to export list data | **Export** is enabled. |
| Permission to delete contacts and a row from your branch | The row's delete action is available. |
| A row from your branch | Selecting a data cell can open the contact edit page. |

## Find the Contacts list

Use the list when you need the shared view rather than a contact's detail page.

**Prerequisites**

- The subscription, list layout, and access conditions in [Before you start](#before-you-start) are in place.

**Steps**

1. Open the application menu.
2. Select **Contacts**.
3. Confirm that the page heading is **Contacts** and that a list is visible.

![The Contacts heading, list, and visible list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3066016f5a358653370bcf3745063cb7.png)

**Result:** The **Contacts** list is open.

## Understand the Contacts list

The list gives you a shared view of contact relationships. Its headers and display settings come from
your organisation's saved layout.

One fixed column identifies the contact with its avatar or identifier. The remaining columns come from
the saved layout, which supplies each column's caption, visibility, data type, filtering, and width.
The current list shows these columns:

| Current column | What you use it to read |
|---|---|
| **Title** | The contact's title. |
| **Name** | The contact's name. |
| **Position** | The contact's position. |
| **Department** | The contact's department. |
| **Account** | The related account. |
| **Branch** | The contact's branch. |

The list has a filter row and header-filter behaviour for narrowing the displayed rows. The screen
does not show a search panel, and the column chooser is disabled. The visible list tools are
**New**, **Refresh**, **Table Layout**, and **Settings**. The new-contact popup is a separate surface,
not an additional set of list columns.

![The current Contacts columns and list tools](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3066016f5a358653370bcf3745063cb7.png)

## Choose the next Contacts action

Select the action that matches your contact task.

**Prerequisites**

- The Contacts list is open.

**Steps**

1. Select the action that matches your task.

   | If you need to… | Select or do this | What opens or happens |
   |---|---|---|
   | Start a contact | Select **New** | The new-contact popup opens. |
   | Open an existing contact | Select a data cell in a same-branch row | The contact edit page opens. |
   | Prepare list data for export | Select **Export** | Export choices open. |
   | Close export choices | Select **Cancel** in the export modal | The export modal closes. |
   | Remove a same-branch contact | Select the row's delete action, then **Delete** | `Are you sure you want to delete this contact?` appears; after a successful delete, the grid reloads. |
   | Stop a deletion | Select **Cancel** in the deletion confirmation | The deletion confirmation closes. |

   ![The new-contact popup opened from the Contacts list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e4c61681c88201597ed68654a24f309d.png)

   ![The export surface with its list export choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bd8de3fea2dade1273ae8141e4339adf.png)

**Caution:** Deleting a contact changes the shared Contacts list. Select **Cancel** instead when you do
not intend to remove the row.

**Result:** The selected contact page or modal opens. When export choices or deletion confirmation
close, you return to the Contacts list.

## When a Contacts action is unavailable

The list and its actions change with subscription, layout, permission, and branch conditions.

| What you see | Condition that explains it |
|---|---|
| A subscription-upgrade surface replaces the Contacts list | The Contacts module is not included in the subscription. |
| The data grid is absent | No saved list layout is available. |
| **New** is absent | Your account does not have permission to create contacts. |
| **Export** is unavailable | Your account does not have permission to export list data. |
| A row delete action is unavailable | You do not have delete permission, or the row belongs to a different branch. |
| Open the contact edit page | Select a data cell in a same-branch row. |

## When a list action goes wrong

If the list shows this message, remove the forbidden characters and repeat the list action:

`Forbidden characters detected. Please remove them and try again.`

Continue on the contact page when the problem concerns the record itself.

| If the problem concerns… | Continue on… |
|---|---|
| A duplicate contact name | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) |
| Saving a contact record | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) |
| Contact permission during record work | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) |
| An invalid email address | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) |
| A contact-record success message | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) |

## What to do next

From the **Contacts** menu entry, use [Create a contact](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-contact) to create or locate a
contact. Use [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) to review a saved contact record. For contacts
connected to a saved sales job, use [Contacts, L/Gs, and Last Modifications on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history).
