# Activities and attachments on a sales job

## Activities and attachments on a sales job

A saved sales job is the job record that keeps its follow-up work and supporting documents.
Use **Activities** to record visits, meetings, and calls. Use **Attachment** to associate
supporting files with the same record.

| If you need to… | Go to |
|---|---|
| Check the job's visits, meetings, or calls | [Understand the activities and files surfaces](#understand-the-activities-and-files-surfaces) |
| Record a visit, meeting, or call | [Record a visit, meeting, or call](#record-a-visit-meeting-or-call) |
| Associate a supporting file | [Attach and manage supporting files](#attach-and-manage-supporting-files) |
| Find the saved job first | [Find sales job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/find-sales-job-work) |
| Review broader activity work | The `tasks-and-activities` and `my-desk-activities` pages |
| Work with the file library | The `libraries-files` page |

## Before you start

The Activities and Attachment surfaces belong to an existing saved sales job. Before you
open them, have the following in place:

| Requirement | Why it matters |
|---|---|
| An existing saved sales job | The **Activities** and **Attachment** tabs require a saved job. |
| The Activities feature enabled | This feature controls whether **Activities** is available. |
| The Attachments feature enabled | This feature controls whether **Attachment** is available. |
| A non-principal user account | Both tabs are guarded against principal users. |
| New-activity permission | The creation action and its **Visit**, **Meeting**, and **Call** choices require this permission. |
| An editable record context | The new-activity plus action requires an editable record context. |
| A related record and a writable attachment panel | **Attach File** requires a related record and a panel that is not read-only. |

The page itself must also be available. When the page is unavailable, the Activities and
Attachment tab conditions do not open their surfaces.

> **Note:** Activities and attachments are separate features. If one tab is available and
> the other is not, continue with the available surface and contact your administrator about
> the missing feature.

## Find the sales job and open related work

Related work is the activity list or attachment panel belonging to the saved sales job.
Open it from the My Desk screen, where the saved job is the record context.

Prerequisites

- You have an existing saved sales job.
- You meet the conditions in [Before you start](#before-you-start).

Steps

1. Open the My Desk screen.
2. Open the saved sales job from the sales-job work area.
3. Select **Activities** to open the job's activity list.
4. Select **Attachment** to open the files attached to the job.

Selecting **Activities** opens the activity list. Selecting **Attachment** opens the file
panel. Keep the saved job open when you choose either related-work tab.

**Result:** The saved sales job is open with either its activity list or its attachment
panel on screen.

## Understand the activities and files surfaces

The **Activities** surface is the job's activity list. The **Attachment** surface is the
job's attachment panel. Activity actions belong to the activity list; file actions belong to
the attachment panel and its file-library hand-off.

On **Activities**, use **Show archived activities** when archived activities need to be
included in the list. Use **Export** to start an activity-list export. The activity-list
columns come from your saved list layout, so work from the headers visible in your list
rather than expecting a fixed set of columns.

On **Attachment**, use **Attach File** to open the file library from the job's attachment
surface. Existing-file actions are icon-only in this region. They are available only when
attached files exist, loading has finished, no error is present, and the panel is not
read-only. The file library owns the file-selection and broader file-management flow.

The activity creation action is available only on the Activities branch when the same
feature and permission conditions are true and the record is editable. Its menu contains
**Visit**, **Meeting**, and **Call**.

### Activity fields

An activity records what happened or is planned, when it happens, and the topic and subject
that identify it. The required and optional fields depend on whether you choose a visit,
meeting, or call.

| Activity type | Required fields | Optional fields |
|---|---|---|
| Visit | **Priority**, unlabeled topic control, unlabeled subject control, **Start Date**, **End Date** | **Visit type** |
| Meeting | **Priority**, unlabeled topic control, unlabeled subject control, **Start Date**, **End Date** | — |
| Call | **Priority**, unlabeled topic control, unlabeled subject control, **Start Date** | **Call Use**, **Description** |

The choices for **Priority**, the topic control, **Visit type**, and **Call Use** load at
runtime. Select from the choices shown in your activity form.

### File fields and columns

An attachment classifies a supporting file against the saved sales job. The required field
on this surface is **Category**.

| Field or control | What to use |
|---|---|
| **Category** | Select the attachment category. This select is required. |
| File name | The attachment surface does not expose a labelled file-name control. |
| Download | Existing-file download is an icon-only action in this region. |
| Unlink | Existing-file unlink is an icon-only action in this region. |
| File columns and contents | They depend on the attachments available at runtime. |

The file library supplies the file-selection flow. When the conditions are met, select the
icon-only action beside the attached file.

## Record a visit, meeting, or call

Record a visit, meeting, or call against the saved sales job by choosing an activity type,
entering its fields, and completing it with **Done**.

Prerequisites

- The saved sales job is open on **Activities**.
- The new-activity action is available because the record is editable and you have new-activity permission.
- You have the activity topic, subject, timing, and any applicable visit or call details.

Steps

1. Select the plus action in the activity-list toolbar on the **Activities** surface.
2. Choose the activity type that matches the work you are recording.

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

3. Select a value in **Priority**.
4. Select the activity topic in the required topic field.
5. Enter the activity subject in the required subject field.
6. Enter the applicable date fields.

   | Activity type | Enter |
   |---|---|
   | Visit | **Start Date** and **End Date** |
   | Meeting | **Start Date** and **End Date** |
   | Call | **Start Date** |

7. Enter the optional details for the selected activity type.

   | Activity type | Optional details |
   |---|---|
   | Visit | Select **Visit type**. |
   | Meeting | — |
   | Call | Select **Call Use** and enter **Description**. |

8. Complete the activity with **Done**.

The activity must contain one topic and at least one note. If that requirement is not met,
the activity does not complete and the screen displays `One topic and at least one note is
required`.

**Result:** The selected visit, meeting, or call is completed on the saved sales job, or the
validation message identifies the information to add.

## Attach and manage supporting files

Use the attachment surface to associate a supporting file with the saved sales job. File
selection and broader file management remain in the file library.

Prerequisites

- The saved sales job is open on **Attachment**.
- A related record exists.
- The attachment panel is not read-only.
- The attachment dropdown is open when you use the compact panel.

Steps

1. Select **Attach File** on the attachment panel.
2. In the file-library flow, select the required **Category**.
3. Continue the file-library operation using its controls.
4. When an existing attachment is available, select the applicable icon-only action beside
   the attached file after loading has finished and when no error is present.

   | If you need to… | Select… |
   |---|---|
   | Download the attached file | the download action |
   | Unlink the attachment | the unlink action |

If **Category** is empty, the required-field message is `This Field Is Required`.

**Result:** The supporting file is associated with the saved sales job, or the file library
is open for the remaining file operation.

## Handle activity status and activity choices

An activity's status determines which action is available after the activity exists. The
activity detail surface uses the activity ID, its current status, and your edit permission
to decide which status action appears.

| Activity state | Available action |
|---|---|
| Existing due or overdue activity | **Done** changes it to done. |
| Existing editable planned, overdue, or due activity | **Cancel This Activity** cancels it. |
| Existing editable cancelled activity | **Undo Cancellation** reopens it. |

These choices require an existing activity ID. **Cancel This Activity** and **Undo
Cancellation** also require edit permission. The status-specific state guard can hide an
action when the activity is in another state.

## When an activity or file action fails

Use the message on screen to choose the corrective action. The messages below belong to
the activity and attachment surfaces covered by this page.

| Message | Corrective action |
|---|---|
| `One topic and at least one note is required` | Add a topic and at least one note before completing the activity. |
| `This action is only allowed if you belong to that branch` | Use an account that belongs to the required branch. |
| `There is no topic to print` | Add a topic before using the activity print action. |
| `Your request was completed successfully` | Treat the activity-list request as completed and review the refreshed list. |
| `Action not allowed` | Stop the action and use an activity-list operation permitted for your account. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the activity-list input and submit it again. |
| `This Field Is Required` | Select **Category** before continuing with the attachment. |
| `An error occurred while processing your request` | Review the activity details and repeat the action; if it continues, use the owning activity support route. |

The activity actions can also be unavailable when the activity ID, current status, edit
permission, feature, branch, or record context does not meet the action's condition.

### Out of scope

The following messages belong to purchasing, item-grid, lifecycle, or other sales-job
surfaces. Use the relevant area when one of these messages appears.

| Message | Owning area |
|---|---|
| `Required Receiving Date` | Sales-job purchasing panels |
| `This record is related to saved data and cannot be deleted` | Tasks page |
| `This field is required` | Sales-job item grids |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Sales-job item grids |
| `Invalid input. Please enter a non-negative value` | Sales-job item grids |
| `Custom fields saved successfully` and `Error saving custom fields` | Sales-job custom-fields page |
| `Job updated successfully`, `Job deleted successfully`, `Job regretted successfully`, `Job cancelled successfully`, `Job missed successfully`, and `Job reactivated successfully` | Sales-job lifecycle and header page |
| `Converted to offer successfully` and `Converted to inquiry successfully` | Sales-job lifecycle and header page |
| Offer, inquiry, cost-sheet, purchasing, product, account, project, contact, bill-of-materials, serial, guarantee, and delivery validations | Their owning sales-job or related page |

### Out of scope

The activity-list headers depend on the saved list layout. Attachment contents, existing
file names, icon-only control positions, and the initial collapsed or expanded state of the
attachment panel depend on what is available at runtime. The file library owns upload,
linking, and category-edit work; continue there for those operations. The two required
activity controls have no labels on this surface, and the select options load at runtime.

## After you record the activity or attach the file

After completion, review the activity in the saved job's **Activities** surface. Use
**Show archived activities** to include archived entries and **Export** to start an
activity-list export. After attaching a file, review it on the **Attachment** surface and
select the icon-only action beside the attached file when its conditions are met.

For the broader activity workspace, continue to `tasks-and-activities` or
`my-desk-activities`. For comments and tasks associated with the saved job, continue to
`sales-job-comments-and-tasks`. For file-library upload, linking, and management, continue
to `libraries-files`. The saved sales-job record and common record work belong to
`sales-job-record`.
