search
This module contains functionality that lets you search for issues in YouTrack.
static search(folder, query, user)Returns issues that match a search query. If a sort order is not specified explicitly in the query, the issues that are returned are sorted in random order.
Parameters
Name | Type | Description |
|---|---|---|
folder | WatchFolder | The project, tag, or saved search to set as the search context. If the value for this parameter is not provided, the search includes all issues. This is equivalent to a search that is performed in the user interface with the context set to Everything. |
query | string, Object | A YouTrack search query. If Object, supports searching by extension properties. |
user | User | The user account that executes the search query. The list of issues that is returned excludes issues that the specified user does not have permission to view. If the value for this parameter is not provided, the search query is executed on behalf of the current user. |
Return Value
Type | Description |
|---|---|
Set.<Issue> | The set of issues found by the search. |
Example
const search = require('@jetbrains/youtrack-scripting-api/search');
...
const query = {
query: 'for: me State: {In Progress} issue id: -' + issue.id,
extensionPropertiesQuery: {
property1: "value1",
property2: "value2"
}
}
const inProgress = search.search(issue.project, query, ctx.currentUser);
if (inProgress.isNotEmpty()) {
// Do something with the found set of issues.
}