# Activity status

Use this page to find an activity, read its status, and choose a status action when
the activity record offers one.

## Activity status at a glance

An activity status tells you where an activity sits in its follow-up flow. The
Activities list and the activity record show the status, using **Planned**, **Due**,
**Overdue**, **Done**, or **Cancelled**.

The date-driven part of the flow is:

```mermaid
flowchart LR
    Planned --> Due: date is due
    Due --> Overdue: end date has passed
    Due --> Done: Done
    Overdue --> Done: Done
    Planned --> Cancelled: Cancel This Activity
    Due --> Cancelled: Cancel This Activity
    Overdue --> Cancelled: Cancel This Activity
    Done --> Planned: Consider As Not Done
    Cancelled --> Planned: Undo Cancellation
```

The date checks place an activity in **Planned** before its start date, **Due** from
its start date through its end date, and **Overdue** after its end date. **Done**
records completed work, while **Cancelled** records an activity that has been
cancelled.

| If you need to… | Go to |
| --- | --- |
| Find an activity by type or include archived activities | [Find an activity](#find-an-activity) |
| Identify the status in the list and understand the visible columns | [Understand the activity status screen](#understand-the-activity-status-screen) |
| Decide whether the date or completion branch applies | [Choose the applicable status branch](#choose-the-applicable-status-branch) |
| Use a status action on an activity record | [Change an activity status](#change-an-activity-status) |
| Resolve a refused action or list message | [When a status change goes wrong](#when-a-status-change-goes-wrong) |
| Work with the wider activity list | [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities) |
| Create an activity | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) |
| Work from the wider My Desk activity workspace | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) |

## Before you change a status

The activity type selects the activity record surface, and the current status
determines which branch and actions can apply.

**Prerequisites**

- Open an existing activity record.
- Identify the activity type shown by the record surface. The activity record
  uses separate surfaces for visits, meetings, and calls.
- Check whether the record is editable. **Cancel This Activity** and **Undo
  Cancellation** require editing to be allowed.
- Check the activity's start and end dates when deciding between **Planned**,
  **Due**, and **Overdue**.

The status action is not a list-entry field. In the Activities list, the **Status**
cell displays the record's current status. The action itself belongs to the activity
record surface and is conditional on the record's type, status, and editing access.

If the record is not open, continue with [Find an activity](#find-an-activity).

## Find an activity

The Activities list is the workspace for locating an activity and reading its current
status. Use the activity-type filters when the list is broad. Include archived
activities when the activity is no longer in the current list.

**Prerequisites**

- Be signed in to the application.

**Steps**

1. Open the Activities list.

   ![Activities list with the activity filters and Status column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/90feabfc14a9fee5228cbbd9bc9abc01.png)

2. Select the activity filter and archive option that match the activity.

   | If you need to see… | Select |
   | --- | --- |
   | Every activity type | **All** |
   | Visits | **Visits** |
   | Email activities | **Email** |
   | Meetings | **Meetings** |
   | Calls | **Call** |
   | Archived activities | **Show archived activities** |

   ![Activities list with archived activities included](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e118776f3e027299ebd7b7b0b5efb4e9.png)

3. Select the matching row's **Call**, **Visit**, **Mail**, or **Meeting** control.

   Choose the control that matches the activity type you want to open.

**Result:** The matching activity record is open. Continue with [Understand the
activity status screen](#understand-the-activity-status-screen).

## Understand the activity status screen

The activity status screen has two surfaces: the Activities list, where you recognise
the status in a row, and the activity record, where the activity type determines the
record surface and its available status actions.

The displayed list columns come from the selected list layout. The grid displays these
columns:

| Column | What to use it for |
| --- | --- |
| **Title** | Match the activity. |
| **Visitors** | Recognise the people associated with the row. |
| **Activity purpose** | Read the purpose for the row. |
| **Company** | Match the associated company. |
| **Start date** | Check the displayed start date and time. |
| **Status** | Read **Planned**, **Due**, **Overdue**, **Done**, or **Cancelled**. |
| **Importance** | Read the row's importance value. |

The **Status** cell displays the status value; it is not a status-entry field in the
list. The list also exposes **Refresh**, a button titled **table layout**, and **Settings**.

Visit, meeting, and call records use separate activity-type surfaces. The status
actions belong to those record surfaces rather than to the list row.

Continue with [Choose the applicable status branch](#choose-the-applicable-status-branch)
to identify the action for the current record.

## Choose the applicable status branch

Choose a date branch when you are checking the activity's time position. Choose a
record-action branch when you are completing, reopening, cancelling, or restoring an
activity.

**Prerequisites**

- Open an existing visit, call, or meeting activity record.
- Identify the current status before selecting an action.

**Steps**

1. Read the activity's start and end dates.

2. Choose the row that matches the activity's dates, status, and editing access.

| Check the activity | Applicable status or action |
| --- | --- |
| Today is before the start date | **Planned** |
| Today is on or after the start date and on or before the end date | **Due** |
| Today is after the end date | **Overdue** |
| The activity is due or overdue and you are completing it | **Done** |
| The activity is done and you are reopening its work | **Consider As Not Done** |
| The activity is planned, due, or overdue and editing is allowed | **Cancel This Activity** |
| The activity is cancelled and editing is allowed | **Undo Cancellation** |

The activity type matters for the completion branches: **Done** and **Consider As
Not Done** are provided on visit, call, and meeting records. The cancellation actions
apply only to **Planned**, **Due**, and **Overdue** activities, and also depend on
editing access.

**Result:** You have identified the status branch and the action to use on the
activity record. Continue with [Change an activity status](#change-an-activity-status).

## Change an activity status

Use a status action on an existing visit, call, or meeting record when the record's
current status and editing access meet the action's condition.

**Prerequisites**

- Open an existing visit, call, or meeting activity record.
- Confirm that the record is editable when using a cancellation action.
- Identify the current status before selecting an action.

**Steps**

1. In the activity record, select the action identified in [Choose the applicable
   status branch](#choose-the-applicable-status-branch).

2. Read the **Status** value on the activity record after the action completes.

   ![Meetings activity list with the configured status column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0490d7c66087de4daf726b47fe767327.png)

**Result:** The activity record is ready for you to read the status value and continue
with the applicable step in the follow-up flow. Continue with [When a status change
goes wrong](#when-a-status-change-goes-wrong) if the action does not complete.

## When a status change goes wrong

Use the message on screen to distinguish an activity-record condition from a list or
request problem.

| What you see | What it means | What to do |
| --- | --- | --- |
| `This action is only allowed if you belong to that branch` | The activity action is restricted to the applicable branch. | Return to the activity record and check the current status, activity type, and editing access. |
| `One topic and at least one note is required` | The completion path requires a topic and at least one note. | Add the required topic and note before completing the activity. |
| `There is no topic to print` | The activity has no topic available for printing. | Return to the activity record and work from the activity details. |
| `An error occurred while processing your request` | The activity request did not complete. | Check the activity record and repeat the applicable action when the record is available. |
| `Your request was completed successfully` | The activity-list request completed successfully. | Continue with the list or open the relevant activity row. |
| `Forbidden characters detected. Please remove them and try again.` | The activity-list request contains forbidden characters. | Remove the forbidden characters and submit the list request again. |
| `Action not allowed` | The activity-list action is not allowed in the current list condition. | Return to the list and choose an allowed activity-list action. |

Use a status action only when the matching control is present on the activity record.
Use the **Status** column for status recognition in the list; use the activity record
for the status action.

After resolving the message, return to [Change an activity status](#change-an-activity-status)
or continue to [After checking or changing a status](#after-checking-or-changing-a-status).

## After checking or changing a status

After checking a status, return to the Activities list when you need to review more
rows. The list provides the activity-type filters, the **Show archived activities**
option, and the **Status** column for that review.

After a status action, read the activity record's **Status** value before continuing.
For activity creation, continue with [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity). For
broader work in the activity workspace, continue with [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities).
For shared list orientation and list-level work, continue with [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities).
