2.5.2.10.3 Changing the Order of a Task

  • Article

This use case describes how a client application changes the position of a task relative to other tasks in a user-defined sort order. This sort order affects the order in which tasks are returned depending on the query for reading tasks.

The following diagram illustrates the retrieval process:

Process for reordering a task on the user’s task list

Figure 28: Process for reordering a task on the user’s task list

Preconditions

  • The Work Management Service has been set up.

  • The User Profile Service has been set up.

  • The client application has been authenticated, has read permission and has write permission for his or her personal site associated with the User Profile Service, where tasks are cached.

  • The client application can communicate with his or her SharePoint site.

Steps

  1. The client application requests to change the position of a task on the server.

  2. The server updates the position of the task in the task cache.

Error

  • If the user does not have write permissions to the task cache, this operation will fail.

Post-conditions

  • The position of a task will be updated.

  • The position will remain the same if the user did not have sufficient permissions to edit the task cache.