Oracle Beehive
  Oracle® Beehive RESTful Web Services API Reference
  Release 2 (


The Task Management category enables you to control the task management aspects of Oracle Beehive's Time Management Services. For more information about Time Management Services, refer to the section "Time Management Services" in the module "Oracle Beehive Services" in Oracle Beehive Concepts in Oracle Beehive Documentation Library.

A TODO represents an action item. It contains fields with which you may specify its start date, end date, due date, priority, and percentage completed.

An Assignment represents a participant assigned to a particular TODO. An assignment is created for every participant of a TODO.

A task is an action item with assigned participants. In a Time Management Services client, a task represents a TODO to which a particular user has been assigned. The Task resource represents both TODOs and assignments. If the member AssignmentOnly is true, then the Task is an invitation.

The TaskList resource is a container for assignments and TODOs.

Working with Task

The task artifact represents a personal task or a task being assigned to a participant.

Oracle Beehive RESTful Web Services does not allow you to assign a task to another participant (task participants are not listed); however, Oracle Beehive RESTful Web Services exposes task assignments created from calendar clients. If the attribute assignmentOnly is true, then only the attribute with the prefix Assignee may be updated. If assgnmentOnly is false, then this artifact represents the main artifact of the TODO and modifications to the common attributes are propagated to each of the assignees copy of the task.

You may only create personal tasks or unassigned team workspace tasks. You may only list and read task assigned to yourself (tasks that represent assignments) or team workspace tasks.

A TaskList may only contain a Task; you may not add a Task to a team workspace, for example. However, a team workspace may be an assignee of a Task. Unlike invitations, TaskLists do not have an enrolment list associated with them. This means that members of the team workspace do not become assignees of the Task.