# Rating types

## Rating types

Rating types define named sets of ratings and the rating values that belong to
each set. The **Rating types** page owns these entries in the shared ISO configuration
surface.

| If you need to… | Go to |
|---|---|
| Check which rating types already exist | [Find a rating type](#find-a-rating-type) |
| Read the list columns and form fields | [Understand the rating type screen](#understand-the-rating-type-screen) |
| Create or change a rating type | [Create and maintain rating types](#create-and-maintain-rating-types) |
| Remove an existing rating type | [Remove a rating type](#remove-a-rating-type) |
| Resolve a validation, deletion, or save problem | [When maintenance goes wrong](#when-maintenance-goes-wrong) |
| Continue with ISO survey questions | [Questions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-questions) |
| Continue with customer satisfaction survey settings | [Customer satisfaction survey](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-model) |

## Before you start

The list and the action for starting a new entry depend on your subscription and on
whether the corresponding new-entry surface is available.

**Prerequisites**

- Sign in to the application. The route requires authentication.
- Use a subscription that includes this configuration. With an included subscription,
  the rating-type list is shown; otherwise the shared subscription-upgrade surface is
  shown.
- Confirm that the new-entry surface is available if you need to create a rating type.
  **New** appears only when the subscription is included and that surface is not hidden.

## Find a rating type

The **Rating types** list is where you review the named rating sets already available
for ISO survey configuration.

**Prerequisites**

- Meet the conditions in [Before you start](#before-you-start).

**Steps**

1. Open the **Rating types** page.
2. Confirm that the page shows the **Type name** and **Rating** columns.
3. Find the rating type by its value in **Type name**.
4. Select the existing row when you need to maintain it.
5. Select **New** when you need to start a rating type that is not in the list.

![Identify a rating type from the Type name and Rating columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a37e31f59bcff51f828e17006da3bd3f.png)

**Result:** The **Rating types** list is open, and you have identified an existing
rating type or opened the route for a new entry.

Use the field reference below before creating or maintaining the entry.

## Understand the rating type screen

A rating type is a named entry with a collection of text-and-number rating rows. The
list identifies each entry with **Type name** and **Rating**; the form carries the
name and the rows that describe its ratings.

### List and form fields

| Where | Field or column | What it contains |
|---|---|---|
| List | **Type name** | The rating type name |
| List | **Rating** | The rating information shown in the list |
| Form | **Type name** | The required text field for the rating type |
| Form | Rating row text | The required text value for one rating row |
| Form | **Rating value** | The required numeric value for one rating row, from `0` through `100` |
| Form | **Rating description** | The repeating rating-details collection shown in the form |

Each rating row has a text input for its rating text and a number box labelled
**Rating value**. The form shows **Rating description** as the repeating collection that
contains those rows. Select **Add more** to add a row.

The form has no select box, date box, or currency control.

![Review the Rating types list and its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/cb963b19e79a84796088df7045e87667.png)

Use these fields when you create or maintain a rating type.

## Create and maintain rating types

**Prerequisites**

- Meet the conditions in [Before you start](#before-you-start).
- Know the name for the rating type and the text and numeric value for each rating row.
- Start from the **Rating types** list.

| If you are… | Start by… |
|---|---|
| Creating a rating type | Selecting **New** |
| Maintaining an existing rating type | Selecting its row |

**Steps**

1. Use the table to open the new or existing rating type.
2. In **Type name**, enter the name of the rating type.
3. In the rating row's text input, enter the text for the rating.
4. In **Rating value**, enter a number from `0` through `100`.
5. Select **Add more** for each additional rating row.
6. Enter the text and numeric value for each additional row.

**Result:** The rating type's fields and rating rows are entered in the form.

When saving completes, the application shows one of these messages:

- `Data saved Successfully` for a new entry.
- `Data updated Successfully` for an edited entry.

After saving, return to the list to review the entry or remove it when it is no longer
needed.

### Remove a rating type

Delete a rating type when the existing entry is no longer needed. The delete action is
available from the delete menu only when more than one item exists.

**Prerequisites**

- Meet the conditions in [Before you start](#before-you-start).
- Have more than one rating-type item in the list.
- Identify the rating type you intend to remove.

**Steps**

1. Open the delete menu for the selected rating type.
2. Select **Delete**.
3. Read the result message before continuing.

**Result:** A successful deletion shows `Data Deleted Successfully`. If the item is
related to saved data, the application shows `Related to Saved data, Can't be deleted`.
If the deletion fails for another reason, the application shows `Failed to Delete`.

## When maintenance goes wrong

Use the message on screen to decide whether to complete a missing value, correct a
rating value, remove forbidden characters, or review the deletion result.

| What you see | What it means | What to do |
|---|---|---|
| `Required` beside a rating-row text input | The row text is required | Enter the rating text in that row |
| `Required` beside **Rating value** | The row's numeric value is required | Enter a value from `0` through `100` |
| `Forbidden characters detected. Please remove them and try again.` | The entry contains forbidden characters | Remove the forbidden characters and submit the form again |
| `Must have at least one item` | The operation has no remaining item | Keep at least one item before continuing |
| `Related to Saved data, Can't be deleted` | The selected item is related to saved data | Keep the item and continue without deleting it |
| `Failed to Delete` | The delete operation failed | Review the entry and attempt the delete operation again |

The **Export** branch exposes **Export** and **Filter Row** on the page.

If the server rejects a save, the application displays the server's own explanation of
the problem. The exact wording depends on the response returned by the server.

## After maintaining rating types

After a successful save, the application reloads the list and closes the entry form.
After a successful delete, the list reflects the removed rating type and shows
`Data Deleted Successfully`.

## Continue with related ISO configuration

Continue with the related ISO configuration entities:

- Open [Questions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-questions) to maintain survey questions.
- Open [Customer satisfaction survey](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-model) to maintain
  customer satisfaction survey configuration.
