Skip to content
D
Documentation

Item categories

reference
5 min readUpdated

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 nameBefore you start
Open the list and locate an entryFind Item categories
Read the hierarchy and available controlsUnderstand the Item categories screen
Add or change a category or subcategoryAdd or edit a category
Remove an entry or use the list output actionDelete a category or export the list
Correct a value that prevents savingWhen validation or saving goes wrong
Continue to related configuration or product workConfiguration home, 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.

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 withWhat you see or selectWhat it is for
Category listCategoryLocate a category or subcategory entry.
New category popupProduct category nameEnter the name of a category.
New subcategory popupSub product category nameEnter the name of a child entry.
Saved category historyRegistrationView registration history from the history area of a saved category entry.
List actionNewOpen 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.
The category popup with Product category name and the OK action.

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 categoryNew
    Add a child under the selected rowAdd New Sub-Category
    Change the selected rowEdit
  2. Enter the appropriate name.

    If you are maintaining a…Enter the name in
    CategoryProduct category name
    SubcategorySub product category name
  3. Submit the entry.

    Popup stateAction
    The popup shows SaveSelect it.
    The popup shows OK as its submit actionSelect 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 rowDelete, read Are you sure you want to delete this item?, then select the confirmation control shown by the application.
    Keep the entryDelete, then Cancel.
    Use the list-output operationExport, 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 seeWhat to do
This Field Is RequiredEnter a value in the required name field.
Please Enter the Required FieldEnter the missing category or subcategory name.
Required Field can not be Empty SpacesReplace spaces-only input with a category or subcategory name.
Just '_'‘-''.' And '&' Characters AcceptedRemove characters outside the configured pattern rule.
Must have maximum 10 lettersShorten the value to the permitted length.
Under DevelopmentThe export operation is unavailable.
Data Importing completedThe import operation reports completion.
Data saved SuccessfullyThe save operation reports success.
Data Deleted SuccessfullyThe 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 for another configuration task.
The Item Categories list after the new category form is closed without saving.

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

Was this page helpful?

Need help using the product?