Task Engine 10.11 | Task Engine Webhelp | webMethods Task Engine API and Service Reference | Using the Task Engine Web Service API | TaskSearchQuery
 
TaskSearchQuery
Used as input to the searchTasks operation. The elements defined here are also present in TaskSearchQueryV2.
Element
Description
doNotShowAcceptedByOthers
Boolean Optional. Exclude tasks that are accepted by a user other than the user ID used in the search. Default is false.
maxResults
Integer Optional. The maximum number of tasks to return in the result set. If MaxResults is not specified, all results in the result set are returned.
Note:
This element does not apply to tasks with an indexed search provider. In this case, the specified value is ignored.
showNonActiveTasks
Boolean Optional. This field can be used when executing queries to fetch tasks from a user's inbox. This parameter is meant to override the default behavior of the searchUserTasks parameter and allow the return of non-active tasks.
Set to:
*true to return non-active tasks.
*false (default) to return active tasks only.
For example, by specifying searchUserTasks =true and showNonActiveTasks =true, the query returns all non-active tasks from a user's inbox (that is, those tasks already completed by user).
The showNonActiveTasks parameter has no impact on non-user task searches. To construct a non-user task search to return only active tasks, you must set query terms of searchUserTasks =false and status =active.
searchEngineType
String Optional. Specifies the search engine to use when searching for tasks. The default values are:
*db - when using services that search task data, stored in the indexed table of the My webMethods Server database.
*hpstra - when using services that search in HPSTRA-enabled task data.
You can also specify the name of any custom engine that you develop for task searches and register as an OSGi service in the My webMethods Server runtime. For more information and examples about adding custom task search engines, see the Software AG TECHcommunity website.
activeVoting
Boolean Optional. Optional. When set to true, returns all task instances from a votable task type for which at least one user has voted. The default value is false.
terms
TaskSearchQueryTerm[] Specifies the TaskSearchQueryTerm object that contains an array of TaskSearchQueryTerm objects that specify the query criteria for the search. See TaskSearchQueryTerm for a description of the fields in this object.
When a search is performed, the criteria specified by the TaskSearchQueryTerm objects in terms are combined using the logical "AND" operator. Only tasks that satisfy the terms specified by all TaskSearchQueryTerm objects in the terms array are returned in the result set.
Usage Notes
The showNonActiveTasks parameter overrides the default behavior of the userTasks parameter in any web service where that parameter occurs, such as:
* countTasksIndexed
* searchTasks
* searchTasksIndexed
The showNonActiveTasks parameter does not apply to task from votable types. Only active instances from votable task types are returned, regardless of the parameter value.