# Inquiry status

## Overview

Inquiry Status is Sales configuration data: a list of names with one visible,
required **Name** field. Maintain those names through the shared configuration-list
pattern.

| If you need to… | Go to |
|---|---|
| Check access, subscription, and available actions | [Before you start](#before-you-start) |
| Open the list | [Find the Inquiry Status list](#find-the-inquiry-status-list) |
| Understand the column and form field | [Understand the list and form](#understand-the-list-and-form) |
| Add a name | [Add a status](#add-a-status) |
| Change a name | [Edit a status](#edit-a-status) |
| Remove a name | [Delete a status](#delete-a-status) |
| Use the export action | [Export the list](#export-the-list) |
| Resolve a blocked or unexpected action | [When an Inquiry Status operation goes wrong](#when-an-inquiry-status-operation-goes-wrong) |
| Continue with related Sales configuration | [Continue with related sales configuration](#continue-with-related-sales-configuration) |

## Before you start

Before you maintain Inquiry Status names, use a signed-in account with the
subscription and permissions required for the action you need. When the subscription
feature is included, the shared screen loads the grid configuration and requests the
list. When it is not included, the screen shows the upgrade surface instead of the
grid.

| Check | What changes on this page |
|---|---|
| Subscription feature included | The grid configuration loads and the list is requested. |
| Subscription feature not included | The upgrade surface appears instead of the grid. |
| The new-entry action is available | **New** is available when the subscription surface is available. |
| Edit permission available | A data-row click can open the edit popup. |
| Delete permission available | **Delete** can appear in the popup menu. |
| Export permission available | **Export** can appear in the toolbar. |

Follow your organisation's approval practice before saving or deleting.

> **Note:** The **Delete** action appears only when your permissions allow it.

When these checks are complete, open the list.

## Find the Inquiry Status list

The Inquiry Status list is the Sales configuration list for these names. Open the
Sales configuration area and select **Inquiry Status**.

**Prerequisites**

- You can open the Sales configuration area.
- The subscription feature is available for the shared list surface.

**Steps**

1. Open the Sales configuration area.
2. Select **Inquiry Status**.
3. Confirm that the page title is **Inquiry Status**.
4. If **New** is available, select it to open the new-entry popup.
5. To edit an existing entry, select its data row outside the action cell when edit
   permission is available.

![The Inquiry Status list with its Name column and list actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f65749ef07f51de3e7140b3ef614022e.png)

**Result:** The Inquiry Status list is open, or the new-entry popup is open after you
select **New**. Review the list and form before maintaining an entry.

## Understand the list and form

Inquiry Status uses one visible list column and one visible form field: **Name**. The
field is a required text box.

| Field or surface | What to expect |
|---|---|
| **Name** | The only visible list column and the only configured visible form field; it is required. |
| Form field | **Name** is the only visible field and is required. |
| New entry | The **Name** field appears in the new-entry popup. |
| Existing entry | The **Name** field appears in the edit popup. |

The form must be valid before the item is saved. An invalid form does not save the
item.

![The Inquiry Status page with the Name column and toolbar actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2a610b35285c6f0be0d8fcc820619278.png)

The list has one **Name** column. Select **New** or a data row to open a form.

## Add, edit, delete, and export Inquiry Status entries

The shared popup and list toolbar provide the maintenance actions for Inquiry Status.
Use **New** to create an entry, select a data row to edit it when edit permission is
available, and use **Save** or **Cancel** in the popup. Use **Delete** from the popup
menu when delete permission is available. Use **Export** from the toolbar when export
permission is available.

| Task | Shared action | Condition |
|---|---|---|
| Create an entry | **New**, then **Save** | **New** is not hidden and the subscription surface is available. |
| Edit an entry | Data-row selection, then **Save** | Edit permission is available and the click is outside the action cell. |
| Leave without saving | **Cancel** | The shared popup is open. |
| Delete an entry | **Delete** | Delete permission is available and the list has more than one item. |
| Export the list | **Export** | Export permission is available. |

The visible list actions were **New**, **Refresh**, and **Settings**. **New** appeared
as a text button; **Refresh** and **Settings** appeared as titled buttons without
visible text.

### Add a status

Use this procedure to add a new name to the Inquiry Status configuration list.

**Prerequisites**

- The subscription feature is available.
- **New** is available.
- Your organisation's approval practice permits the change.

| If… | Then… |
|---|---|
| The **Name** field contains a value | Select **Save**. |
| The **Name** field is invalid | Enter a value in **Name**, then select **Save**. |
| You do not want to save | Select **Cancel**. |

**Steps**

1. On the Inquiry Status list, select **New**.
2. In the new popup, enter the status name in the **Name** text box.
3. Follow the matching row in the table.

When the form is valid, **Save** saves the item. An invalid form does not save the item.
When creation succeeds, the shared action uses the message `Data saved Successfully`.
The required messages are `Field is required` and `Name is required`.

![The new-entry action and the Name field location on the Inquiry Status screen](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2a610b35285c6f0be0d8fcc820619278.png)

**Result:** The new name is saved when the form is valid, or the popup remains
available for correction or closing. Continue with [Edit a status](#edit-a-status),
[Delete a status](#delete-a-status), or [Export the list](#export-the-list).

### Edit a status

Use this procedure to change the name of an existing Inquiry Status entry.

**Prerequisites**

- An existing data row is available.
- Edit permission is available.
- Your organisation's approval practice permits the change.

| If… | Then… |
|---|---|
| The **Name** field contains a valid value | Select **Save**. |
| The **Name** field is invalid | Enter a value in **Name**, then select **Save**. |
| You do not want to save | Select **Cancel**. |

**Steps**

1. Select the data row outside its action cell.
2. In the edit popup, change the value in the **Name** text box.
3. Follow the matching row in the table.

When the form is valid, **Save** saves the item. An invalid form does not save the item.
When the edit succeeds, the shared action uses the message `Data updated Successfully`.
The required messages are `Field is required` and `Name is required`.

**Result:** The changed name is saved when the form is valid, or the popup remains
available for correction or closing. Continue with [Delete a status](#delete-a-status)
or [Export the list](#export-the-list).

### Delete a status

Use this procedure to remove an Inquiry Status entry when your organisation permits
its removal. The **Delete** action is available only when more than one item exists.

**Prerequisites**

- The row to remove is available.
- Delete permission is available.
- More than one item exists in the list.
- Your organisation's approval practice permits the deletion.

| List and permission condition | Delete path |
|---|---|
| Delete permission available and more than one item exists | **Delete** is available. |
| One item or fewer exists | Deletion is prevented and `Must have at least one item` is shown. |
| Delete permission unavailable | The **Delete** action is not available to the account. |

**Steps**

1. Open the selected row's popup menu.
2. Select **Delete** when the action is available.

The delete path can show `Related to Saved data, Can't be deleted` for a related saved
record, `Failed to Delete` for another delete failure, or `Data Deleted Successfully`
after a successful deletion.

**Result:** The entry is deleted after a successful deletion. Continue with
[Export the list](#export-the-list) or [When an Inquiry Status operation goes wrong](#when-an-inquiry-status-operation-goes-wrong).

### Export the list

Use this procedure to start the list export action when export permission is available.

**Prerequisites**

- The Inquiry Status list is open.
- Export permission is available.

**Steps**

1. Select **Export** in the toolbar.

**Result:** The export action is selected. Continue with [When an Inquiry Status operation
goes wrong](#when-an-inquiry-status-operation-goes-wrong) if the action does not work.

## Handle access and runtime branches

The Inquiry Status screen changes according to subscription access, permissions, and the
page settings. When the subscription feature is included, the grid configuration loads
and the list is requested; when it is not included, the upgrade surface appears instead
of the grid.

| Branch | What you see or can do |
|---|---|
| The new-entry action is available | **New** is available when the subscription surface is available. |
| Edit permission is available | A row click outside the action cell opens the edit popup. |
| Delete permission is available | **Delete** can appear in the popup menu. |
| Export permission is available | **Export** can appear in the toolbar. |

The list shows **New**, **Refresh**, and **Settings** when those actions are available,
and its visible column is **Name**.

Use the matching message in the next section when an action is blocked or produces an
unexpected result.

## When an Inquiry Status operation goes wrong

Use the exact message to identify the response, then follow the matching action.

| What you see | What to do |
|---|---|
| `Field is required` | Complete the required field, then select **Save** again. |
| `Name is required` | Enter a value in **Name**, then select **Save** again. |
| `Must have at least one item` | Keep more than one item in the list before selecting **Delete**. |
| `Related to Saved data, Can't be deleted` | Keep the related saved data instead of deleting this entry. |
| `Failed to Delete` | Review the row and deletion conditions before selecting **Delete** again. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters before trying the operation again. |

After resolving the message, return to the relevant maintenance procedure or continue
with related Sales configuration.

## Continue with related sales configuration

Use this page to maintain Inquiry Status names. Continue to the related Sales pages for
their own reference lists and sales-job work.

Continue with the sibling Sales configuration pages for [Inquiry types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-types),
[Offer status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-offer-status), [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status),
[Lost reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-lost-reasons), [Regret reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons),
and [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons). For the adjacent
sales subject, continue with the Sales job record page.
