# Questions

The **Questions** configuration contains the questions used in the ISO survey configuration.
Use this page to review the list or maintain a question entry.
The page is limited to the Questions entity tab; the other entities available in the shared
configuration surface are outside this page's procedure.

| If you need to… | Go to |
|---|---|
| Confirm what the Questions page contains | [Questions](#questions) |
| Check access and subscription conditions | [Before you start](#before-you-start) |
| Find the list and confirm its current rows | [Find Questions](#find-questions) |
| Identify fields and list behaviour | [List reference](#list-reference) |
| Open a blank entry | [Open the new-entry dialog](#open-the-new-entry-dialog) |
| Add or change a question | [Add or edit a question](#add-or-edit-a-question) |
| Remove a row | [Delete a question](#delete-a-question) |
| Start or cancel an export | [Export the Questions list](#export-the-questions-list) |
| Continue to another configuration area | [Continue with related ISO settings](#continue-with-related-iso-settings) |

## Questions

On this page, review the Questions list and maintain Question entries with their associated
survey answers.

This page contains the Questions entity tab. Use the related configuration page for another
entity.

> Note: Use the related configuration page when you need to maintain another entity. The
> Questions page does not change the survey's stage.

![Review the Questions heading, list, and visible Question column.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2772f9961c5e3cf4f40e3377cfc312e3.png)

## Before you start

Your subscription, permissions, and list columns determine which actions and fields appear.

| Check | What to expect |
|---|---|
| Subscription | The grid is shown when the subscription includes this configuration. |
| **New** | **New** is shown when the subscription includes this configuration and the new action is not hidden. |
| Edit access | The edit action is shown when edit permission is available. |
| List columns | The columns shown in your list determine which fields you can see. |
| Answer choices | The **Select a answer** lookup presents the available choices. |

Have the question text ready before opening a new entry. Choose the answer that belongs with the
 question from the **Select a answer** lookup.

## Find Questions

The Questions list is the place to identify an existing question before you open, change, or
remove it.

**Prerequisites**

- Have access to the Configuration area.
- Have a subscription that includes the Questions grid.

**Steps**

1. Open the Configuration area.
2. Select **Questions**.
3. Review the displayed rows before selecting an action.

The **Questions** page displays seven question rows. The list summary shows `Count: 7`.

**Result:** The **Questions** list is open, with the displayed rows and `Count: 7` available for
identification.

## Understand the list and form

The Questions page presents a list and a new or edit form. The form has two validation areas.
Actions and fields appear when their access and configuration conditions are met.

| Surface | What changes it |
|---|---|
| Grid | Shown when the subscription is included. |
| **New** | Shown when the subscription is included and the new action is not hidden. |
| Edit action | Shown when edit permission is available. |
| New/edit popup | Opens for a new or editable item. |
| **Question** | Shown in the popup when the selected configuration column is visible in the form and is a text box. |
| Answer lookup | Shown when the Questions form includes the answer field. |
| Log history | Shown only while editing an identified item. |

The page provides **New**, the edit and delete row icons, **Save**, **Cancel**, and **Export**.
The **Select a answer** field uses its lookup to present the available choices. A new entry opens
with **Question** and **OK**.

### List reference

The Questions form has two entry fields. The remaining values are data values associated with
the row rather than fields that you enter in this form.

The **Question** field is a required text box that appears in the form and list.

| Name | Type | Form | Grid | Required or value behaviour |
|---|---|---|---|---|
| Select a answer | Select box | Visible | Hidden | Required; the lookup presents the available choices |
| Display order | Data value | Not in the form | Hidden | No validation |
| Id | Data value and identifier | Not in the form | Hidden | No validation |
| Company ID | Data value | Not in the form | Hidden | No validation |

The list shows one column, **Question**. Column headers, paging, the row-filter, and the
header-filter are disabled. Work from the headers that are visible in your list.

## Open the new-entry dialog

Use the new-entry dialog when you want a blank Questions entry without changing an existing row.

**Prerequisites**

- Be on the Questions list.
- Have a subscription that includes the grid.
- Have **New** available; the action is hidden when the new-action setting hides it.

**Steps**

1. Select **New**.

   The `New Question` dialog opens with the **Question** field, its required marker, and an
   **OK** button.

**Result:** A blank `New Question` dialog is open, ready for the question entry.

![Enter a question in the New Question dialog.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8d2bb02cfdc9aabff8149ff8198a0d59.png)

### Add or edit a question

Use this procedure to create a new Question entry or change an existing one. Enter the required
question text and select a value from the **Select a answer** lookup.

**Prerequisites**

- For a new entry, open the `New Question` dialog.
- For an existing entry, have edit permission and open the row with the edit action.
- Have the question text and the intended survey answer ready.

**Steps**

1. In the first form field, enter the question in **Question**.
2. Confirm the required marker on **Question**.
3. Open the **Select a answer** lookup.
4. Select the required answer.
5. Choose the action for the entry type:

   | Entry type | Action |
   |---|---|
   | New entry | Select **OK**. |
   | Edited entry | Select **Save**. |

The form validates before saving. If **Question** is empty, it shows `Question is required`.
If the survey answer is empty, it shows ` is required`. The question field also has the
pattern message `Just '_' '-' And '.' Characters Accepted` when its pattern rule rejects the
entry.

For a new item, a successful save displays `Data saved Successfully`. For an edited item, a
successful save displays `Data updated Successfully`.

**Result:** The Questions entry is saved when validation passes, and the corresponding success
message identifies whether it was new or edited.

### Delete a question

Delete a Questions row when the row is no longer needed and the delete action is available. The
page protects the last remaining item: deletion is permitted only when more than one row exists.

**Prerequisites**

- Be on the Questions list.
- Identify the row to remove.
- Confirm that more than one row exists.

**Steps**

1. Select the row's delete icon.
2. Check the deletion message.
3. Confirm that the row is no longer in the list when the result is `Data Deleted Successfully`.

The page can stop deletion in three ways. The last-item block displays `Must have at least one
item`. A row related to saved data displays `Related to Saved data, Can't be deleted`. A
different deletion failure displays `Failed to Delete`. If the last row is selected, check for
the message `Must have at least one item`.

**Result:** The selected row is removed only when the list has more than one row and deletion
succeeds; otherwise the applicable message remains available for diagnosis.

### Export the Questions list

Use the Questions list export action when it is available for your subscription. Export starts
the shared export operation rather than changing a Questions row.

**Prerequisites**

- Be on the Questions list.
- Have the export operation available for the subscription.

**Steps**

1. Select **Export**.
2. Choose what to do in the export dialog:

   | If you want to… | Select |
   |---|---|
   | Run the presented export operation | The export operation. |
   | Close the dialog without continuing | **Cancel**. |

**Result:** The selected export operation runs, or the export dialog closes without changing
Questions data when you select **Cancel**.

## Handle variations

The Questions page is one entity tab in a shared configuration area. Subscription, permission,
and list settings can change what appears.

| Variation | What you see |
|---|---|
| Subscription includes the resource | The grid can appear, and **New** can appear when the new action is not hidden. |
| Edit permission is available | The edit action can appear for a row. |
| The Questions form column is visible | **Question** can appear in the new/edit popup when its type is a text box. |
| The answer field is available | The **Select a answer** lookup can appear. |
| The list columns differ | Work from the fields and headers visible in your list. |

For another entity, open its related configuration page.

## When question maintenance goes wrong

Use the message on screen to match the problem to the next action.

| What you see | What it means | What to do |
|---|---|---|
| `Question is required` | **Question** has no value. | Enter the question in **Question** and submit the form again. |
| ` is required` | The survey answer required rule has no selected value. | Open **Select a answer**, choose a returned value, and submit the form again. |
| `Just '_' '-' And '.' Characters Accepted` | The question text does not meet the accepted pattern. | Correct the text so it uses the accepted characters, then select **OK** for a new entry or **Save** for an edited entry. |
| `Forbidden characters detected. Please remove them and try again.` | The list filter contains forbidden characters. | Remove the forbidden characters from the filter input. |
| **Select a answer** is not shown | The lookup is unavailable on the current Questions form. | Work with the fields that are shown on the Questions form. |
| **Save** is not shown | The current new/edit surface does not expose the shared save control. | Use the control shown by the current popup, or close it and return to the list. |
| Delete is unavailable | The row-count or permission condition does not allow the action. | Confirm that more than one row exists and that the action is available. |
| Export is unavailable | The export subscription or surface condition is not met. | Continue without exporting or ask your administrator to review the subscription. |

## Continue with related ISO settings

Related ISO settings are available alongside Questions. Use this page only for Questions entries,
then open the related page for the entity you need.

- [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) is the shared configuration home.
- [Rating types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-answers) contains the survey-answer entity.
- [Customer satisfaction survey](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-model) contains the survey-model settings.
- [Reference category question units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-question-units-view)
  contains the related question-units setting.
