Important

You are browsing the documentation for version 4.2 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Create a Task

In the Oro application, you can create tasks in a number of ways. In the following sections, you will learn how to:

Add a New Task Manually

To add a task manually:

1. Navigate to Activities > Tasks in the main menu.

2. Click Create Task on the top right.

3. On the Create Task page, fill in the required information:

   • Subject — The name which summarizes what the task is about.

   • Description — Detailed statement of what work is to be done in relation to the task. Use the embedded editor to format text, add images, links, etc.

     Important

     • Whether the embedded editor is available is specified in the configuration. If you have access to the system configuration, see the WYSIWYG settings section of the Display Settings description.

     • If you do not have access to the page, contact your administrator who can enable the editor at the organization level.

     • If you are an administrator, see the WYSIWYG settings section of the System Display Settings description.

   • Due Date — The day and time when the task must be completed. Click on the day field to select a day in the calendar dialog, and on the time field to select a time from the list. Alternatively, type in the date and time values.

   • Status — The phase of work on the task (open, in progress or closed).

     Important

     If the Task Flow is enabled, you cannot set the task status.

   • Priority — Set the order in which the task should be managed. Can be High, Normal, or Low. Higher-priority tasks should be managed first.

   • Assigned To — The user who is responsible for doing the work related to the task. The task appears in the calendar of the assignee.

     Note

     By default, a person who creates a task is selected as its assignee. Change the assignee if required. Select another user from the list. You may use the search field to quickly find the required user: start typing the name of the user and when suggestions appear, click the required name. Alternatively, you may click the hamburger menu next to the field and select the owner in the Select Assigned To dialog.

   • Reminders — A notification about the upcoming task’s due date. Click +Add to configure when and how Oro application reminds the participants about the task:

     • Specify the type of the notification: whether to show a flash message in Oro application or send the notification email.

     • Select the time units in which the time lag between a reminder and the task’s due date is measured: minutes, hours, days, or weeks.

     • Enter what number of selected time intervals the time lag between a reminder and the task’s due date comprises.

     To remove a reminder, click the x icon next to it.

     Note

     In Oro applications, the due date and time of the task are displayed according to the recipient’s timezone settings both in the notification emails and flash messages. For instance, if the due time of a task is displayed as 7 a.m. to a user in New York, the due time displayed in the reminder to a user in Tokio is 8 p.m.

   • Context — Select a record that has a meaningful relation to the task. Start entering a record name, and when the list of suggestions appears, click the required name to select it. The task becomes immediately linked to the selected item and is displayed in its Activity section.

4. Click Save and Close when you are finished.

Add a Task From the User Profile

From a user profile, you can create a task and automatically assign it the user.

To create a task from a user profile:

1. Open the profile of the user to whom you want to assign a task.

2. Click More Actions on the top right of the page and then click Assign Task.

   

3. In the Assign Task To dialog, specify the required data. Fill in the required information as described in the Add a New Task Manually section.

4. Click Create Task. The task appears in the Tasks subsection Additional Information on the user profile page.

Note

An administrator may define that users can be specified as a context for a task. In this case, the More Actions list on the user’s profile page will have two similar options: Assign Task and Add Task. The difference between them is the following:

• When you select Assign Task, the task that you create will be assigned to the user from which profile you perform this action.

• When you select Add Task, the task that you create can be assigned to any user. However, the user from which profile you perform the action will appear as a context of the task.

Add a Task from the Page of a Related Record

To create a task when viewing the related record (e.g., opportunity, account, etc.):

1. On the page of a related record, click More Actions > Add Task on the top right of the page.

   

2. In the Add Task dialog, specify the required data, as described in the Add a New Task Manually section.

3. Click Create Task.

Note

If you create a task from the page of a related entity record, this entity record appears as a context of the task.