# Contact record

A contact record stores the information your organisation uses to identify and communicate with a person.
Use it to review the person's main information, add communication details, maintain the contact image, and
review related record areas when they are available.

## Contact records at a glance

The record belongs to the **Contacts** area, which is the starting point for finding an existing contact
and opening its saved record. Its main information includes **Title**, **Name**, **Position**, **Department**,
and **Account**.

You can add communication fields through **Contact Details**, maintain the image, and use the saved-record
tabs **Attachment** and **Last Modifications** when the record has an identifier and the form is not a
popup.

| If you need to… | Go to |
|---|---|
| Find an existing contact | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview) |
| Open and interpret a saved contact record | [Understand the record information](#understand-the-record-information) |
| Change contact information and remain on the record | [Edit and save contact information](#edit-and-save-contact-information) |
| Add communication details or maintain the image | [Manage contact details and the image](#manage-contact-details-and-the-image) |
| Review files linked to the record | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) |
| Create a contact instead of changing a saved record | [Create a contact](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-contact) |

## Before you open or change a record

The contact identifier determines whether the form loads a saved record and whether the saved-record tabs
are available. The subscription and editability state determine which parts of the surface you can use.

| Condition | What you see or can do |
|---|---|
| The Contacts subscription is included | The contact form is available. |
| The subscription does not include Contacts | A subscription-upgrade surface replaces the form. |
| The saved contact identifier is absent or zero | The form initializes a new contact and loads the account lookup. |
| The saved contact identifier is present | The saved contact loads and **Name** uses the saved-contact text field. |
| The form is read-only | Editing controls are disabled or hidden. **Save**, **Save and Close**, and **Contact Details** are unavailable. |
| The contact has no identifier, or the form is opened in a popup | **Attachment** and **Last Modifications** are unavailable. |

Before changing a record, confirm that it is saved and editable, and that the contact name and account
information are ready. Select an account from the choices shown by **Account**.

## Find and open a contact record

The Contacts list is where you locate an existing contact before opening its saved record. After you open
the record, review its fields before choosing the part of the record you need.

**Prerequisites**

- You are in the **Contacts** area.
- The contact already exists as a saved record.

**Steps**

1. In the Contacts work list, locate the saved contact you need to review.
2. Open the contact from the list.
3. Confirm that the contact-record surface shows **Title**, **Name**, **Position**, **Department**, and
   **Account**.

**Result:** The saved contact record shows its contact fields and save controls. Continue with [Understand
the record information](#understand-the-record-information) to interpret the fields.

## Understand the record information

The main form identifies the contact and relates the person to an account. On a saved record, **Name** is
shown as a text field. On a new contact, **Name** uses an autocomplete or text entry.

| Field | Required marker on the main surface | Use |
|---|---:|---|
| **Title** | No | Enter the person's title. |
| **Name** | Yes | Identify the contact. |
| **Position** | No | Enter the person's position. |
| **Department** | No | Enter the person's department. |
| **Account** | Yes | Select the account related to the contact. |

**Name** and **Account** show required markers on the main surface. **Title**, **Position**, and
**Department** do not show required markers there. After reviewing these fields, continue with [Edit and
save contact information](#edit-and-save-contact-information) when you need to change them.

![Required markers beside Name and Account on the main form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/94c1eebee799640767cbb6035b23c1e0.png)

## Edit and save contact information

After reviewing the fields, change the saved contact when needed. The next section covers communication
details and the image.

**Prerequisites**

- The saved contact is open.
- The form is editable.
- **Name** and **Account** contain valid values.

**Steps**

1. In the main form, change one or more of **Title**, **Name**, **Position**, **Department**, or **Account**.
2. If you changed **Name**, use a name that is not already assigned to another contact.
3. Select the save destination that matches your next task.

   | If you need to… | Select |
   |---|---|
   | Continue working on the record | **Save** |
   | Leave the record | **Save and Close** |

4. Check the result message before continuing.

When the save succeeds, the page reports `Contact saved successfully`. The common completion message is
`Your request was completed successfully`. If the save returns a server failure, the page reports `Error:
Server Error`. If the name conflicts during save, it reports `Error: This Contact Name Already Exists`.

![Save and Save and Close actions on the contact record](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/94c1eebee799640767cbb6035b23c1e0.png)

**Result:** **Save** leaves the saved contact open after the change. **Save and Close** saves the change
and leaves the record. Continue with [Manage contact details and the image](#manage-contact-details-and-the-image)
for communication fields or the image.

## Manage contact details and the image

**Contact Details** adds communication fields to the contact form. The image actions belong to the record
image area and depend on the image state.

| Contact-detail choice | Result |
|---|---|
| **Phone** | Adds the corresponding communication field. |
| **Fax** | Adds the corresponding communication field. |
| **Mobile** | Adds the corresponding communication field. |
| **Email** | Adds the corresponding communication field. |
| **Website** | Adds the corresponding communication field. |
| **Online Support** | Adds the corresponding communication field. |
| **Comments** | Adds the corresponding communication field. |

**Prerequisites**

- The contact record is open.
- The form is editable before adding a contact-detail field.

**Steps**

1. Open **Contact Details**.
2. Select the communication field you need from the choices shown.
3. Enter the value in the field that appears.
4. If you enter **Phone**, **Fax**, or **Mobile**, use numeric keys; non-numeric keys are prevented.
5. If you enter **Email**, use an email value that passes the field's validation.
6. Choose the image action that matches the current image state.

   | If you need to… | Select |
   |---|---|
   | Add or replace the contact image | **Upload** |
   | Remove an existing contact image | **Delete contact image** |

![Contact Details choices and the added communication fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/35756628475b55a34bb550a56ba2ec13.png)

> **Note:** **Delete contact image** is available only when the record has a non-placeholder image.

**Result:** The selected communication field appears on the contact record, and the image action is
available for the current image state. Continue with [Maintain the contact image](#maintain-the-contact-image)
to add or remove an image, or with [Review attachments and change history](#review-attachments-and-change-history)
to open a related record area.

### Maintain the contact image

The contact image area provides **Upload** for an image file and **Delete contact image** when an image URL
exists and the displayed image is not the placeholder image.

**Prerequisites**

- The contact record is open.
- The form is editable.
- For deletion, a non-placeholder contact image exists.

**Steps**

1. To add or replace the contact image, select **Upload**.
2. Choose the image file in the file picker.
3. To remove an existing image, select **Delete contact image**.
4. Confirm the delete-image action in the confirmation modal.
5. Check for `Photo Deleted Successfully` after the deletion completes.

The **Delete contact image** control is hidden when the image URL is empty or the displayed image is the
placeholder image.

**Result:** **Upload** uploads the selected contact image. After a completed deletion, the page reports
`Photo Deleted Successfully`.

## Review attachments and change history

After maintaining the contact information, use the saved-record tabs for related areas. **Attachment** is
for attached files, and **Last Modifications** is for change history.

**Prerequisites**

- The contact is saved and has a contact identifier.
- The record is open outside a popup.

**Steps**

1. Select **Attachment** to open the attached-files area.
2. Select **Last Modifications** to open the change-history area.

Use [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) for attached-file management.

**Result:** The saved-record tabs are **Attachment** and **Last Modifications**. Continue with [When a
contact record cannot be saved](#when-a-contact-record-cannot-be-saved) if a save problem needs correction.

## When a contact record cannot be saved

Use the message on screen to match the problem to the correction.

| What you see | Cause | Corrective action |
|---|---|---|
| `This field is required` | **Name** has no value. | Enter a contact name in **Name**. |
| `Just '_'‘-''.' And '&' Characters Accepted` | The contact name contains a character outside the accepted name pattern. | Correct **Name** to use the accepted characters. |
| `Account field is mandatory` | No account is selected. | Select an account in **Account**. |
| `Email is invalid` | The value in **Email** fails email validation. | Correct the value in **Email**. |
| `You already have a contact with this name` | The contact name matches an existing contact during name checking or save. | Enter a name that does not duplicate an existing contact. |
| `Error: This Contact Name Already Exists` | The save returned a duplicate-contact error. | Change **Name**, then save again. |
| `Error: Server Error` | The save returned a server error. | Do not treat the change as saved; resolve the server problem before saving again. |
| The exit confirmation popup opens | The form has unsaved changes and you selected **Close**. | Follow the exit confirmation flow. |

After correcting the value, return to [Edit and save contact information](#edit-and-save-contact-information).

### Out of scope

These messages and surfaces belong to other pages or popups rather than the contact record's own
contact-name and save flow.

| Message | Owning page or surface |
|---|---|
| `You already have account with this name` | New-account popup |
| `Error.. client not saved yet` | New-account popup |
| `Error.. vendor not saved yet` | New-vendor popup |
| `Just '_'‘-''.' And '&' Characters Accepted`; `Your request was completed successfully` | Library and file popup |

## Continue from the contact record

After reviewing or changing a contact, choose the page that owns the next task.

| Next need | Continue to |
|---|---|
| Find another existing contact | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview) |
| Create a new contact | [Create a contact](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-contact) |
| Review the account related to the contact | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) |
| Manage attached files | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) |
| Review change history | Select **Last Modifications** on a resolved saved contact record. |
