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 |
| Record a visit, meeting, or call | Record a visit, meeting, or call |
| Associate a supporting file | Attach and manage supporting files |
| Find the saved job first | 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.
Steps
- Open the My Desk screen.
- Open the saved sales job from the sales-job work area.
- Select Activities to open the job's activity list.
- 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
-
Select the plus action in the activity-list toolbar on the Activities surface.
-
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 -
Select a value in Priority.
-
Select the activity topic in the required topic field.
-
Enter the activity subject in the required subject field.
-
Enter the applicable date fields.
Activity type Enter Visit Start Date and End Date Meeting Start Date and End Date Call Start Date -
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. -
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
-
Select Attach File on the attachment panel.
-
In the file-library flow, select the required Category.
-
Continue the file-library operation using its controls.
-
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.
Was this page helpful?