Skip to content
D
Documentation

Create a task

task
9 min readUpdated

What a task is

A task is a record of follow-up work that you need to track. Record a task when you have work to do later and need a dated item with an owner, an assignee, a status, or related follow-up. Create and handle these records in the Tasks flow: use the new-task form to create one, then open the saved task for its tabs and status actions.

If you need to…Go to
Enter follow-up work for the first timeEnter task details
Commit a new taskSave the task
Open a task that already existsFind a task
Use tabs, status actions, or activity options on a saved taskHandle saved-task options
Continue in the wider task workspaceContinue after saving
Work with the task and activity lists togetherTasks and activities
Change an activity's statusActivity status
Create a Visit, Meeting, or CallCreate an activity
Work from the personal task workspaceMy Desk tasks
Work from the personal activity workspaceMy Desk activities
Work with tasks embedded in a sales jobSales-job comments and tasks

The task list and new-task form are separate surfaces. Open the task list to find existing work, open the new-task form to record work, or open a saved task to continue working with it.

The task form with its fields and save actions

Before you start

You need a signed-in account and a subscription that includes the task form. The form is available only when the task data is present and the subscription condition allows it. Leaving the new-task screen is protected while you are entering a task.

Collect the task purpose, description if one is needed, start date, due date, priority choice, and assignee choice before you begin. Priority choices come from the priorities available to your account. Assignee choices come from the users available for the relevant branch. The labels and initial values for Priority and Assign To depend on those returned choices.

The form provides Owner, Assignee, and Tags as display information. Reminder belongs to a saved task rather than a new unsaved task. On the task form, Start Date and Due Date carry required markers. The other visible fields do not carry required markers on this form, although the form's validation rules still define Priority and Task Purpose as required when you save.

Find a task

Choose the entry point that matches the work you need to do.

If you need to…Open
Record work that does not yet have a task recordThe new-task form
Reopen saved work or choose a task row for a later actionThe task list

Open a new task

Prerequisites

  • You are signed in.
  • The task form is available for your subscription.

Steps

  1. Open the new-task form.

  2. Confirm that Task Purpose, Priority, Description, Start Date, Due Date, Task Progress, and Assign To are visible.

    The new-task form with its visible fields

Result: The new-task form is open and ready for task details. The form shows the Save and Save and Close actions.

Locate an existing task

Prerequisites

  • You are signed in.
  • You know enough about the task to recognise its row.

Steps

  1. Open the task list.

  2. Select the view that matches the work you need to find.

    If you need to see…Select
    Every available taskAll
    Tasks assigned to youMy Tasks
    Completed tasksView completed tasks
  3. Match the row using the visible columns Title, Owner, Start date, Due date, Status, and Importance.

  4. Open the task row you need.

    The task list with its filters and visible columns

Result: The selected saved task is open.

For a new task, continue with Enter task details. For a saved task, continue with Handle saved-task options.

Enter task details

Enter the information that identifies the follow-up work and places it on the right dates. The available choices for Priority and Assign To come from your account and branch data, so use the choices that appear in your form.

Complete the task form

Prerequisites

  • The new-task form is open.
  • You have the task purpose and its start and due dates.

Steps

  1. In Task Purpose, enter the work you need to follow up.
  2. In Priority, select an available priority.
  3. In Description, enter supporting details when they are needed.
  4. In Start Date, enter the date on which the task starts.
  5. In Due Date, enter the date by which the task is due.
  6. In Task Progress, review the progress shown for the task.
  7. In Assign To, select the available assignee when the task must be given to another available user.
  8. Review the Owner, Assignee, and Tags information shown on the form.

Result: The task form contains the available task information and is ready for saving.

Save the task

Saving commits the task after the form validates it. The save controls are available for a new task when the current account is the owner; they are also available for an accepted, owned saved task.

Prerequisites

  • The task form is open.
  • The current account is allowed to save the task.

Steps

  1. Enter all values required by the form.

  2. Select Save when you want to save the task and remain on the task.

  3. Select Save and Close when you want to save the task and close the form.

    ChoiceUse it when you need to…
    SaveContinue working with the saved task
    Save and CloseLeave the task form after saving
  4. If validation displays a message, correct the named field and select the save control again.

Result: A successful save displays Data saved Successfully. A new task saved from the new-task form opens in the saved task view. If the save cannot complete, the form displays Error Saving Registration.

Handle saved-task options

A saved task is the version that has a task ID and can expose task tabs and status actions. The options depend on the task's status, ownership, parent-task relationship, branch, and whether the task is complete.

Use the saved-task controls

Prerequisites

  • A saved task is open.
  • You know whether the task is yours and whether it is complete, overdue, or due to start.

Steps

  1. Select the status action that matches the task's current condition.

    If the task…Select
    Is assigned to you and has not already been acceptedAccept
    Is assigned to you and you do not accept itDecline
    Is overdue or due to start and the work is completeConsider As Complete
    Is completed and needs to return to an incomplete stateConsider As Not Completed
  2. Select the saved-task tab that matches the work you need.

    If you need to work with…Select
    Child tasks on a saved root taskSub-tasks
    Related activitiesActivities
    CommentsComments
    Attached filesAttachment
    Change historyLast Modifications
  3. In Activities, select Meeting, Visit, or Call when the task is in the same branch and is not completed.

    The saved-task action area and task tabs

Result: The selected status, saved-task tab, or activity option is open when its ownership, status, parent-task, and branch conditions allow it. Accepting a task displays You accepted the assigned task. Declining it displays You declined the assigned task.

Fix task-entry problems

Use the message on screen to identify whether the form needs a value, the task owner must take the action, or the list action is blocked.

What you seeWhat it meansWhat to do
Priority is requiredThe form has no accepted priority value.Select a value in Priority, then save again.
Title is requiredThe task purpose is empty.Enter the task purpose in Task Purpose, then save again.
Start Date is requiredThe start date is empty.Enter Start Date, then save again.
Due Date is requiredThe due date is empty.Enter Due Date, then save again.
Only task owner can take that actionThe current account cannot perform that status action.Have the task owner perform the action.
An error occurred while processing your requestAccept or decline did not complete.Check the task assignment and select the action again when appropriate.
Error Saving RegistrationThe save error path was reached.Review the task values and select Save or Save and Close again.
This record is related to saved data and cannot be deletedThe related task cannot be deleted from the list.Keep the related record and use its owning workflow instead.
Error while deleting taskThe delete operation did not complete.Do not rely on deletion; reopen the row and review its available actions.
You declined the assigned taskThe assigned task was declined.Review the assignment before continuing.
Task deleted successfullyThe task was deleted.Return to the task list and locate the remaining work.
Forbidden characters detected. Please remove them and try again.An activity contains forbidden characters.Remove the characters and try the activity entry again.
Action not allowedThe requested activity action is unavailable.Continue from the activity page that owns the action.
This action is only allowed if you belong to that branchThe activity action requires branch membership.Use an account that belongs to the task's branch.
One topic and at least one note is requiredThe activity needs a topic and a note.Enter one topic and at least one note on the activity page.
There is no topic to printThe activity has no topic available for printing.Add a topic before printing the activity.
You already have a contact with this nameThe contact name already exists.Use the existing contact or enter a different name on the contact page.
Just '_'‘-''.' And '&' Characters AcceptedThe file or library name contains unsupported characters.Use only the accepted characters in the file or library page.
Your request was completed successfullyA file or library request completed.Continue from the file or library page.

The task list shows All, My Tasks, and View completed tasks. It does not show a following filter tab or a filter text field. The task form does not provide a usable Follow control, and its header does not provide Attachments, Sub-tasks, or Activity controls; use the saved-task tabs instead.

The task-list grid is drawn from the selected list layout.

Visible task-list column
Title
Owner
Start date
Due date
Status
Importance

Export is not shown on the task list, so use the controls that are actually shown on your list rather than relying on a hidden Export action.

The available priority and assignee choices, editable defaults, and some saved-task states depend on returned account, branch, and task data. Server-side authorization and server-side validation are handled outside the task form's visible rules.

Continue after saving

After saving, continue from the saved task according to the work you need to do: use its conditional tabs for task-related work, or move to the registered page that owns the wider activity, workspace, or embedded-record operation.

Prerequisites

  • You have saved a task or opened an existing task.

Steps

  1. In the saved-task tab row, select Sub-tasks, Activities, Comments, Attachment, or Last Modifications.

    If you need to…Select or open
    Work with child tasks on a root taskSub-tasks
    Work with related activitiesActivities
    Review comments, attachments, or change historyComments, Attachment, or Last Modifications
    Create a Visit, Meeting, or Call in the same branch before the task is completeMeeting, Visit, or Call
    Follow activity status transitionsActivity status
    Create a Visit, Meeting, or CallCreate an activity
    Work from the personal task workspaceMy Desk tasks
    Work from the personal activity workspaceMy Desk activities
    Work with tasks embedded in a sales jobSales-job comments and tasks

Result: You are on the saved-task tab or registered follow-up page that owns the next piece of work.

Was this page helpful?

Need help using the product?