# Item categories

Item categories are the company's hierarchy of categories and subcategories.
Maintain this reference data before using categories while working with products.

| If you need to… | Go to |
|---|---|
| Check access and prepare a category name | [Before you start](#before-you-start) |
| Open the list and locate an entry | [Find Item categories](#find-item-categories) |
| Read the hierarchy and available controls | [Understand the Item categories screen](#understand-the-item-categories-screen) |
| Add or change a category or subcategory | [Add or edit a category](#add-or-edit-a-category) |
| Remove an entry or use the list output action | [Delete a category or export the list](#delete-a-category-or-export-the-list) |
| Correct a value that prevents saving | [When validation or saving goes wrong](#when-validation-or-saving-goes-wrong) |
| Continue to related configuration or product work | [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home), [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories), or Products |

## Before you start

Item categories is the company configuration screen for maintaining the category hierarchy.

Prerequisites

- Confirm that the Product Categories subscription feature is included for the company.
- Have permission for the action you plan to take. **New** requires create permission;
  **Add New Sub-Category** and **Edit** require edit permission; **Delete** requires delete
  permission.
- Have the category name or subcategory name ready.

When the Product Categories subscription feature is not included, the list is unavailable.
When it is included, **New** is available only with create permission. **Add New Sub-Category**
and **Edit** are available only with edit permission.

The category popup requires **Product category name**. The subcategory popup requires **Sub
product category name**.

## Find Item categories

The Item Categories page is the list where you locate the category or subcategory row to maintain.

Prerequisites

- Confirm that the Product Categories subscription feature is included.
- Confirm that you have the permission required for the action you plan to take.

Steps

1. Open Item categories from the company configuration screen.
2. Confirm that the page title is **Item Categories**.
3. Locate the entry in the **Category** column.
4. Select **New** when you need to create a category.

![The Item Categories list with the Category column and New action visible.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d8b38d09f78972493b58347e3a1d292a.png)

**Result:** The Item Categories list is open, and you have either located the row to maintain or
opened the new-category form.

## Understand the Item categories screen

The Item Categories screen presents the category hierarchy. A category entry uses **Product
category name**, while a child entry uses **Sub product category name**.

The list and popup states use the following reader-facing controls:

| What you are working with | What you see or select | What it is for |
|---|---|---|
| Category list | **Category** | Locate a category or subcategory entry. |
| New category popup | **Product category name** | Enter the name of a category. |
| New subcategory popup | **Sub product category name** | Enter the name of a child entry. |
| Saved category history | Registration | View registration history from the history area of a saved category entry. |
| List action | **New** | Open a category entry popup. |

The category popup also shows the **OK** action. A saved category entry can expose Registration
from its history.

![The Item Categories screen with the hierarchy in Category and the New action.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9abf8424d9b8c0ea18cd1c7bd60956bc.png)

![The category popup with Product category name and the OK action.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/db540140e782bce73df2fe608e777a05.png)

## Add or edit a category

Use a category entry for a top-level name and a subcategory entry for a child under a selected
category. The popup validates the name before **Save** commits it.

Prerequisites

- Confirm that the Product Categories subscription feature is included.
- For a new category, have create permission.
- For a subcategory or an edit, have edit permission.
- Have the name ready without special characters.

Steps

1. Select the action that matches the entry you need to maintain.

   | If you need to… | Select |
   |---|---|
   | Add a top-level category | **New** |
   | Add a child under the selected row | **Add New Sub-Category** |
   | Change the selected row | **Edit** |

2. Enter the appropriate name.

   | If you are maintaining a… | Enter the name in |
   |---|---|
   | Category | **Product category name** |
   | Subcategory | **Sub product category name** |

3. Submit the entry.

   | Popup state | Action |
   |---|---|
   | The popup shows **Save** | Select it. |
   | The popup shows **OK** as its submit action | Select it. |

Category and subcategory names use the configured pattern rule and reject special characters.
Correct the name if the rule prevents the save.

**Result:** The category or subcategory popup has accepted the entry for saving, or it remains open
with the value that needs correction.

### Delete a category or export the list

Use **Delete** only when you have delete permission and the selected entry is the one you intend to
remove. Use **Export** for the list-output operation when it is available.

Prerequisites

- Confirm that the selected row is the entry you intend to remove.
- Confirm that you have delete permission before selecting **Delete**.

Steps

1. Choose one operation and complete the corresponding action.

   | If you need to… | Select or complete |
   |---|---|
   | Remove the selected row | **Delete**, read `Are you sure you want to delete this item?`, then select the confirmation control shown by the application. |
   | Keep the entry | **Delete**, then **Cancel**. |
   | Use the list-output operation | **Export**, then choose the available list format. |

**Result:** **Cancel** leaves the entry in place; a completed permitted deletion displays
`Data Deleted Successfully`. The export branch is open when **Export** is available.

## When validation or saving goes wrong

Validation messages identify the value that needs correction before you try **Save** again.

| What you see | What to do |
|---|---|
| `This Field Is Required` | Enter a value in the required name field. |
| `Please Enter the Required Field` | Enter the missing category or subcategory name. |
| `Required Field can not be Empty Spaces` | Replace spaces-only input with a category or subcategory name. |
| `Just '_'‘-''.' And '&' Characters Accepted` | Remove characters outside the configured pattern rule. |
| `Must have maximum 10 letters` | Shorten the value to the permitted length. |
| `Under Development` | The export operation is unavailable. |
| `Data Importing completed` | The import operation reports completion. |
| `Data saved Successfully` | The save operation reports success. |
| `Data Deleted Successfully` | The delete operation reports success. |

The name fields are required and use the configured pattern rule. Spaces-only values are rejected.

## After maintaining item categories

The maintained category hierarchy is reference data for later product work. A saved entry reports
`Data saved Successfully`; a successful deletion reports `Data Deleted Successfully`.

Steps

1. Confirm the message that matches the operation you completed.
2. If you opened a new form but do not want to save it, select **Cancel**.
3. Continue to Products for related product work, or return to [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home)
   for another configuration task.

![The Item Categories list after the new category form is closed without saving.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e82c75ea75ee7689c940499d5fbe16b8.png)

**Result:** The item-category list is available for the next reference-data or product task.
