Skip to content
D
Documentation

My Desk workspace

concept
18 min readUpdated

Use My Desk to narrow your daily work, choose a list or work view, and hand a linked record to the page that owns it.

Before you start

My Desk is a personal, filterable daily workspace. It brings together lists, graphs, tasks, activities, and calendar appointments; it is not a sales-job record. Its scope can include a client, vendor, project, sales-responsible person, contact, and team. A scope is the client, vendor, project, sales-responsible person, contact, or team that limits the work shown in the workspace. When you open a linked record, My Desk shows that record for inspection and hands edits to the record's owning page.

The standard workspace is titled My Desk. Principal users see Principal Desk and choose a client for the workspace. A principal user is a user who works from Principal Desk and chooses a client scope.

If you need to…Go to
Narrow the records in your workspaceFocus work and choose a list group
Choose a list, graph, task, activity, or calendar viewChoose a work mode
Add a task or activityAdd a task or activity from My Desk
Complete or delete a taskAct on a task row
Continue work on a linked recordOpen and hand off a linked record
Understand principal-user or subscription differencesHandle principal-user and subscription variations
Find the meaning of an opened-panel messageMessages from linked panels
Work with standalone tasksMy Desk tasks
Record standalone activitiesMy Desk activities
Work with dashboard graphsDashboard overview
Create a taskCreate a task
Create an activityCreate an activity
Continue a sales job, invoice, principal invoice, L/G, account, project, contact, user, or teamIts owning record page

Prerequisites

My Desk requires the My Desk module subscription. If the module is not included in your plan, the workspace content is replaced by a subscription page with Upgrade needed, the message The feature you are trying to use is not included in your current plan. Please upgrade your plan., and Upgrade now and Back actions.

Principal users use Principal Desk with a searchable client field. Their personal Tasks, Activities, and Calendar tabs are disabled. Calendar also requires the Calendar subscription.

Note: My Desk is a hand-off workspace. Use the owning page when you need the full record form or the form's messages.

Focus work and choose a list group

Use the lists area to review current or archived work within the scope you select.

Prerequisites

  • You have access to the My Desk workspace.
  • You know which client, vendor, project, sales-responsible person, contact, or team should define your work scope.

Steps

  1. Select Filter to reveal the filter block.

  2. Select the scope chips that match the work you want to review: Client, Vendor, Project, Sales Responsible, Contact, or Team.

  3. On a selected scope chip, select its remove control to remove that scope from the workspace.

  4. Beside the scope chips, select the remove-all control to clear every selected scope and return to an unscoped workspace.

  5. Select the Lists tab.

  6. Select Current to review current work.

  7. Select Archived to review archived work.

    Current work groups and their list contents

The selected scope filters the list data, and the selected list group is saved for the workspace. Loading placeholders appear while the list data is loading.

Result: The Lists view shows the selected Current or Archived group for your chosen scope, or its loading placeholders while that data is being retrieved.

With the list group selected, continue to Choose a work mode.

Prerequisites

The same filter context is passed to the list, graph, task, activity, and calendar work components. Principal-user status and feature subscriptions determine which tabs can be selected. The selected main tab is saved when a saved choice is available.

Do not treat a disabled tab as missing data. It indicates a user-context or subscription condition.

Choose a work mode

Each work mode answers a different daily question: Graphs gives a non-editable dashboard view, Tasks gives the task list, Activities gives the activity list, and Calendar gives appointment work in a calendar. A graph data point or calendar appointment can take you to related work.

Prerequisites

  • My Desk is available.
  • The required feature subscription is included for the work mode you need.
  • You are not a principal user when selecting Tasks, Activities, or Calendar.

Steps

  1. Select the mode that matches your work:

    If you need to…SelectWhat opens
    Review dashboard measuresGraphsA non-editable dashboard container
    Review or add tasksTasksThe task list
    Review or add activitiesActivitiesThe activity list
    Review appointments by dateCalendarThe calendar

    Selecting Tasks, Activities, or Calendar is unavailable for principal users.

  2. If you select Graphs, review the dashboard surface.

    Graphs with dashboard measures and linked work areas

    Select a graph data point when you need to continue into the related work.

  3. If you select Tasks, review the task list.

    Task work mode with its list columns
  4. If you select Activities, review the activity list.

    Activity work mode and its activity list
  5. If you select Calendar, review the calendar.

  6. In Calendar, use the control in the table that matches your next action:

    If you need to…Use
    Choose calendar dataFilter data
    Apply the calendar filterSubmit
    Return to today's dateToday
    Change to a timeline viewTimeline

    Timeline is unavailable in Month view.

  7. Select a calendar appointment to open its related work.

The calendar can show Day and Month views, with Sun, Mon, Tue, Wed, Thu, Fri, and Sat columns. In Month view, Timeline is unavailable.

Result: The selected work mode is displayed. The standard-user workspace shows Graphs, Tasks, Activities, and Calendar when those features are available; principal users see the three personal tabs disabled.

When you need to create a task or activity, continue to Add a task or activity from My Desk.

Prerequisites

The Tasks and Activities tabs are subscription-gated. Principal users cannot use those tabs. When either tab is active for an eligible user, the add icon in its tab header opens the corresponding creation entry point. In the Activities tab, find the add icon in the tab header; it opens the activity type menu. The detailed forms belong to Create a task and Create an activity, not to the My Desk workspace.

Add a task or activity from My Desk

My Desk provides the shared entry point; the owning form supplies the fields and save rules.

Prerequisites

  • The Tasks or Activities tab is available and active.
  • You know whether you are creating a task, a Visit, a Meeting, or a Call.

Steps

Use this table to choose the activity entry point before following the numbered steps:

If you need to createWhen this appliesAction
A standalone taskIf Tasks is activeIn the Tasks tab header, select the add icon to open the Task popup.
Open the activity menuIf Activities is activeIn the Activities tab header, select the add icon.
Choose an activity typeIf the activity menu is openSelect Visit, Meeting, or Call.
  1. If Tasks is active, select the add icon in the Tasks tab header to open the Task popup.

  2. If Activities is active, select the add icon in the Activities tab header to open the activity type menu.

  3. If Activities is active, select Visit, Meeting, or Call from the activity type menu.

    Activity type menu with Visit, Meeting, and Call
  4. Complete the form on its owning page.

  5. Select Save in the form.

  6. If you do not want to save, select the control at the right side of the popup header to close the popup without saving.

Save validates the form and refreshes the relevant My Desk list after a successful save. Use Create a task for task fields and Create an activity for activity fields.

Result: The selected task or activity form is open, or the relevant list is refreshed after a successful save.

After the form opens, continue with Add a task or Add an activity.

Add a task

The task popup embeds the new-task form. Use it when you need a standalone task visible in the My Desk task list.

Prerequisites

  • The Task popup is open from the active Tasks tab.
  • You have the task priority, purpose, start date, and due date.

Steps

  1. In the task form, complete the required Priority field.
  2. Complete the required Task Purpose field.
  3. Complete the required Start Date field.
  4. Complete the required Due Date field.
  5. Keep Due Date on or after Start Date.
  6. Review the dates: a new task starts with today's date and tomorrow's date as the date defaults.
  7. Select Save.

The task form validates the required fields and date order. A successful save refreshes the task list.

Result: The saved task is available in the My Desk task list.

Continue with Act on a task row when you need to open, complete, un-complete, or delete a task.

Prerequisites

Open the menu at the right end of a task row to see its available actions. Only the task owner can change task completion. Completing or deleting a task requires confirmation.

Use the action that matches the required result:

If you need toUse the row menu action
Open the task pageOpen
Change the completion stateComplete or Consider As Not Completed
Remove the taskDelete

Act on a task row

Use the menu at the right end of a task row to open the task, change its completion state, or delete it.

Prerequisites

  • A task row is visible in the task list.
  • You own the task when you need to change its completion state.

Steps

  1. Open the menu at the right end of the task row.
  2. If you need the task page, select Open to hand the task to its owning task page.
  3. If you need to mark the task complete, select Complete.
  4. If the completion confirmation appears, select Yes to confirm or No to cancel.
  5. If you need to remove the completion state, select Consider As Not Completed.
  6. If the un-completion confirmation appears, select Yes to confirm or No to cancel.
  7. If you need to remove the task, select Delete.
  8. If the deletion confirmation appears, select Yes to delete the task, or No to cancel.

Completion refreshes the grid. If deletion is refused because the task is related to saved data, the message is This record is related to saved data and cannot be deleted.

Result: The task opens, changes completion and refreshes the grid, is deleted with its success result, or remains unchanged after No or a refusal.

My Desk task messages

The task row owns these messages:

When you selectMessage
CompleteAre you sure that you want to mark this task as completed?
Consider As Not CompletedAre you sure that you want to un-complete this task?
DeleteAre you sure you want to delete this task?
After a successful deletionTask deleted successfully

Result: The task opens, changes completion and refreshes the grid, is deleted with its success result, or remains unchanged after No or a refusal.

Continue with Add an activity when the next item is an activity rather than a task.

Add an activity

An activity records a Visit, Meeting, or Call and then hands its details to the activity page that owns the form.

Prerequisites

  • The Activities tab is available and active.
  • You know whether the activity is a Visit, Meeting, or Call.

Steps

  1. If Activities is active, select the add icon in the Activities tab header to open the activity type menu.
  2. Select Visit, Meeting, or Call from the activity type menu.
  3. Complete the type-specific activity fields.
  4. For a Visit, complete the required date or title fields shown by the Visit form.
  5. For a Meeting, complete Meeting Purpose, Priority, Location, Tags, Participant, Start Date, End Date, Prepared By, and Signature as applicable; Start Date and End Date carry required markers.
  6. For a Call, complete the fields shown by the Call form.
  7. Select Save or Save and Close in the activity form.

The activity save finalizes the activity and displays its success or error result. An activity request can show Your request was completed successfully, Forbidden characters detected. Please remove them and try again., or Action not allowed. A creation form can also show This action is only allowed if you belong to that branch, One topic and at least one note is required, or There is no topic to print.

Result: The selected activity form is saved and its result is displayed, or the form remains open with its message.

Continue with Open and hand off a linked record when you need to inspect related work from a list or graph.

Prerequisites

A linked record must come from a My Desk list or a supported graph widget. My Desk opens the record in a dynamically titled tab and keeps it in view mode. A standard user can open the record's normal page when the record supplies a normal link.

Open and hand off a linked record

Use the opened-record view to inspect supported sales jobs, invoices, principal invoices, L/Gs, clients or principals, projects, contacts, users, and teams. Continue to the owning page when you need the record's normal form.

Prerequisites

  • A supported linked record is visible in a list or graph.
  • The record supplies a normal link when you need to edit it.

Steps

  1. Select the linked record in the list or graph.
  2. Select the dynamically titled opened-record tab to inspect the record in My Desk view mode.
  3. For a standard user, select the control at the right end of the opened-record tab in the tab bar to open the record's normal page.
  4. For a principal user, read the opened record in view mode; no editing control is available.
  5. At the right end of the opened-record tab in the tab bar, select the control that closes the tab and returns you to Lists.

The standard-user notice says To make changes, click the pen icon on the tab bar. The principal-user notice says View Mode Only.

Result: The record is either open in My Desk view mode, open on its owning page, or closed with Lists restored and the opened-record tab reset.

Continue with Handle principal-user and subscription variations when the workspace title, tab state, or subscription message differs from the standard view.

Prerequisites

Your user type and subscriptions determine which My Desk surfaces are present or actionable. Standard users see the personal workspace branches. Principal users see the Principal Desk branch, disabled personal tabs, and a different opened-record view-mode path. My Desk and Calendar are subscription-gated.

Handle principal-user and subscription variations

Use the workspace title, tab state, and subscription message to identify the branch you are in before selecting a work mode.

What you seeWhat it meansWhat you can use
My DeskStandard-user workspacePersonal lists, filters, and eligible work tabs
Principal Desk and a searchable client fieldPrincipal-user workspaceClient-scoped principal work
Disabled Tasks, Activities, or CalendarPrincipal-user restrictionGraphs remains available
Upgrade neededMy Desk or a selected feature is not in the planUpgrade now or Back

Steps

  1. Read the workspace title to distinguish My Desk from Principal Desk.
  2. If you are on Principal Desk, select a client in the searchable client field to set the principal workspace scope.
  3. Select Graphs when the personal work tabs are disabled.
  4. If Calendar is unavailable because its subscription is absent, select Upgrade now or Back on the subscription surface.

The standard workspace shows Graphs when it is available. On Principal Desk, Tasks, Activities, and Calendar are disabled. The My Desk subscription-unavailable surface replaces normal workspace content when the module is not included.

Result: The workspace shows the work modes permitted by your user context and subscriptions.

Continue with When workspace behaviour does not match if a tab, filter, loading state, or calendar view does not match the expected workspace.

Prerequisites

The same visible differences can result from four states: a disabled tab, a subscription surface, list-loading placeholders, or a work mode that does not support the requested view.

When workspace behaviour does not match

Use the symptom and next action below to distinguish a workspace condition from a missing record.

What you seeWhat it meansWhat to do
Tasks, Activities, or Calendar is visible but disabledPrincipal-user restrictionUse Graphs or the principal workspace route
Upgrade needed and its subscription messageThe required subscription is unavailableSelect Upgrade now or Back
Loading skeleton groupsList data is still loading—
The standard Filter area is absent on Principal DeskPrincipal Desk uses the client field insteadSelect a client in that field
Timeline is unavailable in Month viewThe calendar does not offer Timeline in Month viewSelect Day or a non-Month view
Goods receipt dates do not appear in the visible Calendar filterThe visible filter does not expose Goods receipt datesUse the calendar data choices that are visible

The permitted column-request error path has no reader-visible error or fallback message.

Messages from linked panels

Opened record panels are owned by their respective record pages. My Desk keeps them in view mode and directs changes to the owning page. Task and activity form messages belong to Create a task and Create an activity.

When an opened record shows the standard-user notice, read To make changes, click the pen icon on the tab bar. At the right end of the opened-record tab in the tab bar, select the control that opens the record's normal page. When it shows View Mode Only, use the principal-user view without editing it in My Desk.

The subscription surface uses these exact messages and actions:

  • Upgrade needed
  • The feature you are trying to use is not included in your current plan. Please upgrade your plan.
  • Upgrade now
  • Back

Messages owned by other pages

The following messages can appear after My Desk hands work to an owning page. Use the named page for the fields, validation, save, and error response associated with that message.

Owning pageWhen to use itMessage
Create a task or Create an activityA required embedded field is emptyThis field is required
Create a task or Create an activityA numeric value is outside the allowed rangeInvalid input. The value must be greater than 0 and cannot exceed 999,999.00
Create a task or Create an activityA numeric value is negativeInvalid input. Please enter a non-negative value
My Desk tasksA related task cannot be deletedThis record is related to saved data and cannot be deleted
My Desk activitiesAn activity request succeedsYour request was completed successfully
My Desk activitiesAn activity contains forbidden charactersForbidden characters detected. Please remove them and try again.
My Desk activitiesAn activity action is refusedAction not allowed
Purchasing inquiryA receiving date is requiredRequired Receiving Date
ProductsA receiving-after value is requiredRequired Receiving After
Purchasing inquiryAn offer type is requiredRequired Offer Type
Purchasing inquiryA bid due date is requiredRequired Bid Due Date
AccountsAn account name already existsAn account with this name already exists
AccountsA request cannot be processedAn error occurred while processing your request
AccountsA vendor has not been savedError: Vendor not saved yet
AccountsA client has not been savedError: Client not saved yet
AccountsA required account field is emptyThis Field Is Required
ContactsA contact with the same name already exists You already have a contact with this name
LibrariesA library name contains an unsupported characterJust '_'‘-''.' And '&' Characters Accepted
TeamsStorage has reached its limitYou’ve reached the maximum storage limit
Principal invoicesInvoice validation failsCheck validation
Create an activityThe activity branch rule is not metThis action is only allowed if you belong to that branch
Create an activityA topic or note is missingOne topic and at least one note is required
Create an activityThere is no topic to printThere is no topic to print
Sales job recordCustom fields save successfullyCustom fields saved successfully
Sales job recordA job is updatedJob updated successfully
Sales job recordA job is deletedJob deleted successfully
Sales job recordA job is regrettedJob regretted successfully
Sales job recordA job is cancelledJob cancelled successfully
Sales job recordA job is missedJob missed successfully
Sales job recordA job is reactivatedJob reactivated successfully
Sales job recordA job becomes an offerConverted to offer successfully
Sales job recordA job becomes an inquiryConverted to inquiry successfully
Sales job recordA job becomes regrettedConverted To Regretted
Sales job recordA job becomes cancelledConverted to cancelled
Sales job recordA job becomes lostConverted to lost
Sales job recordCustom-field saving failsError saving custom fields
Sales job recordA due invoice prevents undeliveryCannot be un-delivered — a due invoice already exists
Sales job recordAn offer is not in draft statusAll offers must be in draft status to revert to inquiry
Sales job recordThe server returns a variable errorError {{errorMsg}}
Sales job recordA project name already existsA project with this name already exists
Sales job recordA mandatory field is missingCheck mandatory field(s)
Sales job recordAn opened inquiry is not savedPlease save opened inquiry first
Sales job recordAn inquiry is not in draft stageAll inquiries must be in draft stage to revert to potential
Sales job recordAn item has zero quantityOne or more items has ZERO quantity
Sales job recordAn item has no unitOne or more items has no unit
OffersAn action is missing for a milestonePlease enter action for each milstone
OffersAn opened cost sheet is not savedPlease save opened cost sheet first
OffersA discount exceeds the negotiation marginThere is a maximum discount that exceeds the negotiation margin.
OffersThe gross-profit margin is unacceptableThe gross profit margin is unacceptable, and the release prices have been stopped.
OrdersA sales order is archivedSales order is archived
OrdersBooked quantity exceeds the required BOM quantityBooked quantity for this job is greater than the required BOM quantity
OrdersA product is locked after package creationYou cannot edit or delete the product after the purchase package is created
OrdersA product in purchasing cannot be deletedCannot be deleted. Product is in purchasing
OrdersA product is locked after purchase-order creationYou cannot edit the product after the PO is created
ProductsA product is already in a BOMThis product is already included in BOM
ProductsThe first variant cannot be deletedThe first variant cannot be deleted
ProductsThe CRM connection failsAn error occurred while connecting to your CRM system.
ProductsNo product is selectedPlease select one product
MRQA package has no item Package must have at least one item
MRQA product is missing from the packageYou cannot save without adding at least one product
MRQA product has no quantityOne of products has no quantity
PurchasingAll remaining items are selectedNo remaining items. All items have been selected
PurchasingNo email is enteredPlease enter at least one email
PurchasingAn inquiry has no itemInquiry must have at least one item
PurchasingAn offer has no itemOffer must have at least one item
PurchasingAn order has no itemOrder must have at least one item
PurchasingA ready or delivered item is selected for deletionItems labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted
PurchasingNo item is selected for an RFQPlease select one or more items to create a RFQ.
Job profitabilityPermission is missingYou don’t have permission
OrdersAccounts cannot be loadedError loading accounts
Reference listsA serial already exists for the manufacturerSerial you have entered already exist and belong to same manufacturer
Reference listsA serial is invalidThere is error in serial you have entered
Reference listsNo serial is enteredMinimum: At least one serial
L/G lifecycleAn extension is neededPlease Add Extension to activate the LG
L/G lifecycleAn L/G has extensions or deductionsLG has one or more extensions or deductions and cannot be reverted to the requested stage
L/G lifecycleAn L/G still needs confirmationLG still needs confirmation
L/G lifecycleThe selected date is not after expiryPlease choose a date after the current expiry date
L/G lifecycleA pending increase exists There is a pending increase you can edit

Was this page helpful?

Need help using the product?

My Desk workspace — PAMS Fresh Generation