Advanced searching - functions reference
closedSprints()
Search for issues that are assigned to a completed Sprint. Note, it is possible for an issue to belong to both a completed Sprint(s) and an incomplete Sprint(s). See also openSprints().
Syntax | closedSprints() |
---|---|
Supported fields | Sprint |
Supported operators | IN , NOT IN |
Unsupported operators | = , != , ~ , !~ , > , >= , < , <= |
Examples |
|
componentsLeadByUser()
Find issues in components that are led by a specific user. You can optionally specify a user, or if the user is omitted, the current user (i.e. you) will be used. Note that if you are not logged in to JIRA, a user must be specified.
Syntax | componentsLeadByUser() componentsLeadByUser(username) |
---|---|
Supported fields | Component |
Supported operators | IN , NOT IN |
Unsupported operators | = , != , ~ , !~ , > , >= , < , <=
|
Examples |
|
currentLogin()
Perform searches based on the time at which the current user's session began. See also lastLogin.
Syntax | currentLogin() |
---|---|
Supported fields | Created, Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators | = , != ,
|
Unsupported operators | ~ , !~
|
Examples |
|
currentUser()
Perform searches based on the currently logged-in user. Note, this function can only be used by logged-in users. So if you are creating a saved filter that you expect to be used by anonymous users, do not use this function.
Syntax | currentUser() |
---|---|
Supported fields | Assignee, Reporter, Voter, Watcher, custom fields of type User |
Supported operators | = , != |
Unsupported operators | ~ , !~ , |
Examples |
|
earliestUnreleasedVersion()
Perform searches based on the earliest unreleased version (i.e. next version that is due to be released) of a specified project. See also unreleasedVersions. Note, the "earliest" is determined by the ordering assigned to the versions, not by actual Version Due Dates.
Syntax | earliestUnreleasedVersion(project) |
---|---|
Supported fields | AffectedVersion, FixVersion, custom fields of type Version |
Supported operators | IN , NOT IN |
Unsupported operators |
|
Examples |
|
endOfDay()
Perform searches based on the end of the current day. See also endOfWeek, endOfMonth, and endOfYear; and startOfDay, startOfWeek, startOfMonth, and startOfYear.
Syntax | endOfDay() endOfDay("inc") where |
---|---|
Supported fields | Created, Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators |
|
Unsupported operators | ~ , !~
|
Examples |
|
endOfMonth()
Perform searches based on the end of the current month. See also endOfDay, endOfWeek, and endOfYear; and startOfDay, startOfWeek, startOfMonth, and startOfYear.
Syntax | endOfMonth() endOfMonth("inc") where |
---|---|
Supported fields | Created, Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators |
|
Unsupported operators | ~ , !~
|
Examples |
|
endOfWeek()
Perform searches based on the end of the current week. See also endOfDay, endOfMonth, and endOfYear; and startOfDay, startOfWeek, startOfMonth, and startOfYear.
For the endOfWeek() function, the result depends upon your locale. For example, in Europe, the first day of the week is generally considered to be Monday, while in the USA, it is considered to be Sunday.
Syntax | endOfWeek() endOfWeek("inc") where |
---|---|
Supported fields | Created, Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators |
|
Unsupported operators | ~ , !~
|
Examples |
|
endOfYear()
Perform searches based on the end of the current year. See also startOfDay, startOfWeek, and startOfMonth; and endOfDay, endOfWeek, endOfMonth, and endOfYear.
Syntax | endOfYear() endOfYear("inc") where |
---|---|
Supported fields | Created, Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators |
|
Unsupported operators | ~ , !~
|
Examples |
|
issueHistory()
Find issues that you have recently viewed, i.e. issues that are in the 'Recent Issues' section of the 'Issues' drop-down menu.
Note:
issueHistory()
returns up to 50 issues, whereas the 'Recent Issues' drop-down returns only 5.- if you are not logged in to JIRA, only issues from your current browser session will be included.
Syntax | issueHistory() |
---|---|
Supported fields | Issue |
Supported operators |
|
Unsupported operators |
|
Examples |
|
issuesWithRemoteLinksByGlobalId()
Perform searches based on issues that are associated with remote links that have any of the specified global ids.
Note:
- This function accepts 1 to 100 globalIds. Specifying 0 or more than 100 globalIds will result in errors.
Syntax | issuesWithRemoteLinksByGlobalId() |
---|---|
Supported fields | Issue |
Supported operators |
|
Unsupported operators |
|
Examples |
|
lastLogin()
Perform searches based on the time at which the current user's previous session began. See also currentLogin.
Syntax | lastLogin() |
---|---|
Supported fields | Created. Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators |
|
Unsupported operators |
|
Examples |
|
latestReleasedVersion()
Perform searches based on the latest released version (i.e. the most recent version that has been released) of a specified project. See also releasedVersions(). Note, the "latest" is determined by the ordering assigned to the versions, not by actual Version Due Dates.
Syntax | latestReleasedVersion(project) |
---|---|
Supported fields | AffectedVersion, FixVersion, custom fields of type Version |
Supported operators |
|
Unsupported operators |
|
Examples |
|
linkedIssues()
Perform searches based on issues that are linked to a specified issue. You can optionally restrict the search to links of a particular type. Note that LinkType is case-sensitive.
Syntax | linkedIssues(issueKey) linkedIssues(issueKey,linkType) |
---|---|
Supported fields | Issue |
Supported operators |
|
Unsupported operators |
|
Examples |
|
membersOf()
Perform searches based on the members of a particular group.
Syntax | membersOf(Group) |
---|---|
Supported fields | Assignee, Reporter, Voter, Watcher, custom fields of type User |
Supported operators |
|
Unsupported operators |
|
Examples |
|
now()
Perform searches based on the current time.
Syntax | now() |
---|---|
Supported fields | Created. Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators |
|
Unsupported operators |
|
Examples |
|
openSprints()
Search for issues that are assigned to a Sprint that has not yet been completed. Note, it is possible for an issue to belong to both a completed Sprint(s) and an incomplete Sprint(s). See also closedSprints().
Syntax | openSprints() |
---|---|
Supported fields | Sprint |
Supported operators | IN , NOT IN |
Unsupported operators | = , != , ~ , !~ , > , >= , < , <= |
Examples |
|
projectsLeadByUser()
Find issues in projects that are led by a specific user. You can optionally specify a user, or if the user is omitted, the current user will be used. Note that if you are not logged in to JIRA, a user must be specified.
Syntax | projectsLeadByUser() projectsLeadByUser(username) |
---|---|
Supported fields | Project |
Supported operators | IN , NOT IN |
Unsupported operators | = , != , ~ , !~ , > , >= , < , <= |
Examples |
|
projectsWhereUserHasPermission()
Find issues in projects where you have a specific permission. Note, this function operates at the project level. This means that if a permission (e.g. "Edit Issues") is granted to the reporter of issues in a project, then you may see some issues returned where you are not the reporter, and therefore don't have the permission specified. Also note, this function is only available if you are logged in to JIRA.
Syntax | projectsWhereUserHasPermission(permission) For the |
---|---|
Supported fields | Project |
Supported operators | IN , NOT IN |
Unsupported operators | = , != , ~ , !~ , > , >= , < , <= |
Examples |
|
projectsWhereUserHasRole()
Find issues in projects where you have a specific role. Note, this function is only available if you are logged in to JIRA.
Syntax | projectsWhereUserHasRole(rolename) |
---|---|
Supported fields | Project |
Supported operators | IN , NOT IN |
Unsupported operators | = , != , ~ , !~ , > , >= , < , <= |
Examples |
|
releasedVersions()
Perform searches based on the released versions (i.e. versions that your JIRA administrator has released) of a specified project. You can also search on the released versions of all projects, by omitting the project parameter. See also latestReleasedVersion().
Syntax | releasedVersions() releasedVersions(project) |
---|---|
Supported fields | AffectedVersion, FixVersion, custom fields of type Version |
Supported operators | IN , NOT IN |
Unsupported operators |
|
Examples |
|
standardIssueTypes()
Perform searches based on "standard" Issue Types, that is, search for issues that are not sub-tasks. See also subtaskIssueTypes().
Syntax | standardIssueTypes() |
---|---|
Supported fields | Type |
Supported operators | IN , NOT IN |
Unsupported operators |
|
Examples |
|
startOfDay()
Perform searches based on the start of the current day. See also startOfWeek, startOfMonth, and startOfYear; and endOfDay, endOfWeek, endOfMonth, and endOfYear.
Syntax | startOfDay() startOfDay("inc") where |
---|---|
Supported fields | Created, Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators |
|
Unsupported operators | ~ , !~
|
Examples |
|
startOfMonth()
Perform searches based on the start of the current month. See also startOfDay, startOfWeek, and startOfYear; and endOfDay, endOfWeek, endOfMonth, and endOfYear.
Syntax | startOfMonth() startOfMonth("inc") where |
---|---|
Supported fields | Created, Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators |
|
Unsupported operators | ~ , !~
|
Examples |
|
startOfWeek()
Perform searches based on the start of the current week. See also startOfDay, startOfMonth, and startOfYear; and endOfDay, endOfWeek, endOfMonth, and endOfYear. For the startOfWeek() function, the result depends upon your locale. For example, in Europe, the first day of the week is generally considered to be Monday, while in the USA, it is considered to be Sunday.
Syntax | startOfWeek() startOfWeek("inc") where |
---|---|
Supported fields | Created, Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators |
|
Unsupported operators | ~ , !~
|
Examples |
|
startOfYear()
Perform searches based on the start of the current year. See also startOfDay, startOfWeek and startOfMonth; and endOfDay, endOfWeek, endOfMonth and endOfYear.
Syntax | startOfYear() startOfYear("inc") where |
---|---|
Supported fields | Created, Due, Resolved, Updated, custom fields of type Date/Time |
Supported operators |
|
Unsupported operators | ~ , !~
|
Examples |
|
subtaskIssueTypes()
Perform searches based on issues that are sub-tasks. See also standardIssueTypes().
Syntax | subtaskIssueTypes() |
---|---|
Supported fields | Type |
Supported operators | IN , NOT IN |
Unsupported operators |
|
Examples |
|
unreleasedVersions()
Perform searches based on the unreleased versions (i.e. versions that your JIRA administrator has not yet released) of a specified project. You can also search on the unreleased versions of all projects, by omitting the project parameter. See also earliestUnreleasedVersion().
Syntax | unreleasedVersions() unreleasedVersions(project) |
---|---|
Supported fields | AffectedVersion, FixVersion, custom fields of type Version |
Supported operators |
|
Unsupported operators |
|
Examples |
|
votedIssues()
Perform searches based on issues for which you have voted. Also, see the Voter field. Note, this function can only be used by logged-in users.
Syntax | votedIssues() |
---|---|
Supported fields | Issue |
Supported operators |
|
Unsupported operators |
|
Examples |
|
watchedIssues()
Perform searches based on issues that you are watching. Also, see the Watcher field. Note that this function can only be used by logged-in users.
Syntax | watchedIssues() |
---|---|
Supported fields | Issue |
Supported operators |
|
Unsupported operators |
|
Examples |
|