# Create a contact

Use this page to locate an existing contact or enter a new person's information and connect that person
to an account.

## Create and locate a contact

A contact is a person record that your organisation can connect to an account. Use the **Contacts**
workflow to locate an existing person or open the new-contact form.

| If you need to… | Go to |
|---|---|
| Open the list and locate an existing contact | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview) and then [Find a contact](#find-a-contact) |
| Start a new contact | [Enter contact details](#enter-contact-details) |
| Understand the main contact fields | [Understand the contact information](#understand-the-contact-information) |
| Review or maintain a saved contact | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) |
| Review the account connected to a contact | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) |
| Manage files attached to a saved contact | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) |

Open the Contacts list from the **Contacts** area. From that list, use **New** when you have permission to
create a contact, or open an existing contact from the list.

## Before you start

The Contacts subscription must be included before the contact form is available. Your permission to
create a contact controls whether **New** appears. Prepare the person's identity and the account to which
the person belongs before you save.

| Prepare | Why it matters |
|---|---|
| Contacts subscription included | The Contacts workflow and its form are available. |
| Permission to create a contact | **New** is available when the permission allows it. |
| Contact name | **Name** is required before save. |
| Related account | **Account** is required before save. |
| Editable form | **Contact Details** is available only when the form is not read-only. |

The account choices and initial field values depend on the account in use. Select from the account choices
shown in **Account** rather than relying on a value from another account.

## Find a contact

The Contacts list is the starting point for locating an existing contact or opening the new-contact flow.

**Prerequisites**

- The Contacts subscription is included.
- You have permission to create a contact if you need **New**.

**Steps**

1. Open the **Contacts** list.
2. Read the visible list headers.

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

3. Choose one route.

   | If you need to… | Select or do this |
   |---|---|
   | Start a new contact | Select **New** when your permission allows it and the Contacts subscription is included. |
   | Locate an existing contact | Open the contact from the list. |

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

Additional columns can appear according to your selected list layout. Work from the headers visible in your
list when those columns differ.

**Result:** The Contacts list is on screen, and you have either opened the new-contact form or reached the
existing contact you need. If you opened the form, continue with [Enter contact details](#enter-contact-details).

## Understand the contact information

The new-contact form identifies a person and connects that person to an account. Its main fields are
**Title**, **Name**, **Position**, **Department**, and **Account**.

| Main field | Required marker on the new-contact form | What to enter or choose |
|---|---:|---|
| **Title** | No | The person's title. |
| **Name** | Yes | The person's name. |
| **Position** | No | The person's position. |
| **Department** | No | The person's department. |
| **Account** | Yes | The account connected to the person. |

The editable form boundary includes **Contact Details**, which opens optional communication-detail
choices. **Attachment** and **Last Modifications** belong to a saved contact: they require a saved contact
ID and are absent for a new contact.

![The new-contact form with its main fields and required markers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e4c61681c88201597ed68654a24f309d.png)

Use this field reference when you complete the form in [Enter contact details](#enter-contact-details).

## Enter contact details

Enter the person's identity and account first. Add only the communication details that apply to the
contact.

**Prerequisites**

- The new-contact form is open.
- The form is editable.
- You know the contact's name and related account.

**Steps**

1. Enter the person's title in **Title**, if applicable.
2. Enter the person's name in **Name**.
3. Enter the person's position in **Position**, if applicable.
4. Enter the person's department in **Department**, if applicable.
5. Select the related account in **Account**.
6. Select **Contact Details**.
7. Select each applicable communication choice.

   | Contact-detail choice | Rule |
   |---|---|
   | **Phone** | Maximum length 20. |
   | **Fax** | Maximum length 20. |
   | **Mobile** | Maximum length 20. |
   | **Email** | The value must pass email validation. |
   | **Website** | Enter the applicable website value. |
   | **Online Support** | Enter the applicable online-support value. |
   | **Comments** | Enter the applicable comments. |

8. Enter the value in each contact-detail field you selected.

![The seven choices opened from Contact Details](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/82d4f825aa6c5c4e91f4550243522e89.png)

**Result:** The contact's main information is entered, and the applicable communication-detail fields
are selected and available for values.

## Save the contact

Save only after **Name** and **Account** are complete and the form passes its validation checks.

**Prerequisites**

- The form is editable.
- **Name** has a value.
- **Account** has a selected account.
   - The mandatory-field check passes.
- The data validator is valid.

**Steps**

1. Start the form exit flow after entering the contact information.
2. In the exit-form confirmation popup, choose the outcome that applies.

   | If you want to… | Select |
   |---|---|
   | Commit the contact | **Save** |
   | Leave without committing the changes | **Don't Save** |

3. After saving, check for `Contact saved successfully`.

**Result:** A successful save reports `Contact saved successfully` and opens the saved contact record.
Review the applicable surface variation, then continue with [After saving](#after-saving).

## Handle contact variations

The contact surface changes according to subscription, permission, editability, and whether the contact
already has an identifier.

| Variation | What changes |
|---|---|
| New-contact access | **New** requires permission to create a contact and an included Contacts subscription. |
| Read-only form | **Contact Details** is available only when the form is not read-only and the subscription is included. |
| Saved contact | **Attachment** and **Last Modifications** require a saved contact ID and a non-popup form. |
| Duplicate-name check | The form checks whether the contact name matches an existing contact. |
| Account lookup | The choices shown depend on account data for the account in use; local-branch records are filtered. |

If a variation prevents saving, use [When contact saving goes wrong](#when-contact-saving-goes-wrong).
If saving succeeds, continue with [After saving](#after-saving).

**Result:** You know which contact surface applies and where to go when the contact is saved or cannot be
saved.

## When contact saving goes wrong

Use the message on screen to choose the correction.

| What you see | What to correct |
|---|---|
| `This Field Is Required` | Enter a value in the field marked as required. |
| `Just '_'‘-''.' And '&' Characters Accepted` | Correct **Name** to use the accepted name characters. |
| `Account field is mandatory` | Select an account in **Account**. |
| `Please Solve the Following Issues :` | Resolve the listed validation issues before saving. |
| `You already have a contact with this name` | Use a contact name that does not duplicate an existing contact. |
| `Error: This Contact Name Already Exists` | Change **Name** and try the save again. |
| `Error: Server Error` | Resolve the server problem before treating the contact as saved. |
| `Email is invalid` | Correct the value in **Email**. |
| `At least One Contact Detail is Required` | Select at least one choice from **Contact Details**. |
| `At least One Contact Detail Must Have a Value` | Enter a value in at least one selected contact-detail field. |

The following messages belong to related surfaces rather than this create-and-locate task:

| Message | Related surface |
|---|---|
| `You already have account with this name` | Account popup. |
| `Name is required` | New-account popup. |
| `This field is required` | New-account or vendor popup. |
| `Forbidden characters detected. Please remove them and try again.` | Contacts list action. |
| `Error.. client not saved yet` | Account popup. |
| `Error.. vendor not saved yet` | Vendor popup. |
| `Your request was completed successfully` | Contact attachments or file library. |

After correcting the displayed issue, return to [Save the contact](#save-the-contact). If the save succeeds,
continue with [After saving](#after-saving).

**Result:** The displayed issue is corrected, or the save problem is identified before you continue.

## After saving

A saved contact has a contact ID that enables its saved-record surfaces. After saving, continue to the saved
contact record.

**Prerequisites**

- The contact has been saved and has a contact ID.
- The contact is open outside a popup.

**Steps**

1. Open the saved contact record.
2. Select the saved-contact area that applies.

   | If you want to… | Select |
   |---|---|
   | Continue with the saved contact's attachments | **Attachment** |
   | Continue with the saved contact's change history | **Last Modifications** |

Use [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) for attachment and file-library management. Use
[Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) for saved contact record maintenance.

**Result:** A saved contact exposes **Attachment** and **Last Modifications** when its ID is present and the
record is not in a popup. Related attachment work continues in [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files), and saved
contact maintenance continues in [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record).
