Categories

Configure maintenance categories and subcategories for organizing tasks and requests.

Categories

The Categories module allows users to create and manage categories to organize items in the application. Users can create new categories, add descriptions, choose colours, edit existing categories, and delete categories when required. The category list also displays how many assets are associated with each category.

1. View Categories

The Categories page displays the available categories and the number of assets associated with each one.

Categories List

Each category card displays the following information:

FieldDescription
Category nameDisplays the name of the category, such as Assets, Electrical, Elevator, Fire Safety, or HVAC.
DescriptionProvides a short explanation of the items included in the category, when available.
Asset countDisplays the number of assets associated with that category.
Arrow icon (>)Opens the selected category for viewing or editing.
+ New categoryOpens the form to create a new category.

2. Create a New Category

Click + New category to open the New category form. Enter the category name, add a description if required, select a colour, and click Create category.

New Category Form

Fields in the New Category Form

FieldDescriptionRequired
NameEnter a name that clearly identifies the category.Yes
Description (optional)Explain what types of items belong to this category.No
ColorSelect a colour to visually identify the category.Yes, select an available colour

Steps to Create a Category

  1. Open the Categories module.
  2. Click + New category.
  3. Enter the category name in the Name field.
  4. Add a description, if required.
  5. Select a colour from the available colour options.
  6. Review the entered information.
  7. Click Create category.
  8. Verify that the new category appears in the Categories list.

Example: Create a category named Fire Safety and add a description such as Fire panels, extinguishers, sprinklers, and alarms.

3. Edit an Existing Category

You can update an existing category when its name, description, or colour needs to change.

Edit Category Form

The Edit category form displays the current category information. It also shows the number of assets associated with the category.

Available Options

Field or OptionDescription
NameUpdate the category name.
Description (optional)Edit the description of the category.
ColorSelect a different colour for the category.
Assets in this categoryDisplays the number of assets associated with the category.
Save changesSaves the changes made to the category.
Delete icon (trash)Allows you to delete the category.
Close (X)Closes the editing form.

Steps to Edit a Category

  1. Open the Categories module.
  2. Find the category you want to update.
  3. Select the category to open the Edit category form.
  4. Update the name, description, or colour as required.
  5. Review the changes.
  6. Click Save changes.
  7. Verify that the updated information appears in the Categories list.

4. View Associated Assets

When you open a category for editing, the form displays the number of assets associated with that category.

For example, the Fire Safety category may show 3 assets in this category.

This information helps you understand whether assets are already linked to the category before making changes or deleting it.

Steps to Check Associated Assets

  1. Open the Categories module.
  2. Select the category you want to review.
  3. Check the asset count displayed in the Edit category form.
  4. Review the category information before making changes.

Note: The screenshot displays the number of associated assets. It does not show a separate list of those assets in the editing form.

5. Delete a Category

The Delete option is available through the trash icon in the Edit category form. Use this option when a category is no longer required.

Steps to Delete a Category

  1. Open the Categories module.
  2. Select the category you want to delete.
  3. Review the category name and associated asset count.
  4. Click the trash icon in the top-right corner of the editing form.
  5. Review any confirmation message displayed by the application.
  6. Confirm the deletion if you want to proceed.
  7. Verify the result in the Categories list.

Important: Before deleting a category, check the number of assets associated with it. If assets are linked to the category, verify how the application handles those associations before proceeding. The screenshots do not specify what happens to associated assets after deletion.

6. End-to-End Categories Workflow

Open the Categories Module
        ↓
View the Existing Categories
        ↓
Choose an Action
        ↓
 ┌─────────────┐
 │ Create a Category   │
 └─────────────┘
        ↓
Click + New category
        ↓
Enter Category Name
        ↓
Add Description if Required
        ↓
Select a Colour
        ↓
Click Create category
        ↓
Verify the New Category
        ↓
Category Available in the List


For an Existing Category
        ↓
Select the Required Category
        ↓
Open Edit category
        ↓
Review Name and Description
        ↓
Check the Associated Asset Count
        ↓
Choose an Action
        ↓
 ┌─────────────────────────┐
 │ Edit Category       │ Delete Category  │
 └─────────────────────────┘
        ↓                       ↓
Update Required Fields     Click Trash Icon
        ↓                       ↓
Click Save changes        Confirm if Prompted
        ↓                       ↓
Verify Updated Details   Verify Deletion Result