# Create an activity

An activity is the record you create for a **Visit**, **Meeting**, or **Call**. Choose the type
that matches the work you need to record, then complete its activity-specific form.

| If you need to… | Go to |
|---|---|
| Record a visit with dates, a destination, and visit details | [Visit fields](#visit-fields) |
| Record a meeting with dates, a location, and participants | [Meeting fields](#meeting-fields) |
| Record a call with a contact, call details, and a description | [Call fields](#call-fields) |
| Choose between the two save controls | [Save the activity](#save-the-activity) |
| Continue with status actions and saved-record tools | [After creating the activity](#after-creating-the-activity) |

The new-activity menu contains **Visit**, **Meeting**, and **Call**. Email is not available in
this menu. Activities use the statuses **Planned**, **Overdue**, **Done**, **Due**, and
**Cancelled**.

```mermaid
flowchart LR
    New[New activity] --> Visit[Visit]
    New --> Meeting[Meeting]
    New --> Call[Call]
    Visit --> Planned[Planned]
    Meeting --> Planned
    Call --> Planned
```

## Before you start

You need a signed-in session that can open the new activity page.
Decide whether to create a **Visit**, **Meeting**, or **Call**.

The activity form shows its subscribed surface when the subscription includes the activity
feature. If the subscription does not include it, the page shows the upgrade surface instead.
The **Save** and **Save and Close** choices require an activity record, an available subscription,
and a new non-mail activity form.

Collect the information that belongs to the activity type before opening the form.

| Activity type | Have this information ready | Why it matters |
|---|---|---|
| Visit | Start and end dates, destination, visit type, purpose, and participants | These values describe where the visit takes place, when it takes place, and who takes part. |
| Meeting | Start and end dates, location, participants, and meeting purpose | These values identify the meeting and its participants. |
| Call | Start date, contact, call use, call number, and description | These values identify the call and preserve its purpose and detail. |

## Find the activity form

Prerequisites

- You are signed in.
- Your subscription includes the activity surface.
- You know whether you are creating a Visit, Meeting, or Call.

Steps

1. Select **Add new** for the activity type you want to create.

   | Activity type | Select |
   |---|---|
   | Visit | **Visit** |
   | Meeting | **Meeting** |
   | Call | **Call** |

**Result:** The new form for the selected activity type is on screen. Continue with
[Understand the activity form](#understand-the-activity-form).

For list entry points and activity filters, see [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities).

## Understand the activity form

The new activity form shares **Save** and **Save and Close** across Visit, Meeting, and Call.
The selected activity branch changes the fields shown below these controls.
The selected branch remains the basis for the activity-specific fields you complete.
Review the fields for the selected branch before entering the activity details.

| Branch | Fields shown on the new form | Required markers shown on this form |
|---|---|---|
| Visit | **Visit Purpose**, **To**, **Start Date**, **End Date**, **Visit type** | **Start Date** and **End Date** |
| Meeting | **Meeting Purpose**, **Location**, **Start Date**, **End Date** | **Start Date** and **End Date** |
| Call | **Call Purpose**, **Call To**, **Call Use**, **Call Number**, **Start Date**, **Description** | **Start Date** |

The form also contains activity-specific or conditional surfaces. **Tags**, **Visitors**,
**Discussion partner**, **Participant**, **Show only for Participant**, **Prevent other participants
to make changes**, **Prepared By**, and **Signature** can appear as labels or in a branch rather than as
labelled widgets.

> **Note:** Required markers apply only to the forms where they appear.

After an activity ID exists, **Attachment** and **Last Modifications** are available under their
record conditions. **Last Modifications** is excluded for mail. Continue with the section for the
selected activity type.

   ![The Meeting form with its shared and meeting-specific fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e5ec791902e284fd516a37a69bcc6d7e.png)

### Visit fields

A Visit is the activity branch for visit-specific details such as a destination, visitors, or a
discussion partner.

Prerequisites

- You opened the new Visit form.
- You have the visit dates and the visit information to enter.

Steps

1. In **Visit Purpose**, choose the purpose for the visit.
2. In **To**, choose or enter the destination.
3. In **Start Date**, enter the visit start date.
4. In **End Date**, enter the visit end date.
5. In **Visit type**, choose the visit type.
6. If the form shows them, complete **Tags**, **Visitors**, and **Discussion partner**.
7. If the form shows **Prevent other participants to make changes**, select its checkbox when
   that restriction applies.

**Result:** The Visit form contains the visit purpose, destination, required dates, and any visit
choices and participants you entered. Continue with [Controls on a new activity](#controls-on-a-new-activity).

   ![The Visit fields including the required start and end dates](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/68b0ed36b0486d2aa7d7aad6b60de746.png)

### Meeting fields

A Meeting is the activity branch for meeting-specific details such as a location and participants.

Prerequisites

- You opened the new Meeting form.
- You have the meeting dates, location, purpose, and participant information to enter.

Steps

1. In **Meeting Purpose**, choose the purpose for the meeting.
2. In **Location**, choose the meeting location.
3. In **Start Date**, enter the meeting start date.
4. In **End Date**, enter the meeting end date.
5. If the form shows **Participant**, choose the people taking part.
6. If the form shows **Show only for Participant**, select its checkbox when the meeting must be
   limited to the selected participant.
7. If the form shows **Prevent other participants to make changes**, select its checkbox when
   that restriction applies.

**Result:** The Meeting form contains the meeting purpose, location, required dates, and any
participants and meeting options you entered. Continue with [Controls on a new activity](#controls-on-a-new-activity).

### Call fields

A Call is the activity branch for call-specific details such as a contact, call use, and call
details.

Prerequisites

- You opened the new Call form.
- You have the call date, contact, call use, call number, and description to enter.

Steps

1. In **Call Purpose**, choose the purpose for the call.
2. In **Call To**, choose the contact or user for the call.
3. In **Call Use**, choose the use of the call.
4. In **Call Number**, choose the call number.
5. In **Start Date**, enter the call start date.
6. In **Description**, enter the call details.
7. If the form shows **Tags**, choose the tags for the call.

**Result:** The Call form contains the required start date and any call details, contact choice,
and description you entered. Continue with [Controls on a new activity](#controls-on-a-new-activity).

   ![The Call fields including Call Use, Call Number, and Description](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bb49658d64271aa87e0a9f698c1411fe.png)

### Controls on a new activity

Before an activity ID exists, the shared controls on the new form are **Save** and **Save and
Close**. After an activity ID exists, the record can expose **Attachment** and **Last
Modifications**. Existing records can also show status actions.

| Control or surface | When it applies | What it is for |
|---|---|---|
| **Save** | On the new activity form when the subscription is available | Save the activity while remaining on the activity form. |
| **Save and Close** | On the new activity form when the subscription is available | Save the activity and close the activity form. |
| **Attachment** | When an activity ID exists | Open the attachment area for the saved activity. |
| **Last Modifications** | When an activity ID exists, except for mail | Open the activity audit-log area. |

The status actions **Done**, **Consider As Not Done**, **Cancel This Activity**, and **Undo
Cancellation** belong to existing Meeting, Visit, or Call records under their status conditions.
Continue with [Save the activity](#save-the-activity).

## Enter the activity details

Required markers appear on **Start Date** and **End Date** for Visit and Meeting, and on **Start Date** for Call. Other controls do not show a required marker.

**Note:** Required markers apply only to the forms listed here.

Prerequisites

- You opened the new form for the correct activity type.
- You have the dates, choices, participants, and free text for that activity.

Steps

1. Select the activity branch you need.

   | If you are recording… | Complete these fields |
   |---|---|
   | A Visit | **Visit Purpose**, **To**, **Start Date**, **End Date**, and **Visit type** |
   | A Meeting | **Meeting Purpose**, **Location**, **Start Date**, and **End Date** |
   | A Call | **Call Purpose**, **Call To**, **Call Use**, **Call Number**, **Start Date**, and **Description** |

2. Enter the required dates for the selected branch.
3. Choose the activity-specific options and participants that apply.
4. Enter free text in **Description** when you are recording a Call.
5. Review the visible required markers before selecting a save control.

**Result:** The selected activity form contains the activity details supported by its visible
fields, without relying on an assumed default value.

## Save the activity

Prerequisites

- You completed the fields for the selected activity type.
- The form shows **Save** and **Save and Close**.

Steps

1. Select the control that matches the result you want.

   | Result | Control |
   |---|---|
   | Remain on the activity form | **Save** |
   | Close the activity form after saving | **Save and Close** |

Select **Save** when you need to continue working on the activity form.

**Result:** The activity is saved using the selected control. Continue with
[When activity creation goes wrong](#when-activity-creation-goes-wrong) if the screen displays an
error; otherwise continue with [After creating the activity](#after-creating-the-activity).

## When activity creation goes wrong

Use the message on screen to identify the branch or condition that stopped the action.

| What you see | What it means | What to do |
|---|---|---|
| `This action is only allowed if you belong to that branch` | The action is restricted to members of the relevant branch. | Use the activity route and branch available to you. |
| `One topic and at least one note is required` | The topic action requires one topic and at least one note. | Add the required topic and note before using that action. |
| `There is no topic to print` | There is no topic available for the print action. | Use the print action only when a topic exists. |
| `An error occurred while processing your request` | The request could not be processed. | Check the action and the information on the form before trying again. |

The following messages belong to related contact, file, library, and task workflows:

| Message | Related workflow |
|---|---|
| `You already have a contact with this name` | Contact creation |
| `Your request was completed successfully` | File or library maintenance |
| `Just '_'‘-''.' And '&' Characters Accepted` | File or library maintenance |
| `This record is related to saved data and cannot be deleted` | Task or file deletion |
| `Forbidden characters detected. Please remove them and try again.` | Task maintenance |
| `Action not allowed` | Task maintenance |

The activity branch changes with the route value. A Visit form has **End Date**; a Meeting form
has **End Date**; the Call form does not have an **End Date** control. **Attachment** and **Last
Modifications** depend on an activity ID, so they are not new-form controls.

Continue with [After creating the activity](#after-creating-the-activity).

## After creating the activity

Use the saved record's available controls for its status actions.

For record-level status actions, see [Activity status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/activity-status). For the broader
personal activity workspace, see [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities). Return to
[Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities) for the activity list and its activity work.
