# Product stages

## Product stages

Product stages are the named stages used by warehouse work to describe where a product is in its
warehouse handling. You maintain them under the **Warehouse** area of configuration.

For the warehouse process, continue with [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow).

| If you need to… | Go to |
| --- | --- |
| Find the list | [Find the Product stages list](#find-the-product-stages-list) |
| Understand the list and editor | [Understand the Product stages screen](#understand-the-product-stages-screen) |
| Add or change a stage | [Add or edit a stage](#add-or-edit-a-stage) |
| Remove a stage | [Remove a stage](#remove-a-stage) |
| Export list data | [Import or export list data](#import-or-export-list-data) |
| Continue with warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
| Maintain the related Warehouse list | [Warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) |

## Before you start

Product stages maintenance needs access to Product stages and a subscription that includes
the feature. The list is available when your subscription includes the feature. **New** is available
when you can create entries and your subscription includes the feature.

Prepare the stage name before opening the editor. Enter it in **Stage**.

If `You are not allowed to View this page!` appears before the list opens, use the access path
provided by your administrator before trying to maintain a stage.

Open the list before selecting a row to edit or delete.

## Find the Product stages list

In the configuration menu, select **Product stages**.

## Understand the Product stages screen

The Product stages screen combines a list with actions, row controls, an editor popup, and an export
dialog. Use the column headers visible in your list.

Use **New** above the list to add a stage. Use the row's edit or delete control when that action is
available. Use **Export** to open the export dialog when it is available.

In the editor popup, select **Save** to keep a change or **Cancel** to close it without saving.

### Fields

Enter the stage name in the required **Stage** text box.

| Field | What you use it for |
| --- | --- |
| **Stage** | Enter the stage name. |

## Maintain Product stages

Choose the action that matches your task.

| If you need to… | Use this surface | What it does |
| --- | --- | --- |
| Add a row | **New** above the grid | Opens the new-item form. |
| Change a row | Edit control for the row | Opens the selected row for editing when editing is allowed. |
| Commit editor changes | **Save** in the editor popup | Emits the editor save event. |
| Leave the editor | **Cancel** in the editor popup | Closes the editor without saving. |
| Start an export | **Export** in the export dialog | Starts export from the export dialog. |
| Leave the export dialog | **Cancel** in the export dialog | Closes the export dialog. |

### Add or edit a stage

| Task | Select |
| --- | --- |
| Add a stage | **New** |
| Edit a stage | The edit control for the row |
| Leave without saving | **Cancel** |

Prerequisites

- You can open the Product stages list.
- For a new entry, **New** is available.
- For an existing entry, a Product stages row and its edit control are available.

Steps

1. Select the action for your task in the table above.
2. In **Stage**, enter the stage name.
3. Select **Save**.
4. If a validation message appears, correct **Stage** using the table below.
5. Select **Save** again.

| Message | Action |
| --- | --- |
| `Stage is required` | Enter a value in **Stage**. |
| `Just '_' '-' And '.' Characters Accepted` | Remove characters outside the accepted set from **Stage**. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Stage**. |

**Result:** The editor emits its save event when you select **Save**. Selecting **Cancel** closes
the editor without saving.

**Stage** is required and accepts only the characters described by the message
`Just '_' '-' And '.' Characters Accepted`.

### Remove a stage

Prerequisites

- You can open the Product stages list.
- The row you want to remove is present.
- Its delete control is available.

Steps

1. Select the row's delete control.

| If you want to… | Select |
| --- | --- |
| Request deletion | **Delete** |
| Close the confirmation without deleting | **Cancel** |

2. In the confirmation, select the option that matches your choice in the table above.

The confirmation message is `Are you sure you want to delete this item?`.

**Result:** Selecting **Delete** calls the row delete action.

### Import or export list data

Prerequisites

- **Export** is available for the page.

Steps

1. Select **Export** in the page controls.
2. Select **Export** in the export dialog to start the export.
3. Select **Cancel** in the export dialog to close it without starting an export.

**Result:** **Export** starts the export, or **Cancel** closes the export dialog.

## Choose the available maintenance path

The available actions depend on your subscription, permissions, the selected row, and the current
form state.

| What you check | Maintenance path |
| --- | --- |
| Product stages grid | The grid is shown when the subscription includes the feature. |
| **New** | Select **New** when it is available. |
| **Stage** field | Enter the stage name in the required field. |
| Stage editability | Edit the field when it is available. |
| Edit and delete controls | Use the row control when the action is available. |
| **Export** | Use the export dialog when **Export** is available. |

## When maintenance goes wrong

Use the visible message or page state to choose the next check.

| What you see | What to check next |
| --- | --- |
| `Stage is required` | Enter a value in **Stage** before selecting **Save**. |
| `Just '_' '-' And '.' Characters Accepted` | Remove characters outside the accepted set, then try **Save** again. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Stage**, then try **Save** again. |
| `You are not allowed to View this page!` | Check your Product stages page access. |
| A loading indicator remains visible | Wait for the page to finish loading. |
| An edit or delete control, **New**, or **Export** is unavailable | Check the row, permissions, and subscription in [Choose the available maintenance path](#choose-the-available-maintenance-path). |

After selecting **Save**, verify the resulting list before continuing.

## Out of scope

| Topic | Surface | Behaviour |
| --- | --- | --- |
| **Upload** and import upload messages | — | — |
| **Don't Save**, **Yes**, **No**, and **Ok** | — | — |
| Log-history filters and **Registration** | — | — |
| Warehouse inspection configuration | — | — |
| Other Warehouse reference lists | — | — |

## Know what is next

Product stages feeds warehouse work, where the stage names support the warehouse process.
Continue with [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) when you need to use
those stages in work, or open the sibling [Warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) list when
you need related Warehouse configuration.

Choose the procedure that matches the actions available to you.
