queryTasks( )

Creates a query to retrieve a list of tasks.

The queryTasks() method builds a query to retrieve a list of tasks and returns a TasksQueryBuilder object.

The returned object contains the query definition which is typically used to run the query using the find() method. You can refine the query by chaining TasksQueryBuilder methods onto the query. TasksQueryBuilder methods enable you to sort, filter, and control the results that queryTasks() returns.

queryTasks() runs with these TasksQueryBuilder defaults, which you can override:

• limit(50)
• descending('_createdDate')

The methods that are chained to queryTasks() are applied in the order they are called. For example, if you apply ascending('_createdDate') and then descending('_updatedDate'), the results are sorted first by the created date and then, if there are multiple results with the same date, the items are sorted by the updated date.

The following TasksQueryBuilder methods are supported for queryTasks(). For a full description of the task object, see the object returned for the items property in TasksQueryResult.

PROPERTY	SUPPORTED FILTERS & SORTING
_id	eq(),ne(),in(),ascending(),descending()
_createdDate	eq(),ne(),gt(),lt(),ge(),le(),ascending(),descending()
_updatedDate	eq(),ne(),gt(),lt(),ge(),le(),ascending(),descending()
dueDate	eq(),ne(),gt(),lt(),ge(),le(),ascending(),descending()
status	eq(),ne(),in()
contact.id	eq(),ne(),in(),exists()