# Getting help

Use **Home** to check visible problem indicators, then choose the registered help destination that
matches the problem.

## Before you start

Use the route that matches what you need:

| If you need to… | Go to |
|---|---|
| Check the dashboard for visible problem indicators | [Open Home](#open-home) |
| Understand the inputs and limits of the dashboard view | [Recognize the Home state](#recognize-the-home-state) |
| Find a destination for a question that Home does not resolve | [FAQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/faq) |
| Triage an error message | [General error messages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/general-error-messages) |
| Find a known problem and its remedy | [Common issues and solutions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/common-issues-and-solutions) |
| Continue to the registered help route | [Continue to the registered help page](#continue-to-the-registered-help-page) |

## Open Home

Home is the signed-in starting screen at `/home`. The Home route requires authentication, so sign in
before you inspect its problem indicators.

**Prerequisites**

- Have access to the PAMS sign-in flow.
- Be ready to sign in before opening Home.

**Steps**

1. Sign in to PAMS.
2. Open `/home`.

   ![Home at the signed-in /home route](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png)

**Result:** Home is on screen at `/home`.

## Recognize the Home state

Home is a dashboard view with sorting inputs rather than a labelled support action. Use the visible
inputs as indicators only; dashboard selections depend on the dashboard configuration available to
your account.

| What you can see | What it tells you |
|---|---|
| **Sort by Booking** | A visible dashboard input with no required marker. |
| **Sort by Target** | A visible dashboard input with no required marker. |
| **Sort by Achievement** | A visible dashboard input with no required marker. |

Home has no visible buttons or table columns, and no additional messages or dialogs appear.

**Prerequisites**

- Be signed in and have Home open at `/home`.

**Steps**

1. Read the visible sorting inputs.
2. Check whether the problem is represented by the Home state you can see.

**Result:** You know whether the problem appears on Home without treating an unlabeled control as a
support control.

## When Home cannot resolve the problem

Treat Home as the place to inspect the dashboard state, not as a place to submit a support request.
It has no labelled Help, Help & Troubleshooting, FAQ, or support-channel control; no field for
collecting a problem description; and no declared support URL, email address, telephone number, or
support hand-off.

If a dashboard action displays a message, use the exact text to identify the message before moving
to the registered error-message destination:

| Message | Use it to… |
|---|---|
| `An error occurred while processing your request` | identify a general processing error |
| `Please choose one or more principals` | identify a missing principal choice |
| `Your request was completed successfully` | identify a completed request |

**Prerequisites**

- Have checked the visible Home state.
- Know whether the problem is a question, an error message, or a known issue.

**Steps**

1. Select and open the registered destination that matches the problem.

   | Problem | Open |
   |---|---|
   | A question not resolved on Home | [FAQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/faq) |
   | An error message | [General error messages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/general-error-messages) |
   | A known problem | [Common issues and solutions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/common-issues-and-solutions) |

**Result:** You have a problem-specific help destination, and you know that Home does not provide
the onward support hand-off.

## Continue to the registered help page

The registered help page owns the next problem-resolution step.

**Prerequisites**

- Have selected FAQ, General error messages, or Common issues and solutions.

**Steps**

1. Open the selected registered help page.

**Result:** The registered help page is open for the next problem-resolution step.
