Documentation for JIRA 5.1.x. Documentation for other versions of JIRA is available too.
高度な検索を使用すると、構造化されたクエリを使用して、JIRA 課題を検索できます。検索結果は課題ナビゲーターに表示され、そこから MS Excel などの多様な形式でエクスポートできます。また、希望する場合は高度な検索へ保存したり、サブスクライブすることもできます。
高度な検索を実行するときには、JIRA クエリ言語 (JQL) を使用します。
A simple query in JQL (also known as a 'clause') consists of a Advanced Searching#field, followed by an Advanced Searching#operator, followed by one or more values or functions. For example, the following simple query will find all issues in the "TEST" project:
project = "TEST"
(This example uses the Advanced Searching#Project field, the Advanced Searching#EQUALS operator, and the value "TEST"
.)
Be aware that it is not possible to compare two Advanced Searching#fields.
JQL gives you some SQL-like syntax, such as the ORDER BY SQL keyword and ISNULL() SQL function (i.e. the Advanced Searching#NULL keyword in JQL). However, JQL is not a database query language. For example, JQL does not have a
SELECT
statement.
On this page:
JQL のキーワードは、次のいずれかを行う単語または語句です。
List of keywords:
複数の句を組み合わせて検索を絞り込むために使用します。
Note that you can use Advanced Searching#parentheses to control the order in which clauses are executed.
"New office" プロジェクト内のすべてのオープンな課題を検索:
project = "New office" and status = "open"
jsmith に割り当てられたオープンかつ緊急のすべての課題を検索:
status = open and priority = urgent and assignee = jsmith
jsmith に割り当てられていない、特定のプロジェクト内のすべての課題を検索:
project = JRA and assignee != jsmith
複数のプロジェクトにおいて、複数のバージョン番号で構成される特定のリリースに対するすべての課題を検索:
project in (JRA,CONF) and fixVersion = "3.14"
報告者と担当者が Jack、Jill、John のいずれでもないすべての課題を検索:
reporter not in (Jack,Jill,John) and assignee not in (Jack,Jill,John)
複数の句を組み合わせて検索範囲を広げるために使用します。
Note that you can use Advanced Searching#parentheses to control the order in which clauses are executed.
(Note: also see Advanced Searching#IN, which can be a more convenient way to search for multiple values of a field.)
jsmith または jbrown のいずれかが作成したすべての課題を検索:
reporter = jsmith or reporter = jbrown
期限切れまたは期限が設定されていないすべての課題を検索:
duedate < now() or duedate is empty
Used to negate individual clauses or a complex JQL query (a query made up of more than one clause) using Advanced Searching#parentheses, allowing you to refine your search.
(注: NOT EQUALS ("!=")、DOES NOT CONTAIN ("!~")、NOT IN および IS NOT も参照してください。)
jsmith 以外のすべてのユーザーに割り当てられたすべての課題を検索:
not assignee = jsmith
jsmith または jbrown が作成していないすべての課題を検索:
not (reporter = jsmith or reporter = jbrown)
Used to search for issues where a given field does not have a value. See also Advanced Searching#NULL.
Note that EMPTY can only be used with fields that support the Advanced Searching#IS and IS NOT operators. To see a field's supported operators, check the individual Advanced Searching#field reference.
Find all issues without a Advanced Searching#DueDate:
duedate = empty
または
duedate is empty
Used to search for issues where a given field does not have a value. See also Advanced Searching#EMPTY.
Note that NULL can only be used with fields that support the Advanced Searching#IS and IS NOT operators. To see a field's supported operators, check the individual Advanced Searching#field reference.
Find all issues without a Advanced Searching#DueDate:
duedate = null
または
duedate is null
検索結果の並び順の基準として使用する値を持つフィールドを指定するために使用します。
既定では、フィールド独自の並び順が使用されます。昇順 (asc
) または降順 (desc
) を指定することで、この順序を上書きできます。
Find all issues without a Advanced Searching#DueDate, sorted by Advanced Searching#CreationDate:
duedate = empty order by created
Find all issues without a Advanced Searching#DueDate, sorted by Advanced Searching#CreationDate, then by Advanced Searching#Priority (highest to lowest):
duedate = empty order by created, priority desc
Find all issues without a Advanced Searching#DueDate, sorted by Advanced Searching#CreationDate, then by Advanced Searching#Priority (lowest to highest):
duedate = empty order by created, priority asc
Ordering by Components or Versions will list the returned issues first by Project and only then by the field's natural order (see JRA-31113).
An operator in JQL is one or more symbols or words which compares the value of a Advanced Searching#field on its left with one or more values (or functions) on its right, such that only true results are retrieved by the clause. Some operators may use the Advanced Searching#NOT keyword.
演算子の一覧:
The "=
" operator is used to search for issues where the value of the specified field exactly matches the specified value. (Note: cannot be used with Advanced Searching#text fields; see the Advanced Searching#CONTAINS operator instead.)
To find issues where the value of a specified field exactly matches multiple values, use multiple "=
" statements with the Advanced Searching#AND operator.
jsmith が作成したすべての課題を検索:
reporter = jsmith
John Smith が作成したすべての課題を検索:
reporter = "John Smith"
The "!=
" operator is used to search for issues where the value of the specified field does not match the specified value. (Note: cannot be used with Advanced Searching#text fields; see the DOES NOT MATCH ("!~
") operator instead.)
Note that typing field != value
is the same as typing NOT field = value
, and that field != EMPTY
is the same as field Advanced Searching#IS_NOT EMPTY
.
The "!=
" operator will not match a field that has no value (i.e. a field that is empty). For example, component != fred
will only match issues that have a component and the component is not "fred". To find issues that have a component other than "fred" or have no component, you would need to type: component != fred or component is empty
.
jsmith 以外のすべてのユーザーに割り当てられたすべての課題を検索:
not assignee = jsmith
または
assignee != jsmith
jsmith に割り当てられていないすべての課題を検索:
assignee != jsmith or assignee is empty
自分以外が報告した、自分に割り当てられていないすべての課題を検索:
reporter = currentUser() and assignee != currentUser()
報告社または担当者が John Smith 以外のすべてのユーザーであるすべての課題を検索:
assignee != "John Smith" or reporter != "John Smith"
未割り当てのすべての課題を検索:
assignee is not empty
または
assignee != null
The ">
" operator is used to search for issues where the value of the specified field is greater than the specified value. Cannot be used with Advanced Searching#text fields.
Note that the ">
" operator can only be used with fields which support ordering (e.g. date fields and version fields). To see a field's supported operators, check the individual Advanced Searching#field reference.
投票数が 4 票より多いすべての課題を検索:
votes > 4
期限切れのすべての課題を検索:
duedate < now() and resolution is empty
優先度が "Normal" より高いすべての課題を検索:
priority > normal
The ">=
" operator is used to search for issues where the value of the specified field is greater than or equal to the specified value. Cannot be used with Advanced Searching#text fields.
Note that the ">=
" operator can only be used with fields which support ordering (e.g. date fields and version fields). To see a field's supported operators, check the individual Advanced Searching#field reference.
投票数が 4 票以上のすべての課題を検索:
votes >= 4
期限が 2008 年 12 月 31 日以降のすべての課題を検索:
duedate >= "2008/12/31"
過去 5 日間に作成されたすべての課題を検索:
created >= "-5d"
The "<
" operator is used to search for issues where the value of the specified field is less than the specified value. Cannot be used with Advanced Searching#text fields.
Note that the "<
" operator can only be used with fields which support ordering (e.g. date fields and version fields). To see a field's supported operators, check the individual Advanced Searching#field reference.
投票数が 4 票より少ないすべての課題を検索:
votes < 4
The "<=
" operator is used to search for issues where the value of the specified field is less than or equal to than the specified value. Cannot be used with Advanced Searching#text fields.
Note that the "<=
" operator can only be used with fields which support ordering (e.g. date fields and version fields). To see a field's supported operators, check the individual Advanced Searching#field reference.
投票数が 4 票以下のすべての課題を検索:
votes <= 4
過去 1 ヶ月間 (30 日間) 更新されなかったすべての課題を検索:
updated <= "-4w 2d"
"IN
" 演算子は、指定したフィールドの値が対象となる複数の値のいずれかである課題を検索するために使用します。値は、括弧で囲んだカンマ区切りのリスト形式で指定します。
Using "IN
" is equivalent to using multiple Advanced Searching#EQUALS (=)
statements, but is shorter and more convenient. That is, typing reporter IN (tom, jane, harry)
is the same as typing reporter = "tom" Advanced Searching#OR reporter = "jane" Advanced Searching#OR reporter = "harry"
.
jsmith、jbrown、jjones のいずれかが作成したすべての課題を検索:
reporter in (jsmith,jbrown,jjones)
報告者または担当者が Jack または Jill であるすべての課題を検索:
reporter in (Jack,Jill) or assignee in (Jack,Jill)
バージョン 3.14 またはバージョン 4.2 のすべての課題を検索:
affectedVersion in ("3.14","4.2")
"NOT IN
" 演算子は、指定したフィールドの値が対象となる複数の値に含まれない課題を検索するために使用します。
Using "NOT IN
" is equivalent to using multiple Advanced Searching#NOT_EQUALS (!=)
statements, but is shorter and more convenient. That is, typing reporter NOT IN (tom, jane, harry)
is the same as typing reporter != "tom" Advanced Searching#AND reporter != "jane" Advanced Searching#AND reporter != "harry"
.
The "NOT IN
" operator will not match a field that has no value (i.e. a field that is empty). For example, assignee not in (jack,jill)
will only match issues that have an assignee and the assignee is not "jack" or "jill". To find issues that are assigned to someone other than "jack" or "jill" or are unassigned, you would need to type: assignee not in (jack,jill) or assignee is empty
.
Assignee (担当者) が Jack、Jill または John の課題をすべて検索する:
assignee not in (Jack,Jill,John)
Assignee (担当者) が、Jack、Jill、John 以外の課題をすべて検索する:
assignee not in (Jack,Jill,John) or assignee is empty
FixVersion (修正バージョン) が、'A'、'B'、'C'、'D' 以外の課題をすべて検索する:
FixVersion not in (A, B, C, D)
FixVersion (修正バージョン) が、'A'、'B'、'C'、'D' 以外、または指定されていない課題をすべて検索する:
FixVersion not in (A, B, C, D) or FixVersion is empty
"~
" 演算子は、指定したフィールドの値が指定した値と一致する課題の検索に使用します (完全一致またはあいまい一致。以降の例を参照)。次のようなテキスト フィールドでのみ使用できます。
Note: when using the "~
" operator, the value on the right-hand side of the operator can be specified using JIRA text-search syntax.
要約に "win" の単語 (または "wins" などの指定した語を含む単語) を含むすべての課題を検索:
summary ~ win
Summary (概要) に "win" という単語に対するワイルドカード一致が含まれる課題をすべて検索する:
summary ~ "win*"
Summary (概要) に、"full screen" の語句の完全一致が含まれる課題をすべて検索する (引用符とその他の特殊文字のエスケープ方法についての詳細は、「Reserved Characters (予約文字)」を参照してください)。
summary ~ "\"full screen\""
"!~
" 演算子は、指定したフィールドの値が指定した値のあいまい一致に該当しない課題の検索に使用します。次のようなテキスト フィールドでのみ使用できます。
Note: when using the "!~
" operator, the value on the right-hand side of the operator can be specified using JIRA text-search syntax.
要約に "run" の単語 (または "running" などの指定した語を含む単語) を含まないすべての課題を検索:
summary !~ run
The "IS
" operator can only be used with Advanced Searching#EMPTY or Advanced Searching#NULL. That is, it is used to search for issues where the specified field has no value.
Note that not all Advanced Searching#fields are compatible with this operator; see the individual Advanced Searching#field reference for details.
修正バージョンを持たないすべての課題を検索:
fixVersion is empty
または
fixVersion is null
The "IS NOT
" operator can only be used with Advanced Searching#EMPTY or Advanced Searching#NULL. That is, it is used to search for issues where the specified field has a value.
Note that not all Advanced Searching#fields are compatible with this operator; see the individual Advanced Searching#field reference for details.
投票数が 1 票以上のすべての課題を検索:
votes is not empty
または
votes is not null
The "WAS
" operator is used to find issues that currently have, or previously had, the specified value for the specified field.
AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"
(注意:この演算子は、Assignee (担当者)、Fix Version (修正バージョン)、Priority (優先度)、Reporter (報告者)、Resolution (解決策)、Status (ステータス) フィールドでのみ使用できます。)
現在または過去のステータスが "n Progress (進行中)" である (であった) 課題を検索する:
status WAS "In Progress"
Joe Smith が 2 月 2 日より前に解決した課題を検索:
status WAS "Resolved" BY jsmith BEFORE "02/02/2011"
Joe Smith が 2010 年に解決した課題を検索:
status WAS "Resolved" BY jsmith DURING ("01/01/2010","01/01/2011")
The "WAS IN
" operator is used to find issues that currently have, or previously had, any of multiple specified values for the specified field. The values are specified as a comma-delimited list, surrounded by parentheses.
Using "WAS IN
" is equivalent to using multiple Advanced Searching#WAS
statements, but is shorter and more convenient. That is, typing status WAS IN ('Resolved', 'Closed')
is the same as typing status WAS "Resolved" Advanced Searching#OR status WAS "Closed"
.
AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"
(注意:この演算子は、Assignee (担当者)、Fix Version (修正バージョン)、Priority (優先度)、Reporter (報告者)、Resolution (解決策)、Status (ステータス) フィールドでのみ使用できます。)
現在または過去のステータスが "Resolved" または "In Progress" であるすべての課題を検索:
status WAS IN ("Resolved","In Progress")
"WAS NOT IN
" 演算子は、指定したフィールドの値が対象の複数の値のいずれかを持ったことがない課題を検索するために使用します。
Using "WAS NOT IN
" is equivalent to using multiple Advanced Searching#WAS_NOT
statements, but is shorter and more convenient. That is, typing status WAS NOT IN ("Resolved","In Progress")
is the same as typing status WAS NOT "Resolved" Advanced Searching#AND status WAS NOT "In Progress"
.
AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"
(注意:この演算子は、Assignee (担当者)、Fix Version (修正バージョン)、Priority (優先度)、Reporter (報告者)、Resolution (解決策)、Status (ステータス) フィールドでのみ使用できます。)
"Resolved" または "In Progress" のステータスを持ったことがないすべての課題を検索:
status WAS NOT IN ("Resolved","In Progress")
2 月 2 日より前に "Resolved" または "In Progress" のステータスを持たなかったすべての課題を検索:
status WAS NOT IN ("Resolved","In Progress") BEFORE "02/02/2011"
"WAS NOT
" 演算子は、指定したフィールドが対象の値を持ったことがない課題の検索に使用します。
AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"
(注意:この演算子は、Assignee (担当者)、Fix Version (修正バージョン)、Priority (優先度)、Reporter (報告者)、Resolution (解決策)、Status (ステータス) フィールドでのみ使用できます。)
ステータスが "In Progress (進行中)" ではなく、これまでにもなったことがない課題を検索する:
status WAS NOT "In Progress"
2 月 2 日より前に "In Progress" ステータスを持たなかった課題を検索:
status WAS NOT "In Progress" BEFORE "02/02/2011"
The "CHANGED
" operator is used to find issues that have a value which had changed for the specified field.
この演算子では次の述部を使用できます:
AFTER "日付"
BEFORE "日付"
BY "ユーザー名"
DURING ("日付1","日付2")
ON "日付"
FROM "古い値"
TO "新しい値"
(Note: This operator can be used with the Advanced Searching#Assignee, Fix Version, Priority, Advanced Searching#Reporter, Advanced Searching#Resolution and Advanced Searching#Status fields only.)
担当者が変更された課題を検索:
assignee CHANGED
ステータスが "In Progress" から "Open " に変更された課題を検索:
status CHANGED FROM "In Progress" TO "Open"
現在の週の間にユーザー "freddo" が Priority を変更した課題を検索:
priority CHANGED BY freddo BEFORE endOfWeek() AFTER startOfWeek()
A field in JQL is a word that represents a JIRA field (or a custom field that has already been defined in JIRA). In a clause, a field is followed by an Advanced Searching#operator, which in turn is followed by one or more values (or functions). The operator compares the value of the field with one or more values or functions on the right, such that only true results are retrieved by the clause.
フィールド一覧:
特定の Affects Version (対象バージョン) に割り当てられた課題を検索します。検索条件にはバージョン名またはバージョン ID (例: JIRA がバージョンに自動的に割り当てる番号) を使用できます。
バージョン名で検索するよりも、バージョン ID で検索する方が安全です。
異なるプロジェクトに同じ名前のバージョンがある場合があります。そのため、バージョン名で検索すると、複数のプロジェクトから課題が返される可能性があります。また、JIRA 管理者がバージョン名を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。バージョン ID は一意であり、変更できません。
Note: this field supports Advanced Searching#auto-complete.
affectedVersion
VERSION
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
比較演算子 (例: ">") は、数値やアルファベット順ではなく、プロジェクト管理者が設定したバージョン順を使用します。
AffectedVersion (対象バージョン) が 3.14 の課題を検索する:
affectedVersion = "3.14"
(Note that full-stops are reserved Advanced Searching#characters, so they need to be surrounded by quote marks.)
AffectedVersion (対象バージョン) が "Big Ted" の課題を検索する:
affectedVersion = "Big Ted"
AffectedVersion ID (対象バージョン ID) が 10350 の課題を検索する:
affectedVersion = 10350
特定のユーザーに割り当てられた課題を検索します。検索条件にはユーザーのフルネーム、ID またはメールアドレスを使用できます。
Note: this field supports Advanced Searching#auto-complete.
担当者
USER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
John Smith に割り当てられた課題を検索する:
assignee = "John Smith"
または
assignee = jsmith
John Smith に現在割り当てられている、または過去に割り当てられていた課題を検索する:
assignee WAS "John Smith"
または
assignee WAS jsmith
Find issues that are assigned by the user with email address "bob@mycompany.com":
assignee = "bob@mycompany.com"
(Note that full-stops and "@" symbols are reserved Advanced Searching#characters, so the email address needs to be surrounded by quote-marks.)
特定のカテゴリー内のプロジェクトに所属する課題を検索します。
Note: this field supports Advanced Searching#auto-complete.
category
CATEGORY
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
"Alphabet Projects" カテゴリーのプロジェクトに所属する課題を検索する:
category = "Alphabet Projects"
Comment (コメント) に特定のテキストが含まれる課題を検索します。
JIRA テキスト検索構文を使用できます。
Note: this field does not support Advanced Searching#auto-complete.
comment
TEXT
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Comment (コメント) に "My PC is quite old (自分の PC は非常に古い)" と一致するテキストが含まれる課題を検索する (例: 「あいまい」一致):
comment ~ "My PC is quite old"
Comment (コメント) に "My PC is quite old (自分の PC は非常に古い)" との完全一致が含まれる課題を検索する:
comment ~ "\"My PC is quite old\""
プロジェクトの特定のコンポーネントに割り当てられた課題を検索します。検索条件にはコンポーネント名またはコンポーネント ID (例: JIRA がバージョンに自動的に割り当てる番号) を使用できます。
コンポーネント名で検索するよりも、コンポーネント ID で検索する方が安全です。
異なるプロジェクトに同じ名前のコンポーネントがある場合があります。そのため、コンポーネント名で検索すると、複数のプロジェクトから課題が返される可能性があります。また、JIRA 管理者がコンポーネント名を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。コンポーネント ID は一意であり、変更できません。
Note: this field supports Advanced Searching#auto-complete.
component
COMPONENT
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
When used with the Advanced Searching#IN and NOT IN operators, component
supports:
"Comp1" または "Comp2" コンポーネント内の課題を検索する:
component in (Comp1, Comp2)
"Comp1" および "Comp2" コンポーネント内の課題を検索する:
component in (Comp1) and component in (Comp2)
または
component = Comp1 and component = Comp2
ID が 20500 のコンポーネント内で課題を検索する:
component = 20500
Search for issues that were created on, before or after a particular date (or date range). Note that if a time-component is not specified, midnight will be assumed. Please note that the search results will be relative to your configured time zone (which is by default the JIRA server's time zone).
"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"
Or use "w"
(weeks), "d"
(days), "h"
(hours) or "m"
(minutes) to specify a date relative to the current time. The default is "m"
(minutes). Be sure to use quote-marks ("
); if you omit the quote-marks, the number you supply will be interpreted as milliseconds after epoch (1970-1-1).
Note: this field does not support Advanced Searching#auto-complete.
created
Alias (エイリアス):
createdDate
DATE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find all issues created before 12th December 2010:
created < "2010/12/12"
Find all issues created on or before 12th December 2010:
created <= "2010/12/13"
2010 年 12 月 12 日 2:00pm より前に作成された課題をすべて検索する:
created > "2010/12/12" and created < "2010/12/12 14:00"
1 日以内に作成された課題を検索する:
created > "-1d"
2011 年 1 月に作成された課題を検索する:
created > "2011/01/01" and created < "2011/02/01"
2011 年 1 月 15 日に作成された課題を検索する:
created > "2011/01/15" and created < "2011/01/16"
JIRA 管理者が 1 つ以上のカスタム フィールドを作成した場合にのみ適用されます。
特定のカスタム フィールドに特定の値が入力された課題を検索します。
検索条件にはカスタム フィールド名またはカスタム フィールド ID (例: JIRA がカスタム フィールドに自動的に割り当てた番号) を使用できます。
カスタム フィールド名で検索するよりも、カスタム フィールド ID で検索する方が安全です。
カスタム フィールドの名前が、組み込み JIRA システム フィールドと同じ場合は、システム フィールド (カスタム フィールドではなく) 上で検索を実行します。この場合、JIRA 管理者がカスタム フィールド名を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。コンポーネント ID は一意であり、変更できません。
注意:
CustomFieldName
Alias (エイリアス):
cf[CustomFieldID]
カスタム フィールドの設定によって異なる
Different types of Custom Fields support different Advanced Searching#operators. For the default Custom Field Types, the following operators are supported:
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Different types of Custom Fields support different Advanced Searching#functions. For the default Custom Field Types, the following functions are supported:
"Location (場所)" カスタム フィールドの値が "New York" の課題を検索する:
location = "New York"
ID が 10003 で、カスタム フィールドの値が "New York" の課題を検索する:
cf[10003] = "New York"
"Location (場所)" カスタム フィールドの値が "London"、"Milan" または "Paris" の課題を検索する:
cf[10003] in ("London", "Milan", "Paris")
"Location (場所)" カスタム フィールドの値がない課題を検索する:
location != empty
Description (説明) に特定のテキストが含まれる課題を検索します。
JIRA テキスト検索構文を使用できます。
Note: this field does not support Advanced Searching#auto-complete.
description
TEXT
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Description (説明) に "Please see screenshot (スクリーンショットを参照)" と一致するテキストが含まれる課題を検索する (例: 「あいまい」一致):
description ~ "Please see screenshot"
Description (説明) に "Please see screenshot (スクリーンショットを参照)" との完全一致が含まれる課題を検索する:
description ~ "\"Please see screenshot\""
特定の日付 (または日付範囲)、それよりも前、またはそれよりも後に期限切れとなった課題を検索します。期日は日付とのみ関連付けられます (時刻ではない)。
"yyyy/MM/dd"
"yyyy-MM-dd"
Or use "w"
(weeks) or "d"
(days) to specify a date relative to the current date. Be sure to use quote-marks ("
).
Note: this field does not support Advanced Searching#auto-complete.
due
Alias (エイリアス):
dueDate
DATE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2010 年 12 月 31 日より前に期限切れとなった課題をすべて検索する:
due < "2010/12/31"
2010 年 12 月 31 日以前に期限切れとなった課題をすべて検索する:
due <= "2011/01/01"
期日が明日の課題をすべて検索する:
due = "1d"
2011 年 1 月が期日の課題をすべて検索する:
due >= "2011/01/01" and due <= "2011/01/31"
2011 年 1 月 15 日が期日の課題をすべて検索する:
due = "2011/01/15"
Environment (環境) に特定のテキストが含まれる課題をすべて検索します。
JIRA テキスト検索構文を使用できます。
Note: this field does not support Advanced Searching#auto-complete.
environment
TEXT
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Environment (環境) に "Third floor (3 階)" と一致するテキストが含まれる課題を検索する (例: 「あいまい」一致)
environment ~ "Third floor"
Environment (環境) に "Third floor (3 階)" との完全一致が含まれる課題を検索する:
environment ~ "\"Third floor\""
フィルターを使用して検索を絞り込むことができます。検索条件にはフィルター名またはフィルター ID (例: JIRA が保存済みのフィルターに自動的に割り当てる番号) を使用できます。
フィルター名で検索するよりも、フィルター ID で検索する方が安全です。
フィルター名が変更されて保存済みフィルターが壊れ、名前で別のフィルタが呼び出されてしまう可能性があります。ただし、フィルター ID は一意であり、変更できません。
注意:
filter
エイリアス:
リクエスト
savedFilter
searchRequest
フィルター
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
ユーザー jsmith に割り当てられた課題のフィルター "My Saved Filter (マイ保存済みフィルター)" (ID は 12000) の結果を検索する:
filter = "My Saved Filter" and assignee = jsmith
または
filter = 12000 and assignee = jsmith
特定の Fix Version (修正バージョン) に割り当てられた課題を検索します。検索条件にはバージョン名またはバージョン ID (例: JIRA がバージョンに自動的に割り当てる番号) を使用できます。
バージョン名で検索するよりも、バージョン ID で検索する方が安全です。
異なるプロジェクトに同じ名前のバージョンがある場合があります。そのため、バージョン名で検索すると、複数のプロジェクトから課題が返される可能性があります。また、JIRA 管理者がバージョン名を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。バージョン ID は一意であり、変更できません。
Note: this field supports Advanced Searching#auto-complete.
fixVersion
VERSION
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
比較演算子 (例: ">") は、数値やアルファベット順ではなく、プロジェクト管理者が設定したバージョン順を使用します。
Fix Version (修正バージョン) が 3.14 または 4.2 の課題を検索する:
fixVersion in ("3.14", "4.2")
(Note that full-stops are reserved Advanced Searching#characters, so they need to be surrounded by quote marks.)
Fix Version (修正バージョン) が "Little Ted" の課題を検索する:
fixVersion = "Little Ted"
Fix Version ID (修正バージョン ID) が 10001 の課題を検索する:
fixVersion = 10001
検索は特定の課題キーまたは課題 ID (例: JIRA が課題に自動的に割り当てる番号) のいずれかに基づいて実行されます。
Note: this field does not support Advanced Searching#auto-complete.
issueKey
エイリアス:
ID
課題
鍵 (キー)
ISSUE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
When used with the Advanced Searching#IN or NOT IN operators, issueKey
supports:
キーが "ABC-123" の課題を検索する:
issueKey = ABC-123
JIRA 管理者が Issue Level Security (課題レベル セキュリティ) を有効にしている場合にのみ使用できます。
特定の Security Level (セキュリティ レベル) に割り当てられた課題を検索します。検索条件にはセキュリティ レベル名または課題セキュリティ レベル ID (例: JIRA が課題セキュリティ レベルに自動的に割り当てる番号) を使用できます。
セキュリティ レベル名で検索するよりも、セキュリティ レベル ID で検索する方が安全です。
また、JIRA 管理者がセキュリティ レベル名を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。ただし、セキュリティ レベル ID は一意であり、変更できません。
Note: this field supports Advanced Searching#auto-complete.
レベル
SECURITY LEVEL
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Security Level (セキュリティ レベル) が "Really High (非常に高い)" または "レベル1" の課題を検索する:
level in ("Really High", level1)
Security Level ID (セキュリティ レベル ID) が 123 の課題を検索する:
level = 123
JIRA 管理者が時間管理を有効にしている場合にのみ使用できます。
Original Estimate (最初の予測) が特定の値 (例: 数字、日付や日付範囲ではない) に設定されている課題を検索します。
"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。
Note: this field does not support Advanced Searching#auto-complete.
originalEstimate
Alias (エイリアス):
timeOriginalEstimate
DURATION
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Original Estimate (最初の予測) が 1 時間の課題を検索する:
originalEstimate = 1h
Original Estimate (最初の予測) が 2 日より多い課題を検索する:
originalEstimate > 2d
JIRA 管理者がサブタスクを有効にしている場合にのみ使用できます。
特定の課題のサブタスクをすべて検索します。検索は課題キーまたは課題 ID (例: JIRA が課題に自動的に割り当てる番号) のいずれかに基づいて行われます。
Note: this field does not support Advanced Searching#auto-complete.
parent
ISSUE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
"TEST-1234" を親に持つサブタスクを検索する:
parent = TEST-1234
特定の Priority (優先度) に割り当てられた課題を検索します。検索条件には優先度または優先度 ID (例: JIRA が優先度に自動的に割り当てる番号) を使用できます。
優先度名で検索するよりも、優先度 ID で検索する方が安全です。
JIRA 管理者が優先度の名前を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。ただし、優先度 ID は一意であり、変更できません。
Note: this field supports Advanced Searching#auto-complete.
優先度
PRIORITY
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Priority (優先度) が "High (高)" の課題を検索する:
priority = High
Priority ID (優先度 ID) が 10000 の課題を検索する:
priority = 10000
特定のプロジェクトに割り当てられた課題を検索します。
You can search by Project Name, by Project Key or by Project ID (i.e. the number that JIRA automatically allocates to a project).
Note: this field supports Advanced Searching#auto-complete.
プロジェクト
PROJECT
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
When used with the Advanced Searching#IN and NOT IN operators, project
supports:
"ABC Project" という名前のプロジェクトに所属する課題を検索する:
project = "ABC Project"
キーが "ABC" のプロジェクトに所属する課題を検索する:
project = "ABC"
ID が "1234" のプロジェクトに所属する課題を検索する:
project = 1234
JIRA 管理者が時間管理を有効にしている場合にのみ使用できます。
Remaining Estimate (残余予測) が特定の値 (例: 数字、日付や日付範囲ではない) に設定されている課題を検索します。
"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。
Note: this field does not support Advanced Searching#auto-complete.
remainingEstimate
Alias (エイリアス):
timeEstimate
DURATION
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Remaining Estimate (残余予測) が 4 日より多い課題を検索する:
remainingEstimate > 4h
Search for issues that were reported by (i.e. created by) a particular user.
検索条件にはユーザーのフルネーム、ID またはメールアドレスを使用できます。
Note: this field supports Advanced Searching#auto-complete.
reporter
USER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Jill Jones が作成した課題を検索する:
reporter = "Jill Jones"
または
reporter = jjones
Search for issues that were created by the user with email address "bob@mycompany.com":
assignee = "bob@mycompany.com"
(Note that full-stops and "@" symbols are reserved Advanced Searching#characters, so the email address needs to be surrounded by quote-marks.)
特定の Resolution (解決策) に割り当てられた課題を検索します。
検索条件には解決策名または解決策 ID (例: JIRA が解決策に自動的に割り当てる番号) を使用できます。
解決策名で検索するよりも、解決策 ID で検索する方が安全です。
JIRA 管理者が解決策の名前を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。ただし、解決策 ID は一意であり、変更できません。
Note: this field supports Advanced Searching#auto-complete.
resolution
RESOLUTION
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Resolution (解決策) が "Cannot Reproduce (再現不可)" または "Won't Fix (修正しない)" の課題を検索する:
resolution in ("Cannot Reproduce", "Won't Fix")
Resolution ID (解決策 ID) が 5 の課題を検索する:
resolution = 5
解決策がない課題を検索する:
resolution = unresolved
特定の日付 (または日付範囲)、それよりも前、またはそれよりも後に解決された課題を検索します。時間コンポーネントが指定されていない場合、深夜0時 と想定されます。 検索結果は設定したタイムゾーン (既定では JIRA サーバーのタイムゾーン) に対して相対的なものとなります。
"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"
Or use "w"
(weeks), "d"
(days), "h"
(hours) or "m"
(minutes) to specify a date relative to the current time. The default is "m"
(minutes). Be sure to use quote-marks ("
); if you omit the quote-marks, the number you supply will be interpreted as milliseconds after epoch (1970-1-1).
Note: this field does not support Advanced Searching#auto-complete.
resolved
Alias (エイリアス):
resolutionDate
DATE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find all issues that were resolved before 31st December 2010:
resolved <= "2010/12/31"
2010 年 12 月 31 日 の 2:00 pm より前に解決された課題をすべて検索する:
resolved < "2010/12/31 14:00"
2010 年 12 月 31 日以前に解決された課題をすべて検索する:
resolved <= "2011/01/01"
2011 年 1 月に解決された課題を検索する:
resolved > "2011/01/01" and resolved < "2011/02/01"
2011 年 1 月 15 日に解決された課題を検索する:
resolved > "2011/01/15" and resolved < "2011/01/16"
過去 1 時間以内に解決された課題を検索する:
resolved > -1h
Only available if you are using GreenHopper.
Search for issues that are assigned to a particular sprint in GreenHopper. The search is based on the sprint ID (i.e. the number that JIRA automatically allocates to a sprint).
sprint
数値
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
スプリント 999 に所属する課題を検索する:
sprint = 999
Find issues that belong to either sprint 1, sprint 3 or sprint 4:
sprint in (1,3,4)
スプリントに割り当てられた課題を検索する:
sprint is not empty
特定の Status (ステータス) を持つ課題を検索します。
検索条件にはステータス名またはステータス ID (例: JIRA がステータスに自動的に割り当てる番号) を使用できます。
ステータス名で検索するよりも、ステータス ID で検索する方が安全です。
JIRA 管理者がステータスの名前を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。ただし、ステータス ID は一意であり、変更できません。
Please note, though, that the Advanced Searching#WAS
, Advanced Searching#WAS_NOT
, Advanced Searching#WAS_IN
and Advanced Searching#WAS_NOT_IN
operators can only be used with the name (not the ID).
Note: this field supports Advanced Searching#auto-complete.
ステータス
STATUS
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Status (ステータス) が " Open (未処理)" の課題を検索する:
status = Open
Status ID (ステータス ID) が 1 の課題を検索する:
status = 1
現在または過去のステータスが "Open (未処理)" である (であった) 課題を検索する:
status WAS Open
Summary (概要) に特定のテキストが含まれる 課題を検索します。
JIRA テキスト検索構文を使用できます。
Note: this field does not support Advanced Searching#auto-complete.
要約
TEXT
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Summary (概要) に "Error saving file (ファイルの保存エラー)" と一致するテキストが含まれる課題を検索する (例: 「あいまい」一致):
summary ~ "Error saving file"
Summary (概要) に "Error saving file (ファイルの保存エラー)" との完全一致が含まれる課題を検索する:
summary ~ "\"Error saving file\""
これは、次のすべてのテキスト フィールドを検索できる "マスター フィールド" です。
メモ:
text
master-field can only be used with the Advanced Searching#CONTAINS operator ("~
" and "!~
").text
TEXT
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
テキスト フィールドが、"Fred" の単語と一致する課題を検索する:
text ~ "Fred"
または
text ~ Fred
テキスト フィールドに "full screen (フルスクリーン)" と完全一致が含まれる課題をすべて検索する:
text ~ "\"full screen\""
特定の Issue Type (課題タイプ) の課題を検索します。
検索は課題タイプ名または課題タイプ ID (例: JIRA が課題タイプに自動的に割り当てる番号) のいずれかに基づいて行われます。
タイプ名で検索するよりも、タイプ ID で検索する方が安全です。
JIRA 管理者がタイプの名前を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。ただし、タイプ ID は一意であり、変更できません。
Note: this field supports Advanced Searching#auto-complete.
type
Alias (エイリアス):
issueType
ISSUE_TYPE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Issue Type (課題タイプ) が "Bug (バグ)" の課題を検索する:
type = Bug
Issue Type (課題タイプ) が "Bug (バグ)" または "Improvement (改善)" の課題を検索する:
issueType in (Bug,Improvement)
Issue Type ID (課題タイプ ID) が 2 の課題を検索する:
issueType = 2
JIRA 管理者が時間管理を有効にしている場合にのみ使用できます。
Time Spent (所要時間) が特定の値 (例: 数字、日付や日付範囲ではない) に設定されている課題を検索します。
"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。
Note: this field does not support Advanced Searching#auto-complete.
timeSpent
DURATION
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Time Spent (所要時間) が 5 日より多い課題を検索する:
timeSpent > 5d
最後に更新されたのが特定の日付 (または日付範囲)、それよりも前、またはそれよりも後の課題を検索します。時間コンポーネントが指定されていない場合、深夜0時 と想定されます。 検索結果は設定したタイムゾーン (既定では JIRA サーバーのタイムゾーン) に対して相対的なものとなります。
"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"
Or use "w"
(weeks), "d"
(days), "h"
(hours) or "m"
(minutes) to specify a date relative to the current time. The default is "m"
(minutes). Be sure to use quote-marks ("
); if you omit the quote-marks, the number you supply will be interpreted as milliseconds after epoch (1970-1-1).
Note: this field does not support Advanced Searching#auto-complete.
updated
Alias (エイリアス):
updatedDate
DATE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
最後に更新されたのが 2010 年 12 月 12 日より前の課題を検索する:
updated < "2010/12/12"
最後に更新されたのが 2010 年 12 月 12 日より前の課題を検索する:
updated < "2010/12/13"
2010 年 12 月 31 日 の 2:00 pm より前に更新された課題をすべて検索する:
updated < "2010/12/31 14:00"
最後に更新されたのが 2 週間より前の課題を検索する:
updated < "-2w"
最後に更新されたのが 2011 年 1 月 15 日の課題を検索する:
updated > "2011/01/15" and updated < "2011/01/16"
最後に更新されたのが 2011 年 1 月の課題を検索する:
updated > "20011/01/01" and updated < "2011/02/01"
Search for issues for which a particular user has voted. You can search by the user's Full Name, ID or Email Address. Note that you can only find issues for which you have the "View Voters and Watchers" permission, unless you are searching for your own votes. See also Advanced Searching#votedIssues.
Note: this field supports Advanced Searching#auto-complete.
voter
USER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
自分が投票した課題を検索する:
voter = currentUser()
ユーザー "jsmith" が投票した課題を検索する:
voter = "jsmith"
グループ "jira-developers" のメンバーが投票した課題を検索する:
voter in membersOf("jira-developers")
指定した数の投票数の課題を検索します:
Note: this field does not support Advanced Searching#auto-complete.
votes
NUMBER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
12 票以上の課題をすべて検索する:
votes >= 12
Search for issues that a particular user is watching. You can search by the user's Full Name, ID or Email Address. Note that you can only find issues for which you have the "View Voters and Watchers" permission, unless you are searching for issues where you are the watcher. See also Advanced Searching#watchedIssues.
Note: this field supports Advanced Searching#auto-complete.
watcher
USER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
自分がウォッチしている課題を検索する:
watcher = currentUser()
ユーザー "jsmith" がウォッチしている課題を検索する:
watcher = "jsmith"
グループ "jira-developers" がウォッチしている課題を検索する:
watcher in membersOf("jira-developers")
指定した数の監視者がいる課題を検索します:
Note: this field does not support Advanced Searching#auto-complete.
watchers
NUMBER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
3 人以上にウォッチされている課題をすべて検索する:
watchers > 3
JIRA 管理者が時間管理を有効にしている場合にのみ使用できます。
Work Ratio (作業率) が特定の値の課題を検索します。
Work Ratio is calculated as follows: workRatio = Advanced Searching#timeSpent / Advanced Searching#originalEstimate) x 100
Note: this field does not support Advanced Searching#auto-complete.
workRatio
NUMBER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
所要時間が Original Estimate (最初の予測) の 75 % より多い課題を検索する:
workRatio > 75
A function in JQL appears as a word followed by parentheses which may contain one or more explicit values or JIRA fields. In a clause, a function is preceded by an Advanced Searching#operator, which in turn is preceded by a Advanced Searching#field. A function performs a calculation on either specific JIRA data or the function's content in parentheses, such that only true results are retrieved by the function and then again by the clause in which the function is used.
List of Functions:
Search for issues that match the selected values of a 'cascading select' custom field.
The parentOption parameter matches against the first tier of options in the cascading select field. The childOption parameter matches against the second tier of options in the cascading select field, and is optional.
The keyword "none"
can be used to search for issues where either or both of the options have no value.
cascadeOption(parentOption)
または
cascadeOption(parentOption,childOption)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues where a custom field ("Location") has the value "USA" for the first tier and "New York" for the second tier:
location in cascadeOption("USA","New York")
Find issues where a custom field ("Location") has the value "USA" for the first tier and any value (or no value) for the second tier:
location in cascadeOption("USA")
Find issues where a custom field ("Location") has the value "USA" for the first tier and no value for the second tier:
location in cascadeOption("USA",none)
Find issues where a custom field ("Location") has no value for the first tier and no value for the second tier:
location in cascadeOption(none)
Find issues where a custom field ("Referrer") has the value "none" for the first tier and "none" for the second tier:
referrer in cascadeOption("\"none\"","\"none\"")
Find issues where a custom field ("Referrer") has the value "none" for the first tier and no value for the second tier:
referrer in cascadeOption("\"none\"",none)
^top of functions | ^^top of topic
Only available if you are using GreenHopper.
Search for issues that are assigned to a completed Sprint. (Note that it is possible for an issue to belong to both a completed Sprint(s) and an incomplete Sprint(s).)
See also Advanced Searching#openSprints().
closedSprints()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find all issues that are assigned to a completed Sprint.
sprint in closedSprints()
^top of functions | ^^top of topic
Find issues in components that are lead 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.
componentsLeadByUser()
または
componentsLeadByUser(username)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find open issues in components that are lead by you:
component in componentsLeadByUser() AND status = Open
Find open issues in components that are lead by Bill:
component in componentsLeadByUser(bill) AND status = Open
^top of functions | ^^top of topic
Perform searches based on the time at which the current user's session began. See also Advanced Searching#lastLogin.
currentLogin()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find issues that have been created during my current session:
created > currentLogin()
^top of functions | ^^top of topic
Perform searches based on the currently logged-in user.
Note that 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.
currentUser()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues that are assigned to me:
assignee = currentUser()
自分が報告したが自分に割り当てられていない課題を検索:
reporter = currentUser() and assignee != currentUser()
^top of functions | ^^top of topic
Perform searches based on the earliest unreleased version (i.e. next version that is due to be released) of a specified project. See also Advanced Searching#unreleasedVersions.
Note that the "earliest" is determined by the ordering assigned to the versions, not by actual Version Due Dates.
earliestUnreleasedVersion(project)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues whose Advanced Searching#FixVersion is the earliest unreleased version of the ABC project:
fixVersion = earliestUnreleasedVersion(ABC)
Find issues that relate to the earlist unreleased version of the ABC project:
affectedVersion = earliestUnreleasedVersion(ABC) or fixVersion = earliestUnreleasedVersion(ABC)
^top of functions | ^^top of topic
Perform searches based on the end of the current day. See also Advanced Searching#endOfWeek, Advanced Searching#endOfMonth and Advanced Searching#endOfYear; and Advanced Searching#startOfDay, Advanced Searching#startOfWeek, Advanced Searching#startOfMonth and Advanced Searching#startOfYear.
endOfDay()
または
endOfDay("inc")
where inc
is an optional increment of (+/-)nn(y|M|w|d|h|m)
endOfDay("+1")
is the same as endOfDay("+1d")
.(+/-)
sign is omitted, plus is assumed.= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find issues due by the end of today:
due < endOfDay()
Find issues due by the end of tomorrow:
due < endOfDay("+1")
^top of functions | ^^top of topic
Perform searches based on the end of the current month. See also Advanced Searching#endOfDay, Advanced Searching#endOfWeek and Advanced Searching#endOfYear; and Advanced Searching#startOfDay, Advanced Searching#startOfWeek, Advanced Searching#startOfMonth and Advanced Searching#startOfYear.
endOfMonth()
または
endOfMonth("inc")
where inc
is an optional increment of (+/-)nn(y|M|w|d|h|m)
endOfMonth("+1")
is the same as endOfMonth("+1M")
.(+/-)
sign is omitted, plus is assumed.= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find issues due by the end of this month:
due < endOfMonth()
Find issues due by the end of next month:
due endOfMonth("+1")
Find issues due by the 15th of next month:
due endOfMonth("+15d")
^top of functions | ^^top of topic
Perform searches based on the end of the current week. See also Advanced Searching#endOfDay, Advanced Searching#endOfMonth and Advanced Searching#endOfYear; and Advanced Searching#startOfDay, Advanced Searching#startOfWeek, Advanced Searching#startOfMonth and Advanced Searching#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.
endOfWeek()
または
endOfWeek("inc")
where inc
is an optional increment of (+/-)nn(y|M|w|d|h|m)
(+/-)
sign is omitted, plus is assumed.= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find issues due by the end of this week:
due < endOfWeek()
Find issues due by the end of next week:
due < endOfWeek("+1")
^top of functions | ^^top of topic
Perform searches based on the end of the current year. See also Advanced Searching#startOfDay, Advanced Searching#startOfWeek and Advanced Searching#startOfMonth; and Advanced Searching#endOfDay, Advanced Searching#endOfWeek, Advanced Searching#endOfMonth and Advanced Searching#endOfYear.
startOfYear()
または
startOfYear("inc")
where inc
is an optional increment of (+/-)nn(y|M|w|d|h|m)
endOfYear("+1")
is the same as endofYear("+1y")
.(+/-)
sign is omitted, plus is assumed.= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find issues due by the end of this year:
due < endOfYear()
Find issues due by the end of March next year:
due < endOfYear("+3M")
^top of functions | ^^top of topic
最近閲覧した課題、つまり [課題] ドロップダウン メニューの [最近表示した課題] セクションにある課題を検索します。
注意:
issueHistory()
returns up to 50 issues, whereas the 'Recent Issues' drop-down returns only 5.issueHistory()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues which I have recently viewed, that are assigned to me:
issue in issueHistory() AND assignee = currentUser()
^top of functions | ^^top of topic
Perform searches based on the time at which the current user's previous session began. See also Advanced Searching#currentLogin.
currentLogin()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find issues that have been created during my last session:
created > lastLogin()
^top of functions | ^^top of topic
Perform searches based on the latest released version (i.e. the most recent version that has been released) of a specified project. See also Advanced Searching#releasedVersions().
Note that the "latest" is determined by the ordering assigned to the versions, not by actual Version Due Dates.
latestReleasedVersion(project)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues whose Advanced Searching#FixVersionis the latest released version of the ABC project:
fixVersion = latestReleasedVersion(ABC)
Find issues that relate to the latest released version of the ABC project:
affectedVersion = latestReleasedVersion(ABC) or fixVersion = latestReleasedVersion(ABC)
^top of functions | ^^top of topic
Perform searches based on issues which are linked to a specified issue.
You can optionally restrict the search to links of a particular type. Note that LinkType is case-sensitive.
linkedIssues(issueKey)
または
linkedIssues(issueKey,linkType)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues that are linked to a particular issue:
issue in linkedIssues(ABC-123)
Find issues that are linked to a particular issue via a particular type of link:
issue in linkedIssues(ABC-123,"is duplicated by")
^top of functions | ^^top of topic
特定のグループのメンバーに基づく検索を実施します。
membersOf(グループ)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues where the Assignee is a member of the group "jira-developers":
assignee in membersOf("jira-developers")
Search through multiple groups and a specific user, e.g:
reporter in membersOf("jira-developers") or reporter in membersOf("jira-administrators") or reporter=jsmith
Search for a particular group, but exclude a particular member or members, e.g.:
assignee in membersOf(QA) and assignee not in ("John Smith","Jill Jones")
Exclude members of a particular group:
assignee not in membersOf(QA)
^top of functions | ^^top of topic
現在の時刻に基づいた検索を行います。
now()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find issues that are overdue:
duedate < now() and status not in (closed, resolved)
^top of functions | ^^top of topic
Only available if you are using GreenHopper.
Search for issues that are assigned to a Sprint which has not yet been completed. (Note that it is possible for an issue to belong to both a completed Sprint(s) and an incomplete Sprint(s).)
See also closedSprints().
openSprints()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find all issues that are assigned to a Sprint which has not yet been completed.
sprint in openSprints()
^top of functions | ^^top of topic
Find issues in projects that are lead 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.
projectsLeadByUser()
または
projectsLeadByUser(username)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find open issues in projects that are lead by you:
project in projectsLeadByUser() AND status = Open
Find open issues in projects that are lead by Bill:
project in projectsLeadByUser(bill) AND status = Open
^top of functions | ^^top of topic
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 that this function is only available if you are logged in to JIRA.
projectsWhereUserHasPermission(permission)
For the permission
parameter you can specify any of the following:
プロジェクト権限 | 説明 |
---|---|
プロジェクト管理 | Permission to administer a project in JIRA. This includes the ability to edit project role membership, project components, project versions and some project details ('Project Name', 'URL', 'Project Lead', 'Project Description'). |
プロジェクトの参照 | Permission to browse projects, use the Issue Navigator and view individual issues (except issues that have been restricted via Issue Security). Many other permissions are dependent on this permission, e.g. the 'Work On Issues' permission is only effective for users who also have the 'Browse Projects' permission. |
View Version Control | Permission to view the related source code commits (e.g. CVS, Subversion, FishEye, etc) for an issue, in a 'Source' tab. Note that for CVS, to view the related source code commits, the project needs to be associated with at least one Repository. |
「読み取り専用」ワークフローの表示 | Permission to view the project's 'read-only' workflow when viewing an issue. This permission provides the 'View Workflow' link against the 'Status' field of the 'View Issue' page. |
課題の権限 | 説明 |
課題の割り当て | Permission to assign issues to users. (See also Assignable User permission below) |
割り当て可能なユーザー | 課題への割り当てが可能な権限 (注: 課題を割り当てをする権限は含みません。上記の課題の割り当てを参照ください。) |
課題のクローズ | Permission to close issues. (This permission is useful where, for example, developers resolve issues and testers close them). Also see the Resolve Issues permission. |
課題の作成 | Permission to create issues in the project. (Note that the Create Attachments permission is required in order to create attachments.) Includes the ability to create sub-tasks (if sub-tasks are enabled). |
課題の削除 | 課題を削除する権限。この権限を割り当てるグループやプロジェクト ロールは慎重に検討してください。通常は管理者のみに与えられます。課題を削除すると、そのユーザーがコメントの削除権限や添付ファイルの削除権限を持たない場合であっても、課題のコメントや添付ファイルがすべて削除される点にご注意ください。ただし、課題の削除権限には、個々のコメントや添付ファイルを削除する権限は含まれません。 |
課題の編集 | Permission to edit issues (excluding the 'Due Date' field — see the Schedule Issues permission). Includes the ability to convert issues to sub-tasks and vice versa (if sub-tasks are enabled). Note that the Delete Issue permission is required in order to delete issues. The Edit Issue permission is usually given to any groups or project roles who have the Create Issue permission (perhaps the only exception to this is if you give everyone the ability to create issues — it may not be appropriate to give everyone the ability to edit too). Note that all edits are recorded in the Issue Change History for audit purposes. |
課題のリンク | Permission to link issues together. (Only relevant if Issue Linking is enabled). |
報告者の修正 | 課題の [報告者] を変更する権限。これによって、ユーザーは、誰かの代理で課題を作成できるようになります。この権限は一般に、管理者にのみ付与する必要があります。 |
課題の移動 | 1つのプロジェクトから別のプロジェクト、または同じプロジェクト内の1つのワークフローから別のワークフローへ課題を移動する権限。ユーザーは課題の作成権限を持っているプロジェクトにのみ課題を移動できます。 |
課題の解決 | Permission to resolve and reopen issues. This also includes the ability to set the 'Fix For version' field for issues. Also see the Close Issues permission. |
課題のスケジュール | Permission to schedule an issue — that is, set and edit the 'Due Date' of an issue. |
課題のセキュリティの設定 | Permission to set the security level on an issue to control who can access the issue. Only relevant if issue security has been enabled. |
投票とウォッチャーの権限 | 説明 |
ウォッチャー一覧の管理 | Permission to manage (i.e. view/add/remove users to/from) the watcher list of an issue. |
投票とウォッチャーの表示 | Permission to view the voter list and watcher list of an issue. Also see the Manage Watcher List permission. |
コメントの権限 | 説明 |
コメントの追加 | Permission to add comments to issues. Note that this does not include the ability to edit or delete comments. |
すべてのコメントの削除 | Permission to delete any comments, regardless of who added them. |
自身のコメントの削除 | Permission to delete comments that were added by the user. |
すべてのコメントの編集 | Permission to edit any comments, regardless of who added them. |
自身のコメントの編集 | Permission to edit comments that were added by the user. |
添付ファイルの権限 | 説明 |
添付ファイルの作成 | Permission to attach files to an issue. (Only relevant if attachments are enabled). Note that this does not include the ability to delete attachments. |
すべての添付ファイルの削除 | Permission to delete any attachments, regardless of who added them. |
自分の添付ファイルの削除 | Permission to delete attachments that were added by the user. |
時間管理の権限 | 説明 |
課題の作業ログ | Permission to log work against an issue, i.e. create a worklog entry. (Only relevant if Time Tracking is enabled). |
すべての作業ログの削除 | Permission to delete any worklog entries, regardless of who added them. (Only relevant if Time Tracking is enabled). Also see the Work On Issues permission. |
自分の作業ログの削除 | Permission to delete worklog entries that were added by the user. (Only relevant if Time Tracking is enabled). Also see the Work On Issues permission. |
すべての作業ログの編集 | Permission to edit any worklog entries, regardless of who added them. (Only relevant if Time Tracking is enabled). Also see the Work On Issues permission. |
自分の作業ログの編集 | Permission to edit worklog entries that were added by the user. (Only relevant if Time Tracking is enabled). Also see the Work On Issues permission. |
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find open issues in projects where you have the "Resolve Issues" permission:
project in projectsWhereUserHasPermission("Resolve Issues") AND status = Open
^top of functions | ^^top of topic
Find issues in projects where you have a specific role.
Note that this function is only available if you are logged in to JIRA.
projectsWhereUserHasRole(rolename)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find open issues in projects where you have the "Developers" role:
project in projectsWhereUserHasRole("Developers") AND status = Open
^top of functions | ^^top of topic
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 Advanced Searching#latestReleasedVersion().
releasedVersions()
または
releasedVersions(project)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues whose Advanced Searching#FixVersion is a released version of the ABC project:
fixVersion in releasedVersions(ABC)
Find issues that relate to released versions of the ABC project:
(affectedVersion in releasedVersions(ABC)) or (fixVersion in releasedVersions(ABC))
^top of functions | ^^top of topic
Perform searches based on "standard" Issue Types, that is, search for issues which are not sub-tasks.
See also Advanced Searching#subtaskIssueTypes().
standardIssueTypes()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues that are not subtasks (i.e. issues whose Issue Type is a standard issue type, not a subtask issue type):
issuetype in standardIssueTypes()
^top of functions | ^^top of topic
Perform searches based on the start of the current day. See also Advanced Searching#startOfWeek, Advanced Searching#startOfMonth and Advanced Searching#startOfYear; and Advanced Searching#endOfDay, Advanced Searching#endOfWeek, Advanced Searching#endOfMonth and Advanced Searching#endOfYear.
startOfDay()
または
startOfDay("inc")
where inc
is an optional increment of (+/-)nn(y|M|w|d|h|m)
startOfDay("+1")
is the same as startofDay("+1d")
.(+/-)
sign is omitted, plus is assumed.= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find new issues created since the start of today:
created > startOfDay()
Find new issues created since the start of yesterday:
created > startOfDay("-1")
Find new issues created in the last three days:
created > startOfDay("-3d")
^top of functions | ^^top of topic
Perform searches based on the start of the current month. See also Advanced Searching#startOfDay, Advanced Searching#startOfWeek and Advanced Searching#startOfYear; and Advanced Searching#endOfDay, Advanced Searching#endOfWeek, Advanced Searching#endOfMonth and Advanced Searching#endOfYear.
startOfMonth()
または
startOfMonth("inc")
where inc
is an optional increment of (+/-)nn(y|M|w|d|h|m)
startOfMonth("+1")
is the same as startofMonth("+1M")
.(+/-)
sign is omitted, plus is assumed.= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find new issues since the start of this month:
created > startOfMonth()
Find new issues since the start of last month:
created > startOfMonth("-1")
Find new issues since the 15th of this month:
created > startOfMonth("+14d")
^top of functions | ^^top of topic
Perform searches based on the start of the current week. See also Advanced Searching#startOfDay, Advanced Searching#startOfMonth and Advanced Searching#startOfYear; and Advanced Searching#endOfDay, Advanced Searching#endOfWeek, Advanced Searching#endOfMonth and Advanced Searching#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.
startOfWeek()
または
startOfWeek("inc")
where inc
is an optional increment of (+/-)nn(y|M|w|d|h|m)
(+/-)
sign is omitted, plus is assumed.= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find new issues since the start of this week:
created > startOfWeek()
Find new issues since the start of last week:
created > startOfWeek("-1")
^top of functions | ^^top of topic
Perform searches based on the start of the current year. See also Advanced Searching#startOfDay, Advanced Searching#startOfWeek and Advanced Searching#startOfMonth; and Advanced Searching#endOfDay, Advanced Searching#endOfWeek, Advanced Searching#endOfMonth and Advanced Searching#endOfYear.
startOfYear()
または
startOfYear("inc")
where inc
is an optional increment of (+/-)nn(y|M|w|d|h|m)
startOfYear("+1")
is the same as startofYear("+1y")
.(+/-)
sign is omitted, plus is assumed.= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
(only in | (only in | (only in | (only in | (only in predicate) |
Find new issues since the start of this year:
created > startOfYear()
Find new issues since the start of last year:
created > startOfYear("-1")
^top of functions | ^^top of topic
Perform searches based on issues which are sub-tasks.
See also Advanced Searching#standardIssueTypes().
subtaskIssueTypes()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues that are subtasks (i.e. issues whose Issue Type is a subtask issue type):
issuetype in subtaskIssueTypes()
^top of functions | ^^top of topic
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 Advanced Searching#earliestUnreleasedVersion().
unreleasedVersions()
または
unreleasedVersions(project)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues whose Advanced Searching#FixVersionis an unreleased version of the ABC project:
fixVersion in unreleasedVersions(ABC)
Find issues that relate to unreleased versions of the ABC project:
affectedVersion in unreleasedVersions(ABC)
または
fixVersion in unreleasedVersions(ABC)
^top of functions | ^^top of topic
Perform searches based on issues for which you have voted. Also see the Advanced Searching#Voter field.
Note that this function can only be used by logged-in users.
votedIssues()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues that you have voted for:
issue in votedIssues()
^top of functions | ^^top of topic
Perform searches based on issues which you are watching. Also see the Advanced Searching#Watcher field.
Note that this function can only be used by logged-in users.
watchedIssues()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues that you are watching:
issue in watchedIssues()
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Find issues that you have recently viewed:
issue in issueHistory()
You can use parentheses in complex JQL statements to enforce the precedence of Advanced Searching#operators.
例えば、SysAdmin プロジェクトの解決済みの課題すべてと、システム管理者 (bobsmith) に現状、割り当てられているすべての課題を検索したい場合、 括弧を使用してクエリ内のブーリアン演算子の優先順位を変更できます。
例:
(status=resolved AND project=SysAdmin) OR assignee=bobsmith
括弧を使用しない場合、ステートメントは左から右に評価されます。
You can also use parentheses to group clauses, so that you can apply the Advanced Searching#NOT operator to the group.
You can use Lucene's text-searching features when performing searches on the following fields, using the Advanced Searching#CONTAINS operator:
詳細は、「テキスト検索の実行」のページを参照してください。
クエリを入力すると、JIRA はコンテキストを認識し、次のように「オートコンプリート」候補のリストを表示します:
The list of auto-complete suggestions is displayed alphabetically and includes the first 15 matches. Note that auto-complete suggestions are not offered for Advanced Searching#function parameters.
注意:
Auto-complete suggestions are not offered for all fields. Check the Advanced Searching#fields reference to see which fields support auto-complete.
...JIRA will offer a list of all available fields, e.g.:
...JIRA will offer a list of matching fields, e.g.:
...JIRA will offer a list of valid Advanced Searching#operators, e.g.:
...JIRA will offer a list of valid values, e.g.:
...JIRA will offer a list of valid values (if your Advanced Searching#field supports this) and valid functions for the field/operator combination, e.g.:
一般的に「簡易検索」を使用した検索は、「高度な検索」(例: JQL) へ変換したり、元に戻すことができます。
However, a query created using 'Advanced Search' may not be able to be translated to 'Simple Search', particular if:
project in (A, B)
)(project = JRA OR project = CONF)
is equivalent to this query:(project in (JRA, CONF))
, only the second query will be translated.fixVersion = "4.0"
, without the AND project=JRA
). This is especially tricky with custom fields since they can be configured on a Project/Issue Type basis. The general rule of thumb is JQLには次の一連の予約文字があります。
" "
)"+"
"."
","
";"
"?"
"|"
"*"
"/"
"%"
"^"
"$"
"#"
"@"
"["
"]"
これらの文字をクエリで利用したい場合、次のようにする必要があります。
'
) or double quote-marks ("
));The text fields are:
例:
version = "[example]"
version = "4.2"
summary ~ "\\[example\\]"
summary ~ "4.2"
JQL has a list of reserved words. These words need to be surrounded by quote-marks if you wish to use them in queries:
"abort", "access", "add", "after", "alias", "all", "alter", "and", "any", "as", "asc",
"audit", "avg", "before", "begin", "between", "boolean", "break", "by", "byte", "catch", "cf",
"char", "character", "check", "checkpoint", "collate", "collation", "column", "commit", "connect", "continue",
"count", "create", "current", "date", "decimal", "declare", "decrement", "default", "defaults", "define", "delete",
"delimiter", "desc", "difference", "distinct", "divide", "do", "double", "drop", "else", "empty", "encoding",
"end", "equals", "escape", "exclusive", "exec", "execute", "exists", "explain", "false", "fetch", "file", "field",
"first", "float", "for", "from", "function", "go", "goto", "grant", "greater", "group", "having",
"identified", "if", "immediate", "in", "increment", "index", "initial", "inner", "inout", "input", "insert",
"int", "integer", "intersect", "intersection", "into", "is", "isempty", "isnull", "join", "last", "left",
"less", "like", "limit", "lock", "long", "max", "min", "minus", "mode", "modify",
"modulo", "more", "multiply", "next", "noaudit", "not", "notin", "nowait", "null", "number", "object",
"of", "on", "option", "or", "order", "outer", "output", "power", "previous", "prior", "privileges",
"public", "raise", "raw", "remainder", "rename", "resource", "return", "returns", "revoke", "right", "row",
"rowid", "rownum", "rows", "select", "session", "set", "share", "size", "sqrt", "start", "strict",
"string", "subtract", "sum", "synonym", "table", "then", "to", "trans", "transaction", "trigger", "true",
"uid", "union", "unique", "update", "user", "validate", "values", "view", "when", "whenever", "where",
"while", "with"
You can use either single quote-marks ('
) or double quote-marks ("
).
(Note for JIRA administrators: this list is hard coded in the JqlStringSupportImpl.java
file.)
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|