テキスト フィールドの検索構文

クエリ用語

クエリは、用語と演算子から構成されます。用語には 2 種類あります: 単一用語とフレーズです。

単一用語とは、"test" や " hello" などの単一の単語です。

フレーズとは、"hello dolly" など、二重引用符で囲まれた単語のグループです。

複数の用語をブール演算子と組み合わせてより複雑なクエリを作成することもできます (下記参照)。ブール演算子を指定せずに複数の用語を組み合わせる場合、用語はAND 演算子を使用して結合されます。

注意: Jira では、すべてのクエリ用語で大文字と小文字を区別しません。

用語の修飾子

Jira では、幅広い検索オプションを提供するために、クエリ用語の修飾がサポートされています。

te?t

win*

wi*95

roam~

summary ~ "magic*"

summary ~ "*box"

"atlassian Jira"~10

用語のブースト: ^

Jira では、検索で見つかった用語に基づいて、一致したドキュメントの関連度が提供されます。用語をブーストするには、検索語の末尾にキャレット "^" 記号とブースト係数 (数値) を設定します。ブースト係数が高いほど、用語の関連度が高くなります。

ブーストを使用することで、ドキュメントの関連性を制御できます。たとえば、次の用語を検索する場合を考えます。

atlassian Jira

この "atlassian" という用語の関連度を高めたい場合、用語の横にブースト係数と ^ 記号を付けてブーストさせます。次のように入力します。

atlassian^4 Jira

これで、「atlassian」という用語が含まれるドキュメントの関連性が高くなります。次の例のように、フレーズ用語もブーストできます。

"atlassian Jira"^4 querying

既定では、ブースト係数は 1 です。ブースト係数には正の数を指定する必要がありますが、1 より小さい数値も使用できます (0.2 など)。

ブール演算子

ブール演算子を使用すると、複数の用語を論理演算子で組み合わせることができます。Jira ではブール演算子として AND、"+"、OR、NOT、"-" がサポートされています。

"atlassian Jira" AND "issue tracking"

"atlassian Jira" || confluence

"atlassian Jira" OR confluence

+Jira atlassian

"atlassian Jira" NOT "japan"

NOT "atlassian Jira"

"atlassian Jira" -japan

グループ化

Jira では、サブクエリを形成する句をグループ化するために括弧を使用できます。これは、クエリでブール論理を制御する場合に非常に役立ちます。

bugsと atlassian または Jira を検索するには、次のクエリを使用します。

bugs AND (atlassian OR Jira)

これにより曖昧さがなくなり、bugs を必ず含み、atlassian または Jira のいずれかのを含む検索を確実に行うことができます。

特殊文字

+ - & | ! ( ) { } [ ] ^ ~ * ? \ :

特殊文字はインデックスに保存されないため、検索できません。インデックスはテキストと数字のみを保持します。そのため、"\\[Jira Software\\]" を検索した場合と "Jira Software" を検索した場合、結果は同じになり、エスケープされた検索文字 ([]) は検索では無視されます。 

Jira の過去のバージョンでは、特殊文字を使用して 2 つの異なる用語ををフレーズにまとめることができました (例: "Jira+Software" または "Jira/Software")。これは Jira 8.x には適用されません。フレーズを検索したい場合は、「完全一致検索 (フレーズ)」をご参照ください。

予約語

Jira の検索インデックスのサイズと検索パフォーマンスを最適に保つため、以下の英語の予約語 (ストップ ワード) は検索インデックスから無視されます。Jira のテキスト検索の予約語は次のとおりです。

"a", "an", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"

これは予期しない結果を招くことがある可能性にご注意ください。たとえば、1 つの課題に "VSX will crash" というテキスト フレーズが含まれ、別の課題には "VSX will not crash" というフレーズが含まれているとします。"VSX will crash" のテキスト検索では、これら両方の課題が検索結果として返されます。これは、単語 "will" および "not" が予約語リストに含まれているためです。

 Your Jira administrator can make Jira index these reserved words (so that Jira will find issues based on the presence of these words) by changing the Indexing Language to Other (under Administration > System > General Configuration).

単語の語幹抽出

Jira では単語の一部を含む課題の検索はできませんが (下記参照)、単語の "語幹抽出" を使用すれば、単語の特定の形との完全一致ではなく、その単語の語幹を基にした検索で課題を取得できます。語幹抽出された単語を基にした検索で取得される課題の数は通常、多くなります。これは、同じ語感に由来する単語を含む他の課題も、検索結果として取得されるためです。

たとえば、要約フィールドでクエリ用語 "customize" を使って課題を検索する場合、Jira はこの単語の語幹 "custom" を抽出し、"custom" に由来する単語を要約フィールドに含むすべての課題を取得します。したがって、次のクエリを実行した場合:

summary ~ "customize"

要約フィールドに次の単語を含む課題が検索されます。

• customized
• customizing
• customs
• customer
• など。

 注意:

• Jira 管理者は単語の語幹抽出を無効化できます (これにより、Jira は完全に一致する単語を基にして課題を検索します)。これを行うには、 [インデックス言語] を [その他] ([管理] > [システム] > [一般設定]) に変更します。
• 単語の語幹抽出はすべての Jira フィールド (およびテキスト フィールド) に適用されます。
• Jira がフィールドのインデックスを作成する際、語幹から "派生した" すべての単語は、Jira の検索インデックスに語幹の形でのみ保管されます。

制限事項

Jira の検索には次の制限が適用される点にご注意ください。

単語レベルの一致のみ

Jira では単語の一部を含む課題の検索はできず、単語全体での一致のみがサポートされます。ただし、語幹抽出される単語は例外です。

この制限は、あいまい検索の使用にも影響しません。

次のステップ

関連トピックをご確認ください。

• 課題の検索
• クイック検索
• 基本検索
• 詳細検索