# Reference serial status

## Reference serial status

A serial status is a name in the configurable list that describes the status of a serial combination.
Maintain it in the **Status** field, then use the saved name in serial-combination configuration.

| If you need to… | Go to |
|---|---|
| Check the list and identify an existing status | [Find serial statuses](#find-serial-statuses) |
| Understand the list column and required field | [Understand the serial-status screen](#understand-the-serial-status-screen) |
| Choose an add, edit, or remove path | [Add, edit, or remove a serial status](#add-edit-or-remove-a-serial-status) |
| Add a new status | [Add a serial status](#add-a-serial-status) |
| Change an existing status | [Edit a serial status](#edit-a-serial-status) |
| Remove a status | [Remove a serial status](#remove-a-serial-status) |
| Check why an action or field is unavailable | [Handle access and action branches](#handle-access-and-action-branches) |
| Correct a validation or deletion problem | [When validation or deletion fails](#when-validation-or-deletion-fails) |
| Continue with serial-combination configuration | [Serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-serial-combinations-view) |
| Continue with product-combination configuration | [Product combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-product-combination-view) |

## Before you start

Reference serial status maintenance is available through the shared configuration list when the subscription
includes the feature and your permissions allow the action.

**Prerequisites**

- The subscription includes the configuration feature.
- You know the serial-status name to enter in **Status**.
- For an edit or deletion, a saved serial-status row exists.
- The required permission is available for the action you need.

The **Status** field appears in the new/edit popup after you select an item or open a new-item form.
Permission-dependent actions appear when the corresponding permissions allow them.

## Find serial statuses

The serial-status list is the configuration page where you locate the status name attached to a serial
combination.

**Prerequisites**

- The subscription includes the configuration feature.
- You can open the Configuration area.

**Steps**

1. Open **Configuration**.
2. Open **Reference list**.
3. Open **Serial status**.

   ![Identify the Serial status page, the Status column, and the available list controls.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/51485e61ae2f136aec912e0a3380ab0b.png)

4. Check the **Status** column to identify the row you need to maintain.
5. Use the row's status name to distinguish it from the other entries.

The page heading is **Serial status**. The list contains seven records in the **Status** column. The
visible list controls are **New**, **Refresh**, and **Settings**; **Refresh** and **Settings** are title-only
buttons.

**Result:** The Serial status list is open, and you can identify an existing row by its **Status** value.

## Understand the serial-status screen

The serial-status screen presents the status name in the list and in the maintenance popup.
**Status** is the required value for each entry.

| Surface | What you use it for | Rule or visibility |
|---|---|---|
| **Status** | Read or enter the serial-status name. | Visible list column and text field; required in the form. |
| Display order | — | Hidden column. |
| Id | Identify the record internally. | Hidden identifier column. |
| CompanyBranchID | — | Hidden column. |

No other field appears on this page. Available columns may differ between configuration lists, so use the
headers visible in your list.

The list view does not display labelled form fields, validation messages, or dialogs. The **Status** field appears
as a text box in the new/edit popup for a selected item.

## Add, edit, or remove a serial status

Choose whether you are creating a new status, changing a saved row, or starting its removal.

**Prerequisites**

- The Serial status list is open.
- For a new status, **New** is available.
- For an edit, a saved row and edit permission are available.
- For a removal, a saved row and delete permission are available.

**Steps**

1. Choose the action that matches the work you need to do.

   | If you need to… | Select | Continue with |
   |---|---|---|
   | Create a status | **New** | [Add a serial status](#add-a-serial-status) |
   | Change a saved status | The edit control in the row | [Edit a serial status](#edit-a-serial-status) |
   | Start removing a saved status | The row's Delete icon | [Remove a serial status](#remove-a-serial-status) |

**Result:** The new-item form, edit form, or row delete menu opens for the action you selected.

### Add a serial status

Create a status name for later serial-combination work.

**Prerequisites**

- The Serial status list is open.
- **New** is available.
- You know the serial-status name to enter.

**Steps**

1. Select **New** to open the new-item form.
2. In **Status**, enter the serial status name.
3. Select **OK** to submit the new popup.
4. If the form shows `Forbidden characters detected. Please remove them and try again.`, remove the forbidden
   characters from **Status**.
5. Select **OK** again after the value satisfies the field rule.

**Result:** A successfully saved entry displays `Data saved Successfully`, and the serial-status list is
available for checking the new row.

### Edit a serial status

Change the name on an existing serial-status row.

**Prerequisites**

- The Serial status list is open.
- The saved row is visible.
- Edit permission is available.

**Steps**

1. Select the edit control in the row to open the edit form.
2. In **Status**, change the serial status name.
3. Select **OK** to submit the edit popup.

**Result:** A successfully updated entry displays `Data updated Successfully`, and the list is available for
checking the revised **Status** value.

### Remove a serial status

Remove a selected serial status when deletion is allowed.

**Prerequisites**

- The Serial status list is open.
- The row to remove is visible.
- Delete permission is available.

**Steps**

1. Select the row's Delete icon to open the row delete menu.
2. Choose the outcome you need.

   | If you want to… | Select |
   |---|---|
   | Keep the row | **Cancel**. The delete menu closes and the row remains. |
   | Remove the row | **Delete**, then confirm `Are you sure you want to delete this item?`. |

**Result:** A successful removal displays `Data Deleted Successfully`, and the list is available for checking
that the selected status is no longer present.

## Handle access and action branches

The shared configuration list changes which surfaces appear according to subscription inclusion and your
permissions.

| Condition | What changes |
|---|---|
| The subscription includes the feature | The configuration grid can appear. |
| The subscription includes the feature and the new-item control is not hidden | **New** can appear. |
| Editing permission is granted | The edit control in the row can appear. |
| Deleting permission is granted | The row Delete menu can appear. |
| Export permission is granted | **Export** can appear. |
| Import permission is granted | Import controls can appear. |

The list showed **New**. Import, export, edit, and delete actions depend on your permissions.

**Steps**

1. If **Export** is available, select **Export**.
2. Select **Export to Excel**.
3. Select **Cancel** to close the export options.

**Result:** The available action surface reflects the subscription and permissions for the account, and the
export options are closed after **Cancel**.

## When validation or deletion fails

Use the message shown on screen to identify whether the value needs correction, the selected row is protected,
or the deletion could not complete.

| What you see | What it means | What to do |
|---|---|---|
| `Status is required` | **Status** has no value. | Enter the serial status name in **Status**, then submit the popup again. |
| `Forbidden characters detected. Please remove them and try again.` | The value contains a forbidden character. | Remove the forbidden character from **Status**, then select **OK**. |
| `Related to Saved data, Can't be deleted` | The selected status is related to saved data. | Keep the status and address the related saved data before attempting removal again. |
| `Failed to Delete` | The deletion did not complete. | Keep the row and investigate the deletion condition or permission before retrying. |
| `Must have at least one item` | The list cannot be reduced below one item. | Keep at least one status in the list. |
| `Data saved Successfully` | The new status was saved. | Check the list for the new **Status** value. |
| `Data updated Successfully` | The existing status was updated. | Check the list for the revised **Status** value. |
| `Data Deleted Successfully` | The selected status was deleted. | Check the list to confirm the row is gone. |

When a save fails at the server, the screen displays parsed server error text. The exact wording depends on the
server response.

## After maintaining a serial status

After maintaining a status, continue with [Serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-serial-combinations-view) or
[Product combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-product-combination-view) when your next task is to configure the
serial-combination relationship.
