# Project management statuses

## Project management statuses

Project management statuses are configurable reference values that you maintain in the PM status list.

| If you need to… | Go to |
| --- | --- |
| Open the status list | [Find the status list](#find-the-status-list) |
| Check the columns, count, and form field | [Understand the status screen](#understand-the-status-screen) |
| Add a new status | [Add a status](#add-a-status) |
| Change an existing status | [Edit a status](#edit-a-status) |
| Leave a form without saving | [Leave a form without saving](#leave-a-form-without-saving) |
| Remove a status | [Delete a status](#delete-a-status) |
| Open another reference list | [Handle access and navigation branches](#handle-access-and-navigation-branches) |

## Before you start

The PM status list and its maintenance actions are available when the subscription includes the feature.
Your access also determines whether the edit control at the end of the status row and the delete control at the end of the status row are available.

| Before you start | What it controls |
| --- | --- |
| The subscription includes the feature | The grid and its top actions are available. |
| The feature is not included | The screen shows the subscription-upgrade component instead of the grid and top actions. |
| Editing is allowed | The edit control at the end of the status row is available. |
| Deletion is allowed | The delete control at the end of the status row and delete menu are available. |

## Find the status list

The PM status list is the reference list for the values used by project management.
Open it from the PM settings area under Configuration, then confirm the page heading before maintaining a row.

1. Open **Configuration**.
2. Open **PM settings**.
3. Select **PM statuses**.
4. Confirm that the page heading reads **PM statuses**.

The list remains open while you work with it.

![The PM statuses heading, navigation, list, count, and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a26e21946b056c2fda502cdf99a22ef4.png)

**Result:** The PM status list is open under **Configuration**, with **PM statuses** as the page heading.

## Understand the status screen

The status screen is a single-column reference list with one editable value: **Type**.
The list contains nine rows and shows `Count: 9`.

| Screen area | What you see |
| --- | --- |
| Column shown | **Type** |
| Row count | `Count: 9` |
| List controls | **New**, **Refresh**, and **Settings** |
| Form field | **Type**, a required text box |
| Form submit control | **OK** |

The PM route has no visible tab set, so work starts from this list rather than from a PM status tab.

When you open a new or existing row, the form provides the **Type** text box and the **OK** button.

![The new PM statuses form with the required Type field and OK button](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/42d27c6674ee702ca44ff4479dcc78ea.png)

## Maintain statuses

Start a new value from the top of the list, change an existing value from its row,
and export the list from the toolbar.
The edit control at the end of the status row and the delete control at the end of the status row depend on the corresponding access conditions in [Before you start](#before-you-start).

| Need | Control or location |
| --- | --- |
| Start a new status | **New** at the top of the list |
| Export the list | **Export** in the toolbar |
| Change a status | The edit control at the end of the status row for the status you want to change |
| Remove a status | The delete control at the end of the status row for the status you want to remove |
| Keep a row | **Cancel** in the delete menu |
| Confirm removal | **Delete** in the delete menu |
| Leave the new/edit form | The close control in the popup’s upper-right corner |

The form opens as a popup. Its close control leaves the form without using **OK**.

### Add a status

Add one value to the PM status reference list.

Prerequisites

- The subscription includes the PM feature.
- You can access the PM status list.

Steps

1. Select **New**.
2. Confirm that the popup title reads `New PM statuses`.
3. In **Type**, enter the new status value.
4. Select **OK**.
5. Confirm the message `Data saved Successfully`.

![The New PM statuses popup before submitting a new Type value](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/42d27c6674ee702ca44ff4479dcc78ea.png)

**Result:** The new PM status is submitted and the save result is shown as `Data saved Successfully`.

### Edit a status

Change the **Type** value of an existing PM status.

Prerequisites

- The subscription includes the PM feature.
- Editing is allowed for your access.
- You can identify the row to change in the **Type** column.

Steps

1. Select the edit control at the end of the status row for the status you want to change.
2. In the edit popup, replace the value in **Type**.
3. Select **OK**.
4. Confirm the message `Data updated Successfully`.

**Result:** The changed status is submitted and the update result is shown as `Data updated Successfully`.

### Leave a form without saving

Close a new or edit popup without submitting its value.

Prerequisites

- A new or edit popup is open.

Steps

1. Select the close control in the popup’s upper-right corner.

**Result:** The popup closes without using **OK**, and the list remains open.

### Delete a status

Remove a PM status when deletion is allowed.
Deleting a value can be blocked when related saved data uses it or when only one item would remain.

Prerequisites

- The subscription includes the PM feature.
- Deletion is allowed for your access.
- You have identified the row to remove in the **Type** column.

Steps

1. Select the delete control at the end of the status row for the status you identified.
2. In the delete menu, select **Delete**.
3. Read the confirmation `Are you sure you want to delete this item?`.
4. Select **Delete** to confirm the removal.

| Message | What to do |
| --- | --- |
| `Data Deleted Successfully` | The status was deleted. |
| `Related to Saved data, Can't be deleted` | Keep the status because related saved data prevents deletion. |
| `Failed to Delete` | The deletion failed; retain the status and contact your administrator. |
| `Must have at least one item` | Keep the remaining status; the list requires at least one item. |

To leave the delete menu without confirming, select **Cancel**.

**Result:** The deletion is either confirmed with `Data Deleted Successfully`, cancelled with **Cancel**, or stopped with one of the listed messages.

## Handle access and navigation branches

Choose a sibling list by its visible destination name rather than treating that branch as a PM status field.

| What changes | What you see or do |
| --- | --- |
| The subscription does not include the PM feature | The subscription-upgrade component replaces the grid and top actions. |
| The route sets `hideNewButton` to true | **New** is hidden. |
| Editing is allowed | The edit control at the end of the status row is available. |
| Deletion is allowed | The delete control at the end of the status row and delete menu are available. |
| You need a different reference list | Use the shared navigation to open **Product Categories** or **Product serial combination**. |

The PM route does not set `hideNewButton`, and it has no declared visible tab set.

## When maintenance goes wrong

Use the exact message on screen to choose the correction.

| What you see | What it means | What to do |
| --- | --- | --- |
| `Type is required` | **Type** needs a value. | Enter a value in **Type** before selecting **OK**. |
| `Just '_' '-' And '.' Characters Accepted` | The **Type** value contains a character outside the accepted pattern. | Correct **Type** to use the accepted characters, then select **OK**. |
| `Forbidden characters detected. Please remove them and try again.` | The list filter contains forbidden characters. | Remove the forbidden characters from the filter and try again. |
| `Related to Saved data, Can't be deleted` | Related saved data prevents deletion. | Keep the status and leave the delete menu with **Cancel**. |
| `Must have at least one item` | The list cannot be left without an item. | Keep at least one status. |
| `Failed to Delete` | The deletion failed. | Leave the status in place and contact your administrator. |

![The PM status form with Type and OK visible during validation](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d20dd854c062c9d15fef8a05e7817a29.png)

## Confirm the result and continue

After a maintenance action, use the message and the list page to confirm where you are.
The shared screen exposes sibling reference-list navigation for the next configuration task.

| Path | Confirm |
| --- | --- |
| Add | `Data saved Successfully` |
| Edit | `Data updated Successfully` |
| Delete | `Data Deleted Successfully` |
| Leave without saving | The popup closes and the list remains open. |
| Continue to another reference list | Use the shared navigation to open **Product Categories** or **Product serial combination**. |

For the related configuration areas, continue with [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home),
[Reference categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-view), or
[Serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-serial-combinations-view).
