[!JIRADL:_Images^jira_ninja.png!]
[!JIRADL:_Images^agile_ninja.png!]
Hey there! This page is no longer being maintained, but we've created some new and improved resources to replace it. Head on over to our Quickstart
site to check them out.
高度な検索を使用すると、構造化されたクエリを使用して、JIRA 課題を検索できます。検索結果は課題ナビゲーターに表示され、そこから MS Excel などの多様な形式でエクスポートできます。また、希望する場合は高度な検索へ保存したり、サブスクライブすることもできます。
高度な検索を実行するときには、JIRA クエリ言語 (JQL) を使用します。
JQL (または '条件') の単純なクエリは、 フィールド、演算子、 1 つ以上の値または関数で構成されています。例えば、次の単純なクエリは、「TEST」プロジェクト内の全課題を検索します:
project = "TEST"
(This example uses the Project field, the EQUALS operator, and the value "TEST".)
Be aware that it is not possible to compare two fields.
JQL gives you some SQL-like syntax, such as the ORDER BY SQL keyword and ISNULL() SQL function (i.e. the NULL keyword in JQL). However, JQL is not a database query language. For example, JQL does not have a
SELECT statement.
次のフィールドでの検索の実行には、CONTAINS 演算子を使用した Lucene の文字検索機能を使用できます。
The JQL field "text" as in text ~ "some words" searches an issue's Summary, Description, Environment, Comments. It also searches all text custom fields. If you have many text custom fields you can improve performance of your queries by searching on specific fields, e.g. Summary ~ "some words" OR Description ~ "some words"
For details, including information on including special characters in your searches, please see the page on Performing Text Searches.
クエリを入力すると、JIRA はコンテキストを認識し、次のように「オートコンプリート」候補のリストを表示します:
オートコンプリート候補のリストは、アルファベット順に最初の 15 件の一致が表示されます。注意: オートコンプリート候補は関数パラメーターでは表示されません。
注意:
オートコンプリート候補はすべてのフィールドで表示される訳ではありません。オートコンプリートをサポートしているフィールドを確認するには、フィールド参照を確認してください。
一般的に「簡易検索」を使用した検索は、「高度な検索」(例: JQL) へ変換したり、元に戻すことができます。
ただし、「高度な検索」を使用して作成されたクエリを「簡易検索」に変換することはできません。特に次のような場合は変換できません。
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 that if the query cannot be created in the 'Simple Search' form, then if it is created using 'Advanced Search' it will not be able to be translated to 'Simple Search'.
複雑な JQL 構文では、括弧を使用して演算子の優先順位を変更できます。
例えば、SysAdmin プロジェクトの解決済みの課題すべてと、システム管理者 (bobsmith) に現状、割り当てられているすべての課題を検索したい場合、 括弧を使用してクエリ内のブーリアン演算子の優先順位を変更できます。
例:
(status=resolved AND project=SysAdmin) OR assignee=bobsmith
注意: 括弧を使用しない場合、ステートメントは演算子の優先順位を使用して評価されます。
また、括弧を使用して条件をグループ化し、グループにNOT 演算子を割り当てることができます。
括弧を追加して演算子の優先順位を変更したにもかかわらず、演算子の優先順位が同じ結果を返し、それらの括弧が必ずしも必要でない場合、保存時にステートメントから括弧が削除されます。
JQL のキーワードは、次のいずれかを行う単語または語句です。
キーワードのリスト:
複数の句を組み合わせて検索を絞り込むために使用します。
括弧を使用することで、条件の実行順序を管理することができます。
"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)
複数の句を組み合わせて検索範囲を広げるために使用します。
括弧を使用することで、条件の実行順序を管理することができます。
(注意: INについても参照してください。フィールドの複数の値を検索するのに便利です。)
jsmith または jbrown のいずれかが作成したすべての課題を検索:
reporter = jsmith or reporter = jbrown
期限切れまたは期限が設定されていないすべての課題を検索:
duedate < now() or duedate is empty
個別の条件または括弧を使用した複雑な JQL クエリ (複数の条件で構成されたクエリ) のナビゲートに使用し、検索範囲を絞り込むことができます。
(注: NOT EQUALS ("!=")、DOES NOT CONTAIN ("!~")、NOT IN および IS NOT も参照してください。)
jsmith 以外のすべてのユーザーに割り当てられたすべての課題を検索:
not assignee = jsmith
jsmith または jbrown が作成していないすべての課題を検索:
not (reporter = jsmith or reporter = jbrown)
指定されたフィールドに値が入力されていない課題を検索します。NULLも参照してください。
EMPTY は、IS および IS NOT 演算子をサポートしているフィールドでのみ使用できます。フィールドがサポートする演算子については、個々のフィールド参照を確認してください。
EMPTY と NOT EQUALS (!=) は同じではありません。
DueDate (期日)が設定されていない課題をすべて検索する:
duedate = empty
または
duedate is empty
指定されたフィールドに値が入っていない課題を検索します。 EMPTYも参照してください。
NULL は、IS および IS NOT 演算子をサポートしているフィールドでのみ使用できます。フィールドがサポートする演算子については、個々のフィールド参照を確認してください。
DueDate (期日)が設定されていない課題をすべて検索する:
duedate = null
または
duedate is null
検索結果の並び順の基準として使用する値を持つフィールドを指定するために使用します。
既定では、フィールド独自の並び順が使用されます。昇順 (asc) または降順 (desc) を指定することで、この順序を上書きできます。
DueDate (期日) が設定されていないすべての課題を検索し、CreationDate (作成日) 順に並べ替える:
duedate = empty order by created
DueDate (期日) が設定されていないすべての課題を検索し、CreationDate (作成日)、Priority (優先順位) (最高から最低の順)の順に並べ替える:
duedate = empty order by created, priority desc
DueDate (期日) が設定されていないすべての課題を検索し、CreationDate (作成日) 、 Priority (優先順位)(最低から最高) の順に並べ替える:
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).
JQL の演算子は 1 つ以上の記号または単語で、その左のフィールドの値と右側の 1 つ以上の値 (または関数) を比較し、条件によって TRUE の結果のみを取得します。一部の演算子では NOT キーワードを使用する場合があります。
演算子の一覧:
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 text fields; see the CONTAINS operator instead.)
To find issues where the value of a specified field exactly matches multiple values, use multiple "=" statements with the 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 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 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 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 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 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 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 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 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 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 field reference.
投票数が 4 票以下のすべての課題を検索:
votes <= 4
過去 1 ヶ月間 (30 日間) 更新されなかったすべての課題を検索:
updated <= "-4w 2d"
"IN" 演算子は、指定したフィールドの値が対象となる複数の値のいずれかである課題を検索するために使用します。値は、括弧で囲んだカンマ区切りのリスト形式で指定します。
Using "IN" is equivalent to using multiple EQUALS (=) statements, but is shorter and more convenient. That is, typing reporter IN (tom, jane, harry) is the same as typing reporter = "tom" OR reporter = "jane" 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 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" AND reporter != "jane" 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
"~" 演算子は、指定したフィールドの値が指定した値と一致する課題の検索に使用します (完全一致またはあいまい一致。以降の例を参照)。次のようなテキスト フィールドでのみ使用できます。
The JQL field "text" as in text ~ "some words" searches an issue's Summary, Description, Environment, Comments. It also searches all text custom fields. If you have many text custom fields you can improve performance of your queries by searching on specific fields, e.g. Summary ~ "some words" OR Description ~ "some words"
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*"
要約に ”issue" および "collector" の単語を含むすべての課題を検索:
summary ~ "issue collector"
Summary (概要) に、"full screen" の語句の完全一致が含まれる課題をすべて検索する (引用符とその他の特殊文字のエスケープ方法についての詳細は、「Reserved Characters (予約文字)」を参照してください)。
summary ~ "\"full screen\""
"!~" 演算子は、指定したフィールドの値が指定した値のあいまい一致に該当しない課題の検索に使用します。次のようなテキスト フィールドでのみ使用できます。
The JQL field "text" as in text ~ "some words" searches an issue's Summary, Description, Environment, Comments. It also searches all text custom fields. If you have many text custom fields you can improve performance of your queries by searching on specific fields, e.g. Summary ~ "some words" OR Description ~ "some words"
The "!~" operator will not match a field that has no value (i.e. a field that is empty). For example, description != fred will only match issues that have a description and the description is not "fred". To find issues that have a description other than "fred" or have no description, you would need to type: description != fred or description 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.
要約に "run" の単語 (または "running" などの指定した語を含む単語) を含まないすべての課題を検索:
summary !~ run
The "IS" operator can only be used with EMPTY or NULL. That is, it is used to search for issues where the specified field has no value.
この演算子と互換性のないフィールドもあります。詳細は個々のフィールド参照をご覧ください。
修正バージョンを持たないすべての課題を検索:
fixVersion is empty
または
fixVersion is null
The "IS NOT" operator can only be used with EMPTY or NULL. That is, it is used to search for issues where the specified field has a value.
この演算子と互換性のないフィールドもあります。詳細は個々のフィールド参照をご覧ください。
投票数が 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 "2011/02/02"
Joe Smith が 2010 年に解決した課題を検索:
status WAS "Resolved" BY jsmith DURING ("2010/01/01","2011/01/01")
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 WAS statements, but is shorter and more convenient. That is, typing status WAS IN ('Resolved', 'Closed') is the same as typing status WAS "Resolved" 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 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" 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 "2011/02/02"
"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 "2011/02/02"
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 "新しい値"
(注意: この演算子は、Assignee (担当者)、Fix Version (修正バージョン)、Priority (優先度)、Reporter (報告者)、Resolution (解決策)、Status (ステータス) フィールドでのみ使用できます。)
担当者が変更された課題を検索:
assignee CHANGED
ステータスが "In Progress" から "Open " に変更された課題を検索:
status CHANGED FROM "In Progress" TO "Open"
現在の週の間にユーザー "freddo" が Priority を変更した課題を検索:
priority CHANGED BY freddo BEFORE endOfWeek() AFTER startOfWeek()
JQL のフィールドは、JIRA フィールド (あるいは JIRA で定義済みのカスタム フィールド) を表す単語です。条件では、フィールドの後に演算子、その後に 1 つ以上の値 (または関数) が続きます。演算子はフィールド の値と右側の 1 つ以上の値 (または 関数 ) を比較し、条件によって TRUE の結果のみを取得します。
フィールド一覧:
特定の Affects Version (対象バージョン) に割り当てられた課題を検索します。検索条件にはバージョン名またはバージョン ID (例: JIRA がバージョンに自動的に割り当てる番号) を使用できます。
バージョン名で検索するよりも、バージョン ID で検索する方が安全です。
異なるプロジェクトに同じ名前のバージョンがある場合があります。そのため、バージョン名で検索すると、複数のプロジェクトから課題が返される可能性があります。また、JIRA 管理者がバージョン名を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。バージョン ID は一意であり、変更できません。
注意: このフィールドはオートコンプリートをサポートしています。
affectedVersion
VERSION
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
比較演算子 (例: ">") は、数値やアルファベット順ではなく、プロジェクト管理者が設定したバージョン順を使用します。
AffectedVersion (対象バージョン) が 3.14 の課題を検索する:
affectedVersion = "3.14"
(注意: ピリオドは予約文字のため、クオテーションマークで囲う必要があります。)
AffectedVersion (対象バージョン) が "Big Ted" の課題を検索する:
affectedVersion = "Big Ted"
AffectedVersion ID (対象バージョン ID) が 10350 の課題を検索する:
affectedVersion = 10350
特定のユーザーに割り当てられた課題を検索します。検索条件にはユーザーのフルネーム、ID またはメールアドレスを使用できます。
注意: このフィールドはオートコンプリートをサポートしています。
担当者
USER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
EQUALS および NOT EQUALS演算子と共に使用する場合、このフィールドは以下をサポートします:
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"
(注意: ピリオドおよび「@」記号は予約文字のため、メールアドレスはクオテーションマークで囲う必要があります。)
添付ファイルがある、または添付ファイルがない課題を検索します。このフィールドには EMPTY または IS NOT EMPTY 演算子のみを使用できます。
注意: このフィールドはオートコンプリートをサポートしています。
attachments
ATTACHMENT
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
なし
添付ファイルがある課題を検索する
attachments IS NOT EMPTY
添付ファイルがない課題を検索する
attachments IS EMPTY
特定のカテゴリー内のプロジェクトに所属する課題を検索します。
注意: このフィールドはオートコンプリートをサポートしています。
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 テキスト検索構文を使用できます。
注意:このフィールドは、オートコンプリートをサポートしていません。
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 は一意であり、変更できません。
注意: このフィールドはオートコンプリートをサポートしています。
component
COMPONENT
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
When used with the 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
特定の日付 (または日付範囲)、それよりも前、またはそれよりも後に作成された課題を検索します。時間コンポーネントが指定されていない場合、真夜中 00:00 と想定されます。 検索結果は設定したタイムゾーン (既定では 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).
注意:このフィールドは、オートコンプリートをサポートしていません。
created
Alias (エイリアス):
createdDate
DATE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2010 年 12 月 12 日の真夜中 00:00 より前に作成された課題をすべて検索する:
created < "2010/12/12"
2010 年 12 月 12 日以前 (ただし 2010 年 12 月 13 日以外) に作成された課題をすべて検索する:
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"
特定のユーザー以外が作成した課題を検索する:
検索条件にはユーザーのフルネーム、ID またはメールアドレスを使用できます。
注意: このフィールドはオートコンプリートをサポートしています。
creator
USER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
EQUALS および NOT EQUALS演算子と共に使用する場合、このフィールドは以下をサポートします:
Jill Jones が作成した課題を検索する:
creator = "Jill Jones"
または
creator = jjones
Search for issues that were created by the user with email address "bob@mycompany.com":
creator = "bob@mycompany.com"
(注意: ピリオドおよび「@」記号は予約文字のため、メールアドレスはクオテーションマークで囲う必要があります。)
JIRA 管理者が 1 つ以上のカスタム フィールドを作成した場合にのみ適用されます。
特定のカスタム フィールドに特定の値が入力された課題を検索します。
検索条件にはカスタム フィールド名またはカスタム フィールド ID (例: JIRA がカスタム フィールドに自動的に割り当てた番号) を使用できます。
カスタム フィールド名で検索するよりも、カスタム フィールド ID で検索する方が安全です。
カスタム フィールドの名前が、組み込み JIRA システム フィールドと同じ場合は、システム フィールド (カスタム フィールドではなく) 上で検索を実行します。この場合、JIRA 管理者がカスタム フィールド名を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。コンポーネント ID は一意であり、変更できません。
注意:
CustomFieldName
Alias (エイリアス):
cf[CustomFieldID]
カスタム フィールドの設定によって異なる
カスタム フィールドの種類が異なると、サポートしている演算子も異なります。既定のカスタム フィールド タイプでは、次の演算子をサポートしています:
= | != | ~ | !~ | > | >= | < | <= | 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
カスタム フィールドの種類が異なると、サポートしている関数も異なります。既定のカスタム フィールド タイプでは、次の関数をサポートしています:
"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 テキスト検索構文を使用できます。
注意:このフィールドは、オートコンプリートをサポートしていません。
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 (").
注意:このフィールドは、オートコンプリートをサポートしていません。
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 テキスト検索構文を使用できます。
注意:このフィールドは、オートコンプリートをサポートしていません。
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\""
Only available if you are using JIRA Agile 6.1.2 or later.
JIRA Agile の特定のエピックに所属している課題を検索します。検索はエピックの名前、課題キーまたは課題 ID (例: JIRA が課題に自動的に割り当てる番号) のいずれかに基づいて実行されます。
注意:このフィールドは、オートコンプリートをサポートしていません。
"epic link"
エピック リンク リレーションシップ (JIRA Agile によって作成されたカスタムのタイプ)。
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
When used with the IN or NOT IN operators, epic link supports:
エピック "Jupiter" (課題キー ANERDS-317) に所属する課題を検索する:
"epic link" = ANERDS-317
または
"epic link" = Jupiter
フィルターを使用して検索を絞り込むことができます。検索条件にはフィルター名またはフィルター 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 は一意であり、変更できません。
注意: このフィールドはオートコンプリートをサポートしています。
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")
(注意: ピリオドは予約文字のため、クオテーションマークで囲う必要があります。)
Fix Version (修正バージョン) が "Little Ted" の課題を検索する:
fixVersion = "Little Ted"
Fix Version ID (修正バージョン ID) が 10001 の課題を検索する:
fixVersion = 10001
検索は特定の課題キーまたは課題 ID (例: JIRA が課題に自動的に割り当てる番号) のいずれかに基づいて実行されます。
注意:このフィールドは、オートコンプリートをサポートしていません。
issueKey
エイリアス:
ID
課題
鍵 (キー)
ISSUE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
When used with the IN or NOT IN operators, issueKey supports:
キーが "ABC-123" の課題を検索する:
issueKey = ABC-123
ラベルまたはラベルの一覧でタグ付けされた問題を検索します。ラベルが付いていない課題を検索することもできます。これにより、関連するスプリント、キュー、レポートに表示するためにはどの課題にタグを追加する必要があるかを簡単に確認できます。
labels
LABEL
= , !=, IS, IS NOT, IN, NOT IN
1 つのラベルを検索するには IS または IS NOT を、ラベルの一覧について検索するには IN または NOT IN を使用することをお勧めします。
n/a
Find issues with an existing label:
labels = "x"
Find issues without a specified label, including issues without a label:
labels not in ("x") or labels is EMPTY
^top of fields | ^^top of topic
最後に閲覧されたのが特定の日付 (または日付範囲)、それよりも前、またはそれよりも後の課題を検索します。時間コンポーネントが指定されていない場合、真夜中 00:00 と想定されます。 検索結果は設定したタイムゾーン (既定では 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).
注意:このフィールドは、オートコンプリートをサポートしていません。
lastViewed
DATE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
最後に閲覧されたのが 2010 年 12 月 12 日より前の課題をすべて検索する:
lastViewed < "2010/12/12"
最後に閲覧されたのが 2010 年 12 月 12 日以前(ただし 2010 年 12 月 13 日以外) の課題をすべて検索する:
lastViewed <= "2010/12/13"
最後に閲覧されたのが 2010 年 12 月 12 日 2:00pm より前の課題をすべて検索する:
lastViewed > "2010/12/12" and created < "2010/12/12 14:00"
最後に閲覧されたのが 1 日以内の課題を検索する:
lastViewed > "-1d"
最後に閲覧されたのが 2011 年 1 月の課題を検索する:
lastViewed > "2011/01/01" and created < "2011/02/01"
最後に閲覧されたのが 2011 年 1 月 15 日の課題を検索する:
lastViewed > "2011/01/15" and created < "2011/01/16"
JIRA 管理者が Issue Level Security (課題レベル セキュリティ) を有効にしている場合にのみ使用できます。
特定の Security Level (セキュリティ レベル) に割り当てられた課題を検索します。検索条件にはセキュリティ レベル名または課題セキュリティ レベル ID (例: JIRA が課題セキュリティ レベルに自動的に割り当てる番号) を使用できます。
セキュリティ レベル名で検索するよりも、セキュリティ レベル ID で検索する方が安全です。
また、JIRA 管理者がセキュリティ レベル名を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。ただし、セキュリティ レベル ID は一意であり、変更できません。
注意: このフィールドはオートコンプリートをサポートしています。
レベル
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" を使用して、週、日付、時間、分を指定します。
注意:このフィールドは、オートコンプリートをサポートしていません。
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 が課題に自動的に割り当てる番号) のいずれかに基づいて行われます。
注意:このフィールドは、オートコンプリートをサポートしていません。
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 は一意であり、変更できません。
注意: このフィールドはオートコンプリートをサポートしています。
優先度
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
特定のプロジェクトに割り当てられた課題を検索します。
検索条件にはプロジェクト名、プロジェクト キーまたはプロジェクト ID (例: JIRA が優先度に自動的に割り当てる番号) を使用できます。ごく稀に、プロジェクト キーが別のプロジェクトの名前と同じプロジェクトがあり、プロジェクト キーが優先順位を使用して 2 つ目のプロジェクトの結果を非表示にする場合があります。
注意: このフィールドはオートコンプリートをサポートしています。
プロジェクト
PROJECT
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
When used with the 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" を使用して、週、日付、時間、分を指定します。
注意:このフィールドは、オートコンプリートをサポートしていません。
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
特定のユーザーによって報告された課題を検索します。このユーザーが作成者と同じ場合もありますが、明確ではありません。
検索条件にはユーザーのフルネーム、ID またはメールアドレスを使用できます。
注意: このフィールドはオートコンプリートをサポートしています。
reporter
USER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
EQUALS および NOT EQUALS演算子と共に使用する場合、このフィールドは以下をサポートします:
Jill Jones が報告した課題を検索する:
reporter = "Jill Jones"
または
reporter = jjones
Search for issues that were reported by the user with email address "bob@mycompany.com":
reporter = "bob@mycompany.com"
(注意: ピリオドおよび「@」記号は予約文字のため、メールアドレスはクオテーションマークで囲う必要があります。)
特定の Resolution (解決策) に割り当てられた課題を検索します。
検索条件には解決策名または解決策 ID (例: JIRA が解決策に自動的に割り当てる番号) を使用できます。
解決策名で検索するよりも、解決策 ID で検索する方が安全です。
JIRA 管理者が解決策の名前を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。ただし、解決策 ID は一意であり、変更できません。
注意: このフィールドはオートコンプリートをサポートしています。
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
特定の日付 (または日付範囲)、それよりも前、またはそれよりも後に解決された課題を検索します。時間コンポーネントが指定されていない場合、真夜中 00:00 と想定されます。 検索結果は設定したタイムゾーン (既定では 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).
注意:このフィールドは、オートコンプリートをサポートしていません。
resolved
Alias (エイリアス):
resolutionDate
DATE
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2010 年 12 月 31 日より前(ただし 2010 年 12 月 31 日以外) に解決された課題をすべて検索する:
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 JIRA Agile.
JIRA Agile の特定のスプリントに割り当てられた課題を検索します。アクティブなスプリントと将来のスプリントが対象となります。検索はスプリント名、またはスプリント ID (例: JIRA がスプリントに自動的に割り当てる番号) のいずれかに基づいて行われます。
sprint
If you have multiple sprints with similar (or identical) names, you can simply search by using the sprint name — or even just part of it. The possible matches will be shown in the autocomplete drop-down, with the sprint dates shown to help you distinguish between them. (The sprint ID will also be shown, in brackets).
数値
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
スプリント 999 に所属する課題を検索する:
sprint = 999
スプリント "February 1" に所属する課題を検索する:
sprint = "February 1"
"February 1"、"February 2" または "February 3" のいずれかに所属する課題を検索する:
sprint in ("February 1","February 2","February 3")
スプリントに割り当てられた課題を検索する:
sprint is not empty
特定の Status (ステータス) を持つ課題を検索します。
検索条件にはステータス名またはステータス ID (例: JIRA がステータスに自動的に割り当てる番号) を使用できます。
ステータス名で検索するよりも、ステータス ID で検索する方が安全です。
JIRA 管理者がステータスの名前を変更し、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。ただし、ステータス ID は一意であり、変更できません。
Please note, though, that the WAS, WAS_NOT, WAS_IN and WAS_NOT_IN operators can only be used with the name (not the ID).
注意: このフィールドはオートコンプリートをサポートしています。
ステータス
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 テキスト検索構文を使用できます。
注意:このフィールドは、オートコンプリートをサポートしていません。
要約
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\""
これは、次のすべてのテキスト フィールドを検索できる "マスター フィールド" です。
The JQL field "text" as in text ~ "some words" searches an issue's Summary, Description, Environment, Comments. It also searches all text custom fields. If you have many text custom fields you can improve performance of your queries by searching on specific fields, e.g. Summary ~ "some words" OR Description ~ "some words"
メモ:
text master-field can only be used with the CONTAINS operator ("~").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 は一意であり、変更できません。
注意: このフィールドはオートコンプリートをサポートしています。
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" を使用して、週、日付、時間、分を指定します。
注意:このフィールドは、オートコンプリートをサポートしていません。
timeSpent
DURATION
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
Time Spent (所要時間) が 5 日より多い課題を検索する:
timeSpent > 5d
最後に更新されたのが特定の日付 (または日付範囲)、それよりも前、またはそれよりも後の課題を検索します。時間コンポーネントが指定されていない場合、真夜中 00:00 と想定されます。 検索結果は設定したタイムゾーン (既定では 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).
注意:このフィールドは、オートコンプリートをサポートしていません。
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 日以前(ただし 2010 年 12 月 13 日以外) の課題を検索する:
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"
特定のユーザーが投票した課題を検索します。検索条件にはユーザーのフルネーム、ID またはメール アドレスを使用できます。自分の投票を検索する場合を除き、"View Voters and Watchers (投票者と監視者の表示)" 権限 を持つ課題のみを検索できます。votedIssues も参照してください。
注意: このフィールドはオートコンプリートをサポートしています。
voter
USER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
EQUALS および NOT EQUALS演算子と共に使用する場合、このフィールドは以下をサポートします:
自分が投票した課題を検索する:
voter = currentUser()
ユーザー "jsmith" が投票した課題を検索する:
voter = "jsmith"
グループ "jira-developers" のメンバーが投票した課題を検索する:
voter in membersOf("jira-developers")
指定した数の投票数の課題を検索します:
注意:このフィールドは、オートコンプリートをサポートしていません。
votes
NUMBER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
12 票以上の課題をすべて検索する:
votes >= 12
特定のユーザーがウォッチしている課題を検索します。検索にはユーザーのフルネーム、ID またはメール アドレスを使用できます。自分の投票を検索する場合を除き、"View Voters and Watchers (投票者と監視者の表示)" 権限を持つ課題のみを検索できます。watchedIssues も参照してください。
注意: このフィールドはオートコンプリートをサポートしています。
watcher
USER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
EQUALS および NOT EQUALS演算子と共に使用する場合、このフィールドは以下をサポートします:
自分がウォッチしている課題を検索する:
watcher = currentUser()
ユーザー "jsmith" がウォッチしている課題を検索する:
watcher = "jsmith"
グループ "jira-developers" がウォッチしている課題を検索する:
watcher in membersOf("jira-developers")
指定した数の監視者がいる課題を検索します:
注意:このフィールドは、オートコンプリートをサポートしていません。
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 (作業率) の計算方法:workRatio = timeSpent / originalEstimate) x 100
注意:このフィールドは、オートコンプリートをサポートしていません。
workRatio
NUMBER
= | != | ~ | !~ | > | >= | < | <= | IS | IS NOT | IN | NOT IN | WAS | WAS IN | WAS NOT | WAS NOT IN | CHANGED |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
n/a
所要時間が Original Estimate (最初の予測) の 75 % より多い課題を検索する:
workRatio > 75