# Activity purpose

## Where Activity purposes are used

An Activity purpose is one reference value in the **Activity purposes** list. This page maintains
the list used by the Activity configuration area.

| If you need to… | Go to |
| --- | --- |
| Check the available purposes and their **Name** values | [Understand the list and form](#understand-the-list-and-form) |
| Add or change a purpose | [Add or edit an Activity purpose](#add-or-edit-an-activity-purpose) |
| Remove a purpose | [Remove an Activity purpose](#remove-an-activity-purpose) |
| Resolve a validation or action message | [When an action goes wrong](#when-an-action-goes-wrong) |
| Maintain lost reasons | [Lost reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-lost-reasons) |
| Maintain regret reasons | [Regret reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons) |
| Maintain cancellation reasons | [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons) |
| Maintain order cancellation reasons | [Order cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons) |
| Maintain units | [Units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-item-units) |
| Maintain delivery terms | [Delivery terms](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-delivery-terms) |
| Maintain payment methods | [Payment methods](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-payments-methods) |
| Maintain guarantee types | [Guarantee types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-requested-guarantee) |
| Maintain account types | [Account types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-client-types) |
| Maintain offer status | [Offer status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-offer-status) |
| Maintain order status | [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status) |
| Maintain inquiry status | [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status) |
| Maintain order activation conditions | [Order activation conditions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-activation-conditions) |
| Maintain additional costs | [Additional costs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cost-items) |
| Maintain mark-up items | [Mark Up Items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-margin-items) |

## Before you start

You need a signed-in account that can reach the Activity purpose configuration screen.

The list and its actions depend on your subscription and account settings:

| Condition | What you see or can use |
| --- | --- |
| The subscription includes this configuration | The configuration grid is shown. |
| The subscription does not include this configuration | An upgrade surface is shown instead of the grid. |
| **New** is not hidden by configuration | **New** is available for starting an entry. |
| Editing is allowed | The **Edit** icon is available for a row. |
| Deleting is allowed | The **Delete** menu is available for a row. |
| Your list settings provide columns | The available columns appear in the list. |

> **Note:** Work from the controls actually available on your screen. Do not assume that an action
> is available because another reference list shows it.

Use these conditions to confirm that the list is available, then find the Activity purpose list.

## Find and open Activity purposes

Open the Activity purpose list from the shared configuration tabs. The visible navigation includes
**Activity Purpose** and sibling reference-list tabs.

**Prerequisites**

- You are signed in.
- Your subscription and account configuration expose the configuration list.

**Steps**

1. Open the Activity purpose configuration area.
2. Select **Activity Purpose** from the visible reference-list tabs.
3. Choose the entry path that matches your task:

   | Task | Select |
   | --- | --- |
   | Start a record | **New** |
   | Inspect an existing record | The row's **Edit** icon |

![Activity purpose list with the Activity Purpose tab and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/709cca5236acbf42697583502f44dd37.png)

Selecting **New** opens the new-entry popup. Selecting the **Edit** icon opens the selected item.

**Result:** The Activity purpose list is open, a new-entry popup is open, or an existing purpose is
open for inspection or editing.

## Understand the list and form

The Activity purpose screen is a reference list with a popup for entering or inspecting one
purpose. The list shows the **Name** column. Use the headers visible in your list.

![Activity purpose list with the Name column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f46db6179552895f5491b28ecff2db89.png)

When you start an entry, the popup title is `New Activity purpose`. The **Name** value is blank,
and the popup includes **OK**. The list also includes **Refresh** and **Settings** icon buttons.

![New Activity purpose popup with a blank Name field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ceb84311057be410c8d7316756a618b9.png)

### Fields

The form accepts one visible purpose value:

| Field | What you use it for | Rule |
| --- | --- | --- |
| **Name** | Enter the purpose name. | Required when the list requires it; special-character validation applies. |

The new-entry surface shows no required marker beside **Name**.

![Blank Name field in the New Activity purpose popup](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ceb84311057be410c8d7316756a618b9.png)

### List controls and areas

Use the list controls according to the action you need and the conditions that make them available.

| Control or area | Use | Availability or condition |
| --- | --- | --- |
| **New** | Open a blank Activity purpose popup. | Hidden when the list settings hide the New control. |
| **Edit** icon | Open the selected purpose. | Available when editing is allowed. |
| **Delete** icon | Open the confirmation prompt. | Available when deleting is allowed. |
| **Cancel** | Close the confirmation prompt. | Present in the confirmation prompt. |
| **Export** | Open export choices and export the selected format. | Permission and configuration dependent. |
| **Refresh** | Refresh the list. | Shown as an icon button in the list. |
| **Settings** | Open list settings. | Shown as an icon button in the list. |

The grid appears when the subscription includes the configuration. Otherwise, the upgrade surface
replaces the grid. Use the available entry controls to add or change a purpose.

## Add or edit an Activity purpose

Create a new reference value or correct an existing one with these steps.

**Prerequisites**

- The configuration grid is available.
- **New** is available for a new purpose, or the **Edit** icon is available for an existing one.
- You know the purpose name to enter.

**Steps**

1. Choose the entry path that matches your task:

   | Task | Select |
   | --- | --- |
   | Create a purpose | **New** |
   | Change a purpose | The row's **Edit** icon |

2. In the **Name** field, enter the purpose name.
3. If the configured validation requires a value, enter a name before continuing.
4. If the configured special-character validation rejects the value, remove the rejected
   characters from **Name**.
5. Select **OK** to commit the new or edited purpose.

   ![Activity purpose entry popup ready for a Name value](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ceb84311057be410c8d7316756a618b9.png)

After a valid entry, the list refreshes and the popup closes. The corresponding success messages
are `Data updated Successfully` for an edited item and `Data saved Successfully` for a new item.

**Result:** The Activity purpose list is shown after a valid entry, and the popup is closed.

## Remove an Activity purpose

Use deletion only when the reference value is no longer needed. The delete action is guarded by
permission and by the number of items in the list.

**Prerequisites**

- The Activity purpose list is open.
- The **Delete** icon is available for the selected row.
- At least two Activity purposes remain in the list.

**Steps**

1. Select the row's **Delete** icon.
2. Read the confirmation prompt `Are you sure you want to delete this item?`.
3. Choose the confirmation action that matches your task:

   | Task | Select |
   | --- | --- |
   | Confirm the removal | **Delete** |
   | Close the prompt without deleting | **Cancel** |

After a successful deletion, the row is removed and `Data Deleted Successfully` is shown.
Deletion errors can show `Related to Saved data, Can't be deleted`, `Failed to Delete`, or
`Must have at least one item`.

**Result:** The confirmation prompt closes after **Delete** or **Cancel**. A successful deletion
removes the selected row.

## When an action goes wrong

Use the message on screen to choose the next action.

| What you see | What to do |
| --- | --- |
| `Field is required` | Enter a value in **Name** when the configured column requires it. |
| `Just '_' '-' And '.' Characters Accepted` | Use only the accepted characters in the purpose name. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value or filter, then submit it again. |
| `Related to Saved data, Can't be deleted` | Keep the purpose because saved data is related to it. |
| `Failed to Delete` | The delete operation did not complete; check whether **Delete** is still available before repeating it. |
| `Must have at least one item` | Keep at least one item in the list. |

If the grid is replaced by an upgrade surface, the subscription does not include this
configuration. If an action is absent, account permissions or list settings may be restricting it.

Use the matching message to correct the value or choose another available action.

## What to do next

After reviewing Activity purposes, use the sibling reference-list tabs in the shared configuration
area to open [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),
[Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons), [Order cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons),
[Units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-item-units), [Delivery terms](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-delivery-terms),
[Payment methods](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-payments-methods), [Guarantee types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-requested-guarantee),
[Account types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-client-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), [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status),
[Order activation conditions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-activation-conditions), [Additional Costs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cost-items),
or [Mark Up Items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-margin-items).
