# Service types

Maintain the service-type names available in Warehouse settings, then return to the
Warehouse configuration area or continue to Warehouse work that uses these names.

## Before you start

Service types are Warehouse reference entries named through the **Name** field. Open
**Configuration** > **Warehouse settings** > **Service Types** to reach the maintenance
page.

Access to the list depends on your subscription. When the subscription includes the
feature, the service-type list and its controls are available; otherwise the shared
upgrade surface appears.

Before you begin, have the service-type name ready and confirm that your account can
maintain Warehouse settings.

| If you need to… | Go to |
| --- | --- |
| Review the wider Warehouse configuration context | [Warehouse configuration overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) |
| Find the current service-type rows | [Find and review service types](#find-and-review-service-types) |
| Add or change a name | [Add or edit a service type](#add-or-edit-a-service-type) |
| Remove a row | [Remove a service type](#remove-a-service-type) |
| Continue with Warehouse operations | [Warehouse fulfillment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |

## Find and review service types

The Service types page lists the names your organisation uses to classify external
services.

**Prerequisites**

- Your subscription includes the feature.
- You can access Warehouse settings.

**Steps**

1. Open **Configuration** > **Warehouse settings** > **Service Types**.
2. Check that the page heading is `External Service types`.
3. Read the `Name` heading to review the current rows.

![Identify the External Service types list and its Name heading.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6ed775644561845cf5357da333d28adf.png)

**Result:** The `External Service types` list is open with the `Name` heading and the
current rows beneath it.

## Understand the service types screen

Service types use the shared configuration screen.
The screen is classified as a form even though the initial view is the list.

The visible list contains one `Name` heading. Use the headings available in your list
when reviewing rows. The list tools include **Refresh** and **Settings**.

No labelled form control or required marker appears on the list itself. Open the form
before looking for the required **Name** field, **Save**, or **Cancel**.

![Recognise the Warehouse settings context, list tools, Name heading, and current service-type row.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5b8803ef98b95bef37713a6fbfd5cfdc.png)

### Fields and list behaviour

`Name` is the service type's text value. It appears in the form and list, can be used for
filtering, and is not editable directly in the list.

| Field or surface | Service types behaviour |
| --- | --- |
| **Name** | Required text value; shown in the form and list; available for filtering; not editable directly in the list |
| DisplayOrder | Not shown in the form or list for this subject configuration |
| ID | Not shown in the form or list for this subject configuration |
| CompanyID | Not shown in the form or list for this subject configuration |
| Additional subject fields | No additional fields are declared for Service types |

Use the list to inspect and filter names. Use the form to change a name; the list does
not provide editing.

## Add or edit a service type

Use the same form to add a service type or change a selected existing row.

**Prerequisites**

- The Service types list is open.
- To add a row, the **New** control is visible.
- To edit a row, a row is available and editing is allowed.

**Steps**

| If you want to… | Select… |
| --- | --- |
| Add a row | **New** |
| Edit a row | The row's edit control |

1. Select the control for the action you want.
2. In the form, enter the service-type name in **Name**.
3. Select **Save** to submit the form after validation.
4. If you do not want to save the entry, select **Cancel**.
5. For a new item, check for `Data saved Successfully`.
6. For an edited item, check for `Data updated Successfully`.

**Result:** A successful add or edit displays its corresponding message. **Cancel**
closes the popup without saving.

## Remove a service type

Deleting removes a service-type row from the reference list. Use it only when deletion
is allowed for the row and the name is no longer needed.

**Prerequisites**

- The Service types list is open.
- The target row is available.
- Deletion is allowed for that row.

**Steps**

1. Open the target row's delete menu.
2. Select **Delete**.
3. Read the confirmation prompt: `Are you sure you want to delete this item?`
4. Confirm the deletion in the prompt.
5. Check for `Data Deleted Successfully`.

If the row is related to saved data, the deletion is blocked and the message
`Related to Saved data, Can't be deleted` appears. If the deletion operation fails, the
message `Failed to Delete` appears. If the row is the last item, the list keeps the
required minimum and displays `Must have at least one item`.

**Result:** When deletion succeeds, the selected row is removed. A restriction or
failure leaves the list unchanged and displays the corresponding message.

## Validate entries and use list tools

The service-type form validates **Name** before **Save** submits it. The list also
provides shared tools and headings for reviewing rows.

**Prerequisites**

- The Service types list is open.
- Open the form before validating a **Name** value.

**Steps**

1. Leave **Name** empty to trigger the required rule.
2. Enter a name using the accepted characters.
3. Use the visible list headings when reviewing or filtering rows.
4. Check whether **Export** is visible in the list tools.

**Result:** The form accepts a value only after the required and pattern rules pass.
The list uses the headers currently shown, and **Export** is available when it is visible.

### Correct a name or filter

Use this recovery path when a service-type name fails validation or a list filter
contains a forbidden character.

**Prerequisites**

- The form is open for a name correction, or the list filter is active.

**Steps**

| If… | Then… |
| --- | --- |
| **Name** is empty | Enter a service-type name in **Name**. The form displays `Name is required`. |
| **Name** contains characters outside the accepted pattern | Replace it with a value using the accepted characters. The form displays `Just '_' '-' And '.' Characters Accepted`. |
| The filter reports forbidden characters | Remove those characters from the filter value. The list displays `Forbidden characters detected. Please remove them and try again.` |

1. Apply the correction in the table row that matches the message.
2. Reapply the filter or continue with the form after the message clears.

**Result:** The corrected **Name** is ready for validation, or the list filter is ready
to run without the forbidden-character message.

### Export the list

**Prerequisites**

- The Service types list is open.
- **Export** is visible in the list tools.

**Steps**

1. Select **Export**.

**Result:** Export options open for the Service types list.

### Understand access and configuration variations

The controls and fields on this shared screen change with subscription, row state,
permissions, and the active list configuration.

| Condition | What changes |
| --- | --- |
| The subscription includes the feature | The list and its controls are available; otherwise the shared upgrade surface appears |
| **New** is not hidden | The add control appears |
| A row is available and editing is allowed | The row's edit control appears |
| Deletion is allowed | The row's delete control and delete prompt appear |
| The edit form is open and a selected item exists | The configured visible form fields appear |
| The list configuration changes | The available headings depend on that list configuration |

Use the controls and headers visible on your Service types page when the arrangement
differs.

## Continue after maintenance

After maintenance, the Service types list gives you the saved row or the deletion
result.

The visible Warehouse navigation also includes **Inventories**, **Base of inspection**,
**Inspection checklist**, **Inspection Document**, **Transfer Reasons**, and **Stock
Withdrawal And Valuation**. For the broader Warehouse configuration context, open the
[Warehouse configuration overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view). For operational
use of Warehouse reference data, continue to [Warehouse fulfillment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow).
