# Record activities from My Desk

Use the standalone **Activities** tab in **My Desk** to review and filter activities
across jobs, or add a Visit, Meeting, or Call. For work belonging to one sales job,
continue on the sales job record.

## Record activities from My Desk

Use the standalone **Activities** tab when you need to review or add activities
without first narrowing the work to one sales job. The tab is available when the
Activities subscription is available and you are not a principal user.

| If you need to… | Go to |
|---|---|
| Check the subscription, role, and information needed first | [Before you start](#before-you-start) |
| Open and recognise the all-job activity list | [Find and review activities](#find-and-review-activities) |
| Switch activity types or include archived rows | [Filter the activity list](#filter-the-activity-list) |
| Add a Visit, Meeting, or Call | [Add a Visit, Meeting, or Call](#add-a-visit-meeting-or-call) |
| Complete the fields for the selected type | [Choose the activity type and handle its differences](#choose-the-activity-type-and-handle-its-differences) |
| Resolve an unavailable surface or refused action | [When activity work goes wrong](#when-activity-work-goes-wrong) |
| Continue activity work for one sales job | [Continue with job-filtered activity work](#continue-with-job-filtered-activity-work) |
| Work with the wider workspace | [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) |
| Create an activity from its companion page | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) |
| Record activities on a sales job | [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) |

The My Desk **Activities** tab is disabled for principal users. For one sales job,
use [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files).

The **Email** option belongs to list filtering; the My Desk add menu supports only
**Visit**, **Meeting**, and **Call**.

## Before you start

The activity list and its add forms depend on the subscription, your user role, the
selected activity type, and the information you enter before saving.

| Before you start | What must be true |
|---|---|
| Subscription | The Activities subscription is available. |
| User role | You are not a principal user. |
| Activity form | You select **Visit**, **Meeting**, or **Call** before that form appears. |
| Activity information | The required activity information is ready before you select **Save** or **Save and Close**. |

The selected type determines which form appears. Enter the information that applies
to that type before saving.

## Find and review activities

The activity list shows activities available from **My Desk**. Its visible columns are:

- **Title**
- **Visitors**
- **Activity purpose**
- **Company**
- **Start Date**
- **Status**
- **Importance**

**Prerequisites**

- The Activities subscription is available.
- You are not a principal user.

**Steps**

1. Open **My Desk**.
2. Select **Activities**.

   ![Select Activities in My Desk to open the all-job activity workspace](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/609dec0cc70ac4e6e13f5bd2dbdd9b79.png)

3. Read the activity rows under the visible column headers.
4. Read **Status** to identify whether a row is `Planned`, `Overdue`, or `Done`.
5. Read **Importance** to identify whether a row is `High`, `Medium`, or `Low`.

   ![Activity rows with the visible list columns and values](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6a9dfc73cc470c0cf7f65695a01f24da.png)

**Result:** The all-job activity list is open. You can now filter its rows by activity
type or include archived rows.

## Filter the activity list

Use the activity-type filters to change which rows the list displays. Include archived
rows when they are outside the current list.

**Prerequisites**

- The activity list is open from **My Desk**.

**Steps**

1. Select the filter that matches the activity set you need.

   | If you need to see… | Select |
   |---|---|
   | All activity types | **All** |
   | Visits | **Visits** |
   | Email activities | **Email** |
   | Meetings | **Meetings** |
   | Calls | **Call** |

2. Read the visible rows for the selected activity set.

   ![All activity types selected in the Activities list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/342f6aa052c3dc3606f14b05ce6da58b.png)

3. Select **Show archived activities** when you need archived activities included.

   ![Archived activities included in the Activities list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/cccdc0dfb049027718e0e42f30e7ae06.png)

4. Read the updated rows after the filter changes.

When the list request completes successfully, it reports
`Your request was completed successfully`.

**Result:** The list shows the selected activity set, with archived activities included
when **Show archived activities** is selected. You can now open the add menu to record
a Visit, Meeting, or Call.

## Add a Visit, Meeting, or Call

Use the My Desk add menu to create an activity from the all-job workspace. The activity
opens in a popup with **Save** and **Save and Close** for non-email activities.

**Prerequisites**

- The Activities subscription is available.
- You are not a principal user.
- You have the required information for the activity type you plan to select.

**Steps**

1. Open the add menu in **My Desk**.
2. Select the activity type you want to record.

   | If you are recording… | Select |
   |---|---|
   | A visit | **Visit** |
   | A meeting | **Meeting** |
   | A call | **Call** |

   ![My Desk add menu with Visit, Meeting, and Call](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2f2c14676b9d02c9355c17aae1e46e69.png)

3. Complete the form for the selected activity type.
4. Choose one save action.

   | Save action | Result |
   |---|---|
   | **Save** | Keep the activity form open |
   | **Save and Close** | Leave the activity form |

The form checks the information before saving. A successful save reports
`Data saved Successfully` and leaves the page.

**Result:** The selected Visit, Meeting, or Call is submitted from the activity popup,
and a successful save reports `Data saved Successfully`. Use the field differences in
the next section when completing another activity.

## Choose the activity type and handle its differences

Visit, Meeting, and Call are separate activity forms. Each type has its own required
fields and optional details.

| Activity type | Required fields | Optional or type-specific areas |
|---|---|---|
| Visit | **Priority**, **Visit Purpose**, **Start Date**, **End Date** | **To**, **Tags**, **Visitors**, **Discussion partner**, **Visit type** |
| Meeting | **Priority**, **Meeting Purpose**, **Start Date**, **End Date** | **Location**, **Tags**, **Participant** |
| Call | **Priority**, **Start Date** | **Call To**, **Tags**, **Call Number**, **Call Use**, **Description** |

**Prerequisites**

- The activity popup is open.
- You have selected **Visit**, **Meeting**, or **Call**.
- The required information for that type is ready.

**Steps**

1. Complete the required fields for the selected type.

   | Selected type | Complete |
   |---|---|
   | Visit | **Priority**, **Visit Purpose**, **Start Date**, and **End Date** |
   | Meeting | **Priority**, **Meeting Purpose**, **Start Date**, and **End Date** |
   | Call | **Priority** and **Start Date** |

2. Complete the optional or type-specific areas that apply.

   | Selected type | Areas |
   |---|---|
   | Visit | **To**, **Tags**, **Visitors**, **Discussion partner**, and **Visit type** |
   | Meeting | **Location**, **Tags**, and **Participant** |
   | Call | **Call To**, **Tags**, **Call Number**, **Call Use**, and **Description** |

3. Keep **End Date** on or after **Start Date** for a Visit or Meeting.

   ![Visit form with required fields and Visit-specific areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/48c7dad9176df55d23c5a6a22a17b200.png)

The Call form has no active **End Date** field. Use the values presented in the form for
type-specific selectors.

After an activity is saved, the record can expose **Attachment** and **Last Modifications**
tabs. **Last Modifications** applies to saved non-email activities. Existing activity
records also expose status actions according to their current status and editing access:

| Current condition | Action available |
|---|---|
| Activity is due or overdue | **Done** |
| Activity is done | **Consider As Not Done** |
| Activity is planned, due, or overdue and editable | **Cancel This Activity** |
| Activity is cancelled and editable | **Undo Cancellation** |

**Result:** The selected form contains the required values and the optional areas that
apply to its activity type. If saving succeeds, use the saved activity's tabs and status
actions as needed; otherwise, use the messages in the next section.

## When activity work goes wrong

Use the surface and message on screen to identify whether the subscription, a required
value, the list request, or the current row condition stopped the action.

| What you see | What it means | What to do |
|---|---|---|
| The subscription-upgrade surface replaces the activity list or form. | The Activities subscription is unavailable. | Make the Activities subscription available before returning to the list or form. |
| `Priority is required` | A Visit or Meeting does not have the required Priority value. | Complete **Priority** before selecting **Save** or **Save and Close**. |
| `Title is required` | A Visit or Meeting does not have the required purpose/title value. | Complete the activity purpose before saving. |
| `Start Date is required` | A Visit or Meeting does not have a Start Date. | Complete **Start Date** before saving. |
| `Date is required` | A Call does not have the required date. | Complete **Start Date** before saving. |
| `Action not allowed` | The current activity-list action is not allowed. | Return to the list and choose an available action. |
| `Forbidden characters detected. Please remove them and try again.` | The list request contains forbidden characters. | Remove the forbidden characters and submit the request again. |
| Delete is unavailable for the row. | Delete is available only when the row is not Mail, belongs to the same branch, and meets the owner condition. | Use Delete only for an eligible row. |
| A server save error is returned. | The save handler uses the returned error message rather than a fixed message. | Read the returned message and correct the activity information or access condition it identifies. |

### Out of scope messages

The following messages belong to contacts, tasks, files, topics, or other activity
stages. Use the owning page when one of these appears.

| Message | Owning area |
|---|---|
| `You already have a contact with this name` | Contacts |
| `This record is related to saved data and cannot be deleted` | My Desk Tasks |
| `This action is only allowed if you belong to that branch` | Activity status and record actions |
| `One topic and at least one note is required` | Activity topics |
| `There is no topic to print` | Print minutes of activity |
| `An error occurred while processing your request` | Shared activity actions |
| `Just '_'‘-''.' And '&' Characters Accepted` | Files |

These messages do not describe the My Desk activity-list filters or the new Visit,
Meeting, and Call entry fields.

## Continue with job-filtered activity work

When the activity belongs to one sales job, continue on that job's record so the
activity remains associated with that job.

**Prerequisites**

- You know which sales job owns the activity.
- You have access to the sales job record.

**Steps**

1. Open the sales job record that owns the activity.
2. Open its **Activities** area.
3. Record or review the job-filtered activity there.

**Result:** You are working with activities filtered to the selected sales job. For
that procedure, continue with [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files).
