<!-- Known score-chapter warning: the YAML closing delimiter at line 3 is reported as a non-terminal-ending delimiter. -->

# Your first day

A sign-in gives you access to PAMS. A profile is the set of personal details held for a
PAMS account. Start with access, then review the profile details you are responsible for.

## Your first day in PAMS

Enter PAMS, complete any additional sign-in check, open a profile, and save profile changes.

| If you need to… | Go to |
|---|---|
| Open the initial sign-in form | [Sign in](#sign-in) |
| Complete a code or device-trust check | [Complete an additional sign-in check](#complete-an-additional-sign-in-check) |
| Find the named profile details | [Orient yourself on the profile surface](#orient-yourself-on-the-profile-surface) |
| Save profile changes | [Review and save profile details](#review-and-save-profile-details) |
| Continue learning the interface | `understanding-the-interface` |
| Learn how to move around PAMS | `navigation-basics` |

## Before you start

Have a PAMS account, its email and password, and the identifier for the profile you need to
open.

| Before you begin | Why it matters |
|---|---|
| An account for PAMS | The sign-in form requires an email and password. |
| The profile user's identifier | It opens the specific profile you need to review. |
| The sign-in entry | It takes you to the sign-in form. |

## Reach the sign-in and profile surfaces

After signing in, continue with [Orient yourself on the profile surface](#orient-yourself-on-the-profile-surface).

| If you need to… | Do this |
|---|---|
| Sign in to PAMS | Open the sign-in entry. |
| Review a profile | Open the profile page for the person you need. |
| Open the correct profile | Enter that person's profile identifier. |

If the sign-in entry opens the dashboard, continue from the dashboard. Otherwise, complete
[Sign in](#sign-in) and then open the profile.

![The landing route after opening the sign-in entry](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0412e66205334ca9d219c53758132ce.png)

## Sign in

Use the initial sign-in form when PAMS asks for your account credentials. The form contains
**Email**, **Password**, the optional **Remember Me** choice, and **Login**.

**Prerequisites**

- You have the email and password for your PAMS account.
- The initial sign-in state is showing.

**Steps**

1. Enter your account email in **Email**.
2. Enter your account password in **Password**.
3. Optional: select **Remember Me** if you want to use the remembered-login choice.
4. Select **Login**.

The initial sign-in form appears when no device-trust or verification step is required.
**Email** and **Password** are required. If either value is empty, the form can show
`User Name is Required` or `Password is required`.

**Result:** PAMS submits the initial sign-in information. If an additional check appears,
continue with [Complete an additional sign-in check](#complete-an-additional-sign-in-check).
Otherwise, continue with [Orient yourself on the profile surface](#orient-yourself-on-the-profile-surface).

## Complete an additional sign-in check

An additional sign-in check asks for a verification code or presents a device-trust choice
after the initial credentials are submitted.

| State | What appears |
|---|---|
| Identity verification | PAMS asks for a required code in **Enter code**. |
| Device trust choice | PAMS offers the optional **Trust this device for further login** choice. |

**Prerequisites**

- PAMS has moved from the initial sign-in state to an additional check.
- For identity verification, you have the verification code.

**Steps**

1. In the identity-verification state, enter the code in **Enter code**.
2. Select **Verify** when the code contains at least six characters.
3. If a resend control appears below **Enter code**, select it after its waiting period ends.
4. In the recognized-device choice state, select **Trust this device for further login** when
   you want that optional choice.

**Result:** PAMS submits the verification code when **Verify** is enabled, or records the
available device-trust choice. An empty code or a code shorter than six characters leaves
**Verify** disabled. An empty code can show `code is required`; an invalid or expired code
shows `Verification code not correct or expired`. After the check, continue with
[Orient yourself on the profile surface](#orient-yourself-on-the-profile-surface).

## Orient yourself on the profile surface

The profile surface is where you review personal account details. Its named fields appear
after the selected profile has loaded.

| Profile detail | Field state |
|---|---|
| **User Name** | Text field; required. |
| **Position** | Read-only text. |
| **Title** | Text field. |
| **First Name** | Text field. |
| **Middle Name** | Text field. |
| **Last Name** | Text field. |
| **Display Name** | Text field; required. |
| **Login Email** | Text field; required. |
| **Cloud Account** | Read-only text. |
| **Mobile** | Text field; required, with a maximum length of 20. |

The profile surface also includes role, approval-limit, branch, and file areas. Use the labels
displayed on your profile surface to identify those areas. Continue with
[Review and save profile details](#review-and-save-profile-details).

### Review and save profile details

Review the named profile details before saving them. **Save** stores profile changes;
**Save and Close** stores the changes and requests that the profile close.

**Prerequisites**

- The profile content is showing for the person whose details you need to review.
- You have permission to change the profile details.
- You know the correct values for the required fields.

**Steps**

1. Review **User Name**, **Display Name**, **Login Email**, and **Mobile**.
2. Correct **User Name** if it is empty or contains spaces.
3. Enter a value in **Display Name**.
4. Enter a valid value in **Login Email**.
5. Enter a value in **Mobile**.
6. Choose the save action that matches what you want to do.

   | If you want to… | Select |
   |---|---|
   | Save the changes and remain on the profile surface | **Save** |
   | Save the changes and request that the profile close | **Save and Close** |

7. If the profile-photo prompt is open, choose the action that matches what you want to do.

   | If you want to… | Select |
   |---|---|
   | Keep the photo | **Cancel** |
   | Remove the photo | **Delete** |

The profile save actions are disabled when there are no changes to save. The required-field
messages are `User Name is required`, `No spaces are allowed`, `Display name is required`,
`Email is required`, `Email is invalid`, and `Mobile is required`.

**Result:** PAMS confirms a successful save with `Data saved Successfully`. A password-change save can show `Data saved Successfully .. This User Password has been Changed .. Please check E-Mail`.

### Review trusted login devices

Review the device-trust choice while completing an additional sign-in check.

**Prerequisites**

- PAMS is showing the additional sign-in check.
- You know whether this device should be remembered for later logins.

**Steps**

1. Review the optional **Trust this device for further login** choice.
2. Select **Trust this device for further login** when you want PAMS to remember this device.

**Result:** The device-trust choice is recorded as part of the additional sign-in check.

## When sign-in or profile access goes wrong

Use the message that appears to choose the correction rather than repeating the same entry.

| What you see or encounter | What to do |
|---|---|
| `User Name is Required` | Enter a value in **Email** and submit **Login** again. |
| `Password is required` | Enter a value in **Password** and submit **Login** again. |
| `Incorrect username or password` | Recheck the account credentials before selecting **Login** again. |
| `code is required` | Enter a verification code in **Enter code**. |
| `Verification code not correct or expired` | Enter a current six-character-or-longer code before selecting **Verify**. |
| `Error: This Email or User Name Already Exists` | Correct the duplicate email or user name before saving the profile. |
| `Error: Server Error` | Retry the profile save after checking that the values are correct. |
| The sign-in entry opens the dashboard | Continue from the dashboard. |

## Continue after your first-day orientation

From the dashboard, continue with `understanding-the-interface` for interface orientation
and `navigation-basics` for navigation orientation.
