# Customer satisfaction survey

Use customer satisfaction survey models to connect a survey name with the sales-job
module it evaluates and its survey questions.

## Customer satisfaction survey models

A customer satisfaction survey model is a named survey setup that connects one sales-job
module with selected survey questions. Use it to define feedback for delivered or lost sales
jobs.

The model records a survey name, a module, and selected questions. The module choices
are **Delivered sales job** and **Lost sales job**. The selected module identifies the
sales-job context, and the selected questions provide the survey content.

| If you need to… | Go to |
|---|---|
| Identify an existing model and its module | [Find and review survey models](#find-and-review-survey-models) |
| Understand the list and form fields | [Fields](#fields) |
| Create or change a model | [Add or edit a survey model](#add-or-edit-a-survey-model) |
| Remove a model | [Delete a survey model](#delete-a-survey-model) |
| Resolve a blocked save or deletion | [When maintenance does not work](#when-maintenance-does-not-work) |
| Maintain the rating choices used by survey setup | [Rating types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-answers) |
| Maintain the questions available to survey setup | [Questions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-questions) |

## Before you start

The customer satisfaction survey page is a subscription-controlled configuration surface.
With the required subscription feature, the list and its controls are shown; without it,
the subscription-upgrade surface is shown.

| Check | What you need | Why it matters |
|---|---|---|
| Subscription | A subscription that includes this configuration | The survey-model list and controls depend on it. |
| Sign-in | Access to the application | Sign in before opening **ISO settings**. |
| Before removing a model | Confirm that **Delete** is available. | **Delete** is required to remove a model. |
| Related settings | The rating types and questions you want to use | These are maintained on the related configuration pages. |
| Survey information | A survey name, a module choice, and the questions to select | These are the survey-model values maintained by the form. |

> **Note:** Before changing or removing a model, confirm that the required control is visible.

## Find and review survey models

The survey-model list lets you identify a model by its survey name and module before opening
an action.

**Prerequisites**

- Sign in to the application.
- Use a subscription that includes the customer satisfaction survey configuration.
- If you need to remove a model, confirm that **Delete** is visible.

**Steps**

1. Open **ISO settings**.
2. Select **Configuration**.
3. Select **Customer satisfaction survay**.
4. In the list headed **Customer satisfaction survay**, read the value in **Survey name**.
5. Read the related value in **Module**.
6. Read the footer value `Count: 2` to see the number of rows currently shown.
7. Select **New** when it is available to open a new survey-model form.

![Identify a survey model from the Survey name and Module columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b201415698788d7c9597725d29dea7a1.png)

**Result:** The survey-model list is open, and you have either identified a model or opened
the action you need for that row.

## Understand the survey model screen

Under **ISO settings**, **Configuration** includes the **Customer satisfaction survay** area
and the related areas **Rating types** and **Questions**. Use the **Customer satisfaction
survay** list for survey models.

The list shows **Survey name** and **Module**, and its footer shows `Count: 2`. The toolbar
includes **New**, a refresh control titled `Refresh`, and a settings control titled
`Settings`.

![Review the Customer satisfaction survay heading, ISO settings area, list, and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/eb6ac3bac0a684c578f198e903836ddb.png)

The shared configuration surface can also expose **Export**. When it is open, it shows
**Export**, **Filter Row**, the same columns, and the row count.

![Review Export, Filter Row, the two survey-model columns, and the row count](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/73e2935c388cd6c4cafd60d0aa40ffeb.png)

The related **Rating types** and **Questions** areas are separate ISO settings.

### Fields

The list is for recognition; the form is for entering the model. The form marks **Survey name**,
**Module**, and **Survey questions** as required. Required markers and initial values depend on
the form state.

### List fields

| Field or column | Type | Use |
|---|---|---|
| **Survey name** | Text | Identifies the survey model in the list. |
| **Module** | Text | Shows the selected sales-job module in the list. |

### Form fields

| Field | Type | Required | Choices or use |
|---|---|---|---|
| **Survey name** | Text box | Yes | Enter the name used to identify the model. |
| **Module** | Choice | Yes | Choose **Form**, **Delivered sales job**, or **Lost sales job**. |
| **Survey questions** | Question choices | Yes | Select the questions that belong to the model. |

Use **Module** to read or choose the module. The list uses **Survey name** and **Module** as
its visible headers.

## Add or edit a survey model

Create a model or change its name, module, or selected questions.

**Prerequisites**

- Meet the conditions in [Before you start](#before-you-start).
- Have the survey name, the module choice, and the questions ready.
- Start from the survey-model list. For an existing model, have the record form open before
  continuing.

**Steps**

1. Choose a starting point:

   | If you need to… | Do this |
   |---|---|
   | Create a new model | Select **New**. |
   | Change an existing model | Open its form. |

2. In **Survey name**, enter or update the survey name.
3. In **Module**, choose **Form**, **Delivered sales job**, or **Lost sales job**.
4. In **Survey questions**, select and reorder the questions for this model.
5. Select **Save** to validate and send the form data.
6. Select **Close** to close the shared popup without keeping the form changes.

The save outcomes are `Data saved Successfully` for a new record and
`Data updated Successfully` for an existing record. A generic save error is
`Forbidden characters detected. Please remove them and try again.`

**Result:** The form is submitted with the chosen survey name, module, and questions; a new
record uses `Data saved Successfully`, an edited record uses `Data updated Successfully`, or
the application displays the applicable validation or save message.

## Delete a survey model

Delete a survey model when it is no longer needed and is not required by saved data. The
**Delete** action is available only when delete permission is available.

**Prerequisites**

- Meet the conditions in [Before you start](#before-you-start).
- Identify the survey-model row to remove.
- Have more than one survey-model item when you intend to select **Delete**.

**Steps**

1. Open the deletion menu for the survey model and read `Are you sure you want to delete this item?`.
2. Choose an action:

   | If you need to… | Select |
   |---|---|
   | Leave the row unchanged | **Cancel** |
   | Remove the selected row | **Delete** |

3. Read the result message.

The deletion outcomes are:

| Outcome | Message |
|---|---|
| Deletion succeeds | `Data Deleted Successfully` |
| Saved data prevents deletion | `Related to Saved data, Can't be deleted` |
| Deletion fails | `Failed to Delete` |
| The list would have no remaining item | `Must have at least one item` |

**Result:** The row remains when you select **Cancel**; after **Delete**, the application
shows the applicable deletion outcome.

## When maintenance does not work

Use the message or condition on screen to choose the next action.

| What you see or encounter | What it means | What to do |
|---|---|---|
| A required-field message | A required survey-model value is empty. | Complete the required question selection, then select **Save**. |
| `Field is required` | The field-level required rule has stopped the form. | Enter the missing value and select **Save** again. |
| `This Field Is Required` | The required-field message is shown in the configured language. | Complete the field and select **Save** again. |
| `Just '_' '-' And '.' Characters Accepted` | The entered value does not match the accepted pattern. | Correct the value so it uses only the accepted characters, then select **Save** again. |
| `Forbidden characters detected. Please remove them and try again.` | The save request contains forbidden characters. | Remove the forbidden characters and select **Save** again. |
| `Related to Saved data, Can't be deleted` | Saved data is related to the selected model. | Keep the model and select **Cancel** in the deletion menu. |
| `Failed to Delete` | The deletion operation failed. | Leave the record in place and review the deletion result before trying again. |
| `Must have at least one item` | The operation would leave no item in the list. | Keep at least one survey model. |
| The survey-model list and controls are replaced by the subscription-upgrade surface. | The subscription does not include this configuration. | Use a subscription that includes the customer satisfaction survey configuration. |
| **New** is absent. | The new action is hidden or the subscription-controlled configuration is unavailable. | Review the subscription and use the available existing-record action. |
| **Delete** is unavailable. | Delete permission is unavailable for the row. | Ask an administrator for delete access. |

## Continue with related survey settings

After maintaining the model, continue with the related ISO configuration pages for rating
choices and questions.

- Open [Rating types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-answers) to maintain named rating sets
  and their rating values.
- Open [Questions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-questions) to maintain the questions
  available to survey configuration.
