# Account managers

## Account managers overview

An account manager is a user who manages accounts. The Account managers screen maintains
the account-manager list and identifies the account owner, the manager responsible for
the account.

Use this page when you need to add a user, review the saved list, assign ownership,
remove an eligible manager, or export the list.

| If you need to… | Go to |
|---|---|
| See the current account-manager rows and available list actions | [Find and review account managers](#find-and-review-account-managers) |
| Understand the columns, row controls, and dialogs | [Understand the account-manager screen](#understand-the-account-manager-screen) |
| Add a user to the list | [Add an account manager](#add-an-account-manager) |
| Assign account ownership | [Assign account ownership](#assign-account-ownership) |
| Remove a user or open the export choices | [Remove or export account managers](#remove-or-export-account-managers) |
| Maintain the list layout | [User layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-users-layouts-view) |
| Continue with user administration | Users overview or Teams |

## Before you start

The account-manager list is a saved list. Its filtering, grouping, and export tools
depend on the related permission. The main grid appears only when a layout is selected.
Prepare the access and information in this table before you begin.

| Prepare | Why it matters |
|---|---|
| Access that includes the related list permission | Filtering, grouping, and export are available only when that permission is available. |
| A selected list layout | The main grid appears only when a layout is selected. |
| The user you want to add | The **Users** field takes its choices from the users available to the application. |
| The current user's role and the selected row | Account ownership and removal actions change according to whether you are the account owner and whether the row is already the owner. |

The rows, visible dynamic columns, permissions, popup appearance, and action results can
vary with the current setup. Work from the controls and rows visible in your list.

> **Note:** Select the account owner carefully. The owner row cannot be removed through
> this list, and ownership actions are available only under their stated condition.

## Find and review account managers

The Account managers list shows the saved account-manager rows and the toolbar actions
available for this list. After you open it, review the rows and controls described in
the next section before adding, assigning, removing, or exporting a manager.

**Prerequisites**

- You have opened the configuration area.

**Steps**

1. Open the Account managers configuration page.
2. Review the toolbar for **Add account manager**, **Refresh**, **Table Layout**, and
   **Settings**.
3. Review the list headers **Name**, **Email**, **Phone**, **Position**, and **Active**.
4. If the list has no rows, read the list status **No Data**.
5. Select **Refresh** when you need to reload the current list.

![Review the Account managers toolbar and list area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5151c7dd69656c9cb1b7d20874592170.png)

**Result:** The Account managers list is open. Its current rows or **No Data** and its
visible toolbar actions are available for review.

## Understand the account-manager screen

The account-manager screen shows the headers from the selected list layout and provides
actions beside eligible rows. Read the visible headers first, then use an action only
when its condition applies.

| Screen area | What to use it for |
|---|---|
| Visible list headers | Read the columns shown in the list. |
| Ownership control | Select **Make as account owner** for an eligible row. |
| Removal control | Open the row menu for a row that is not the account owner. |
| Add dialog | Select a user and submit the add request. |
| Account-owner dialog | Confirm an ownership change. |

**Add account manager** opens the add dialog. The account-owner dialog appears during
the account-owner confirmation flow. The search panel is hidden, and the column chooser
is disabled. Editing and importing are not available on this screen.

### Fields and choice options

**Users** is a searchable selection field for choosing the user to add to the
account-manager list. It is required, and the open add dialog displays its required
marker.

![Identify the required Users field in the add dialog](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4dc98055201058cd9a65f2b3c2a0acd1.png)

The choices in **Users** come from the users available to the application. Select the
user you want to add from the choices shown in that field; the list of names depends on
the current user data.

### Account views

An account-owner row identifies the user who currently owns the account. If you are the
account owner and the selected row is not already the owner, select **Make as account
owner** in that row. If the selected row is already the owner, read **Account owner** as
the row marker instead.

The row delete menu appears for a row that is not the account owner. An account owner
cannot be removed through this list.

## Add an account manager

Adding an account manager puts a selected user into the maintained account-manager
list. The add dialog requires one user selection before the request can be submitted.

**Prerequisites**

- You are on the Account managers list.
- You know which available user to add.

**Steps**

1. Select **Add account manager**.
2. In the **Add Account manager** dialog, open **Users**.
3. Select the user to add.
4. Select **OK**.
5. Review the save modal that opens.

![Submit the selected user from the Add Account manager dialog](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4dc98055201058cd9a65f2b3c2a0acd1.png)

When the request completes successfully, the application uses the message
`Your request was completed successfully`.

**Result:** The add request has been submitted, or the **Users** field remains marked as
required when no user is selected.

## Assign account ownership

Account ownership identifies the account manager responsible for the account. Only the
current account owner can assign ownership to a row that is not already the owner.

**Prerequisites**

- You are the current account owner.
- The selected row is not already marked **Account owner**.

**Steps**

1. In the eligible row, select **Make as account owner**.
2. Review the account-owner confirmation flow.
3. Confirm the change in the confirm modal.

The ownership result is shown as `Account Ownership has been changed`. The result detail
says `The new manager should receive an email shortly to notifying his new role`.

**Result:** The ownership-change request has been confirmed, and the ownership result
message is displayed.

## Remove or export account managers

The list provides two separate list-level paths: remove an eligible account-manager row
or export the list. Export depends on the related permission.

| If you need to… | Choose |
|---|---|
| Remove a selected eligible row | **Delete** in the confirmation dialog |
| Leave a delete or export dialog | **Cancel** |
| Prepare an export | **Export** |
| Choose an export format | **Export to Excel** or **Export to PDF** |

### Remove an account manager

Removal takes place from the row's delete path. The account-owner row is protected from
removal through this list, and the current user cannot delete themself.

**Prerequisites**

- The selected row is not the account owner.

**Steps**

1. Open the row delete menu for the eligible account manager.
2. Read the row prompt: `Are you sure you want to exclude this user as account manger?`
3. Select **Delete** to open the confirmation dialog.
4. Review the confirmation: `Are you sure you want to delete this user totally from the database?`
5. Select **Delete** in the confirmation dialog.

Select **Cancel** to close the confirmation dialog without continuing. **Cancel** also
closes the export dialog when that is the dialog currently open.

If the selected user is yourself, the application shows `You can not delete yourself`.

**Result:** The eligible removal request is confirmed, or the open confirmation is
closed with **Cancel**.

### Export the account-manager list

Export creates a list output in one of the formats offered by the export choices. The
export path is available when the related permission is available.

**Prerequisites**

- You have the related export permission.

**Steps**

1. Select **Export** from the account-manager list.
2. Select an export format:

   | If you need to… | Select |
   |---|---|
   | Create an Excel export | **Export to Excel** |
   | Create a PDF export | **Export to PDF** |

If the list has no exportable rows, the export status is `NO Data to Export`.

**Result:** The selected export choice has been started, or the list displays
`NO Data to Export` when there are no rows to export.

## When an account-manager action does not work

Use the message or visible list state to choose the next action. The conditions below
cover required input, access-dependent list tools, and empty-list export behaviour.

| What you see | What it means | What to do |
|---|---|---|
| `This Field Is Required` | **Users** has no selected value. | 1. In **Users**, select a user. |
| **Users** contains a selected user | The required value is present. | Select **OK**. |
| **No Data** in the list | The current list has no rows. | Add an account manager or select **Refresh** after the list changes. |
| `NO Data to Export` | There are no rows available for export. | Review the list before selecting an export format. |
| A filtering, grouping, or export tool is unavailable | The related permission is not available to the current access. | Ask an administrator to review the permission. |
| A server response supplies an error | The displayed error text comes from the server response. | Use the displayed text when requesting help. |

Error text is resolved dynamically from the server response, so the message can vary by
failure.

The add dialog's required marker is visible on **Users**. If the required-field message
does not appear after you select **OK**, use the message shown on your screen as the
immediate guide.

If the application rejects an account-manager request, read the error message displayed
on screen and follow the instruction it gives.

## What to do next

After an unsuccessful account-manager change, the workflow remains on the Account
managers configuration page. No stage or status change occurs when no successful change
is made.

Continue with [User layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-users-layouts-view) when you need to
review the list layout. Use Users overview or Teams for adjacent user-management work.
