# General error messages

Inspect **Notifications**, distinguish an empty notification state from a product error, and record
any message exactly as it appears.

## General error messages

Focus on error messages shown by the product or defined for its screens.

| If you need to… | Go to |
|---|---|
| Prepare access to the notification surface | [Before you start](#before-you-start) |
| Open Notifications and check the visible message | [Open Notifications and identify the visible message](#open-notifications-and-identify-the-visible-message) |
| Tell filters and notification states apart | [Inspect the notification state](#inspect-the-notification-state) |
| Respond when a notification operation appears to fail | [When a notification operation fails](#when-a-notification-operation-fails) |
| Record the result and continue | [Continue from the result](#continue-from-the-result) |

## Before you start

Notifications is the area where you inspect the product's notification state and any message
shown with it. You need a signed-in session, and your subscription must include Notifications.

| Prepare | What to check |
|---|---|
| Access | Sign in before opening the Notifications page. |
| Subscription | Confirm that your subscription includes Notifications. |
| Filters | Be ready to check **All**, **Requests**, **Feedback**, **Reminders**, and **Following**. |

Confirm both before you interpret what is on screen. Then open Notifications and identify the
visible message.

## Open Notifications and identify the visible message

Check Notifications for a product error message or an ordinary notification state.

**Prerequisites**

- You are signed in.
- Notifications is included in your subscription.

**Steps**

1. Open the Notifications page.
2. Confirm that the heading **Notifications** is visible.

3. Check the visible notification groups.

   | Group | What its presence means |
   |---|---|
   | **Today** | Notifications exist for today. |
   | Yesterday | Notifications exist for yesterday. |
   | Earlier | Notifications exist in the earlier notification collection. |
   | `No New Notifications` | The Today, Yesterday, and Earlier collections are all empty. |

4. Record any product message exactly as it appears, including its capitalization and punctuation.
5. If the message is `No New Notifications`, record it as an empty notification state rather than
   as a product error.

**Result:** You are on the Notifications page and know whether the visible content is a notification
group, an empty state, or a product error message. Next, inspect the notification state that applies.

## Inspect the notification state

A notification filter narrows the notifications shown on the same page. Selecting a filter changes
which notifications you inspect; it does not change the notification itself.

> **Note:** A filter selection keeps the browser on the Notifications page; record the selected filter
> separately from any action on a notification.

**Prerequisites**

- The Notifications surface is open.
- You can see the filter controls.

**Steps**

1. Select one filter from the table below.

   Select **All**, **Requests**, **Feedback**, **Reminders**, or **Following**.

   ![Inspect the All notification filter on the Notifications page](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ebaf597ccb38be32fd4f0a4e0e699e6a.png)

2. Confirm that the browser remains on the Notifications page after the filter selection.
3. If the full-screen or popup header shows **Mark all as read**, use it only when you intend to
   mark the displayed notifications as read.
4. Identify the visible notification state.

   | Visible state | What to record |
   |---|---|
   | **New** | The page notification collection is non-empty and the notification is new. |
   | Seen | The page notification collection is non-empty and the notification is seen. |
   | `No Data` | The page notification collection is empty. |

5. Repeat steps 1 and 2 for any other filter you need to inspect.

**Result:** You have recorded the filter and visible notification state. Use that result to choose
the applicable notification action.

## When a notification operation fails

Use only a message that is actually visible or defined by the product; do not replace an empty state
with an invented failure message.

| What you see | What it means | What to do |
|---|---|---|
| `No New Notifications` | The Today, Yesterday, and Earlier notification collections are empty. | Record the empty state and continue from the result. |
| `No Data` | The page notification collection is empty. | Record the empty state and continue from the result. |
| No product error, validation, confirmation, or request-failure message | No such message appears in the inspected Notifications view. | Record the visible notification state. |

Some notification items do not have a text label for their opening action. Select the visible item
when the notification type is feedback or information.

## Continue from the result

After inspecting Notifications, record the message or empty state and choose a visible action that
matches the notification type.

**Prerequisites**

- You have recorded the selected filter.
- You have recorded the visible notification state or exact message.

**Steps**

1. Select the action that matches the notification type and state.

   | Notification type or state | Select |
   |---|---|
   | Notifications is open in a popup | **View All** |
   | Request | **Job No.** |
   | Unseen request for a new task assignment, activity assignment, or activity change | **Decline** or **Accept** |
   | Reminder | **at** |
   | Feedback or information | The visible notification item |

   ![Record the selected filter while remaining on Notifications](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/25414958b7de73169f34ac65dc720ff4.png)

**Result:** You have recorded the Notifications result and selected the visible action that applies
to the notification.
