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
IBM 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
IBM My webMethods Server
runtime. For more information and examples about adding custom task search
engines, see the
IBM
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:
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.