The Quantum::Estimator plugin offers a set of JQL functions that allow to query estimations. All Quantum::Estimator JQL functions return a list of Jira issues that fulfill the search criteria.
Supported Functions
| Table of Contents |
|---|
Standard form
The standard form is
| Code Block |
|---|
issue in estimationXY() |
since the Quantum::Estimator functions will allways return a list of issue filtered based on your query.
Provided functions
estimationCreator()
The estimationCreator() function will return all issues with a specific creator.
Searching for all issues where the current user created the estimation:
| Code Block |
|---|
issue in estimationCreator() |
Searching for all issues where the users with usernames admin or smith created the estimation:
| Code Block |
|---|
issue in estimationCreator(admin, smith) |
estimationDue()
The estimationDue() function will return issue matching specific criterias regarding its due date.
The estimaationDue() function expects, zero, one or two arguments.
Search for tickets due today:
`issue in estimationDue()` returns all issues which are in estimation state `ESTIMATING` and are due or overdue.
The `estimationDue()` functions accepts a duration string, following the standard Jira duration format as as used in the time tracking field. Here are some examples:
Search for tickets due at a specific date:
`issue in estimationDue('2020-08-01')` returns all issues which are in estimation state `ESTIMATING` and will be due at `2020-08-01`.
Search for tickets due within a date range:
`issue in estimationDue('2020-08-01', '2020-08-07')` returns all issues which are in estimation state `ESTIMATING` and will be due in the date range between `2020-08-01`, `2020-08-07`.
Search for tickets with a relative duration:
`issue in estimationDue('1w')` returns all issues which are in estimation state `ESTIMATING` and will be due in one week from now.
`issue in estimationDue('1w', '1w')` returns all issues which are in estimation state `ESTIMATING` and are due in the range of the past seven and future seven days.
Date format pattern:
The function accepts dates in the format: `YYYY-MM-DD`.
Relative format pattern:
The function accepts relative times in the format: `1d`, `2d`, `5w`, etc.
estimationState()
The estimationState() function returns all issues that are matching an estimation state.
estimatedByUser()
The estimatedByUser() function will return all issues with estimation tasks that where estimated by a user.
estimatesMissing()
The estimatesMissing() function will return all issues which are in estimation state `ESTIMATING` and that have missing estimates.
estimatesMissingForUser()
The estimatesMissingForUser() function will return all issues whith estimation tasks that where the user is allowed to estimate and has not yet estimated.