# Order chance

Maintain the names available for Order chance in the Sales configuration area.

| If you need to… | Go to |
|---|---|
| Understand what Order chance is used for | [Order chance in the sales flow](#order-chance-in-the-sales-flow) |
| Check access and subscription conditions | [Before you start](#before-you-start) |
| Open the list or an entry | [Find the Order chance list](#find-the-order-chance-list) |
| Identify visible and stored fields | [Understand the list and edit form](#understand-the-list-and-edit-form) |
| Add or change an entry | [Add or edit an Order chance entry](#add-or-edit-an-order-chance-entry) |
| Remove an entry | [Delete an Order chance entry](#delete-an-order-chance-entry) |
| Filter or export the list | Filter and export the list |
| Resolve a message or blocked action | [When maintenance goes wrong](#when-maintenance-goes-wrong) |
| Maintain related Sales reference data | [After maintaining Order chance](#after-maintaining-order-chance) |

## Order chance in the sales flow

Order chance is the named order-chance information held with job-process and offer data.
Use this page to review the available names through the shared configuration-list pattern.

The page and popup are titled **Order Chance** under **Sales**.

| If you need to… | Use this page or related page |
|---|---|
| Maintain the available names | This page |
| Work with the Order chance field on a sales job | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) |
| Understand the wider sales flow | [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) |

## Before you start

Order chance maintenance is available to signed-in users, and the list or upgrade surface depends
on subscription availability.

| Before you start | What it means on this page |
|---|---|
| Signed-in access | Sign in before opening the Sales configuration area. |
| Subscription included | The configuration list is shown. |
| Subscription not included | An upgrade surface is shown instead of the list. |
| Available configuration | The fields shown in the list and form depend on the available configuration. |

## Find the Order chance list

The Order chance list is the Sales configuration list for these entries.

**Prerequisites**

- Your account can reach the Order chance route.

**Steps**

1. Open **Sales** configuration.
2. Select **Order Chance**.
3. Select **New** when you are creating an entry.
4. Select the data row outside the action column when you are editing an entry.

![Locate the Order Chance list and its entry actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png)

**Result:**

The list is open, or the shared new-item form is open after you select **New**.

## Understand the list and edit form

The list shows **Name** as a visible, filterable field. Other stored fields are hidden from the list.

| Field or surface | What the page configuration establishes |
|---|---|
| **Name** | Visible and filterable in the list. |
| Other stored fields | Hidden from the list. |
| Action column | One shared action column with an empty caption. |

When **Name** is available in the form, it is a text field. The form shows the labels and fields
made available by the page configuration.

The shared form must be valid before saving. Row ordering is enabled and saved for each item after
a drop.

## Add or edit an Order chance entry

Use the form to create a new entry or update an existing one. Complete the fields that appear in the
form; **Name** is a text field when it is shown.

**Prerequisites**

- The subscription includes Order chance maintenance.
- **New** is available when you are creating an entry.
- The row is editable when you are changing an existing entry.

Choose the starting action:

| Task | Start with |
|---|---|
| Create an entry | Select **New**. |
| Change an entry | Select the data row outside the action column. |

**Steps**

1. Complete each field that the form marks as required.
2. In the **Name** text field, enter the order-chance name when that field is shown.
3. Select **Save**.
4. If a required-field message appears, complete the named field and select **Save** again.
5. If `Forbidden characters detected. Please remove them and try again.` appears, remove the
   forbidden characters and select **Save** again.
6. To close the form without saving, select **Cancel**.

The shared validator must be valid before the save service call. A new entry uses `Data saved
Successfully`; an edited entry uses `Data updated Successfully`.

**Result:**

The shared form closes after the save path, or **Cancel** closes it without saving.

## Delete an Order chance entry

Delete removes the selected row through the shared confirmation path when the action is available.
The list must contain more than one item before deletion can run.

**Prerequisites**

- The selected row is available in the list.
- More than one item is in the data source.
- Your account has the available delete permission.

**Steps**

1. Select **Delete** for the row you want to remove.
2. Confirm the deletion in the list confirmation.
3. Select **Cancel** when the confirmation is not the action you want.

When the delete succeeds, the application shows `Data Deleted Successfully`. If the list contains
only one item, the action is blocked with `Must have at least one item`. A related saved record can
produce `Related to Saved data, Can't be deleted`; another delete failure produces `Failed to Delete`.

**Result:**

The entry is removed, or the list remains unchanged when you select **Cancel**.

## Filter, refresh, and export the list

Use the visible, filterable **Name** field to narrow the list and the shared list toolbar to export
its data. **Upload** submits an import file when importing is available.

| Action | What it does | Condition |
|---|---|---|
| **Name** | Filters the visible list by name. | The field is visible and filterable. |
| **Export** | Commits the export choice. | The shared list toolbar provides the action. |
| **Upload** | Submits an import file. | The import modal is open and importing is available. |

**Prerequisites**

- The Order chance list is open.

**Steps**

1. Enter a name in the visible **Name** filter field.
2. Select **Export** in the shared list toolbar when you need an export.
3. In the import modal, select **Upload** when importing is available.

**Result:**

The list is filtered or the export choice is committed. Selecting **Upload** submits an import file
when importing is enabled.

## When maintenance goes wrong

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

| What you see | What to do |
|---|---|
| The required-field message | Complete the required field, then select **Save** again. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters, 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 entry instead of deleting it. |
| `Failed to Delete` | Review the row and deletion conditions before trying **Delete** again. |
| `You are not allowed to View this page!` | Check route access and subscription availability. |
| Upgrade surface instead of the list | Check whether the subscription includes this configuration. |

## After maintaining Order chance

After a successful maintenance action, the shared screen reports `Data saved Successfully` for a
new entry, `Data updated Successfully` for an edit, or `Data Deleted Successfully` for a deletion.

For adjacent Sales configuration data, continue with [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), or
[Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status).
For related sales-work context, see [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment)
and [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle).
