Skip to content
D
Documentation

Activities and attachments on a sales job

task
9 min readUpdated

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 callsUnderstand the activities and files surfaces
Record a visit, meeting, or callRecord a visit, meeting, or call
Associate a supporting fileAttach and manage supporting files
Find the saved job firstFind sales job work
Review broader activity workThe tasks-and-activities and my-desk-activities pages
Work with the file libraryThe 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:

RequirementWhy it matters
An existing saved sales jobThe Activities and Attachment tabs require a saved job.
The Activities feature enabledThis feature controls whether Activities is available.
The Attachments feature enabledThis feature controls whether Attachment is available.
A non-principal user accountBoth tabs are guarded against principal users.
New-activity permissionThe creation action and its Visit, Meeting, and Call choices require this permission.
An editable record contextThe new-activity plus action requires an editable record context.
A related record and a writable attachment panelAttach 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.

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

  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 typeRequired fieldsOptional fields
VisitPriority, unlabeled topic control, unlabeled subject control, Start Date, End DateVisit type
MeetingPriority, unlabeled topic control, unlabeled subject control, Start Date, End Date—
CallPriority, unlabeled topic control, unlabeled subject control, Start DateCall 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 controlWhat to use
CategorySelect the attachment category. This select is required.
File nameThe attachment surface does not expose a labelled file-name control.
DownloadExisting-file download is an icon-only action in this region.
UnlinkExisting-file unlink is an icon-only action in this region.
File columns and contentsThey 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 visitVisit
    A meetingMeeting
    A callCall
  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 typeEnter
    VisitStart Date and End Date
    MeetingStart Date and End Date
    CallStart Date
  7. Enter the optional details for the selected activity type.

    Activity typeOptional details
    VisitSelect Visit type.
    Meeting—
    CallSelect 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 filethe download action
    Unlink the attachmentthe 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 stateAvailable action
Existing due or overdue activityDone changes it to done.
Existing editable planned, overdue, or due activityCancel This Activity cancels it.
Existing editable cancelled activityUndo 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.

MessageCorrective action
One topic and at least one note is requiredAdd a topic and at least one note before completing the activity.
This action is only allowed if you belong to that branchUse an account that belongs to the required branch.
There is no topic to printAdd a topic before using the activity print action.
Your request was completed successfullyTreat the activity-list request as completed and review the refreshed list.
Action not allowedStop 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 RequiredSelect Category before continuing with the attachment.
An error occurred while processing your requestReview 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.

MessageOwning area
Required Receiving DateSales-job purchasing panels
This record is related to saved data and cannot be deletedTasks page
This field is requiredSales-job item grids
Invalid input. The value must be greater than 0 and cannot exceed 999,999.00Sales-job item grids
Invalid input. Please enter a non-negative valueSales-job item grids
Custom fields saved successfully and Error saving custom fieldsSales-job custom-fields page
Job updated successfully, Job deleted successfully, Job regretted successfully, Job cancelled successfully, Job missed successfully, and Job reactivated successfullySales-job lifecycle and header page
Converted to offer successfully and Converted to inquiry successfullySales-job lifecycle and header page
Offer, inquiry, cost-sheet, purchasing, product, account, project, contact, bill-of-materials, serial, guarantee, and delivery validationsTheir 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?

Need help using the product?