Search for work items using the text field

正しい構文のテキスト フィールドを使用して、作業項目を検索します。最近の作業項目または特定の作業項目 (サポートされているフィールド) を検索する場合、および高度な検索 (CONTAINS (~) 演算子を使用) をする場合は、テキスト フィールドの構文を使用できます。

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

次の情報は、検索に使用できる構文を理解するのに役立ちます。

クエリ用語

クエリは用語と演算子で構成されます。用語には 2 種類あります。単一用語 (「hello」など) とフレーズ (「hello dolly」など) です。Jira では、クエリ用語の大文字と小文字が区別されません。複数の用語をブール演算子と組み合わせてより複雑なクエリを作成することもできます (下記参照)。ブール演算子を指定せずに複数の用語を組み合わせる場合、用語は AND 演算子を使用して結合されます。

用語の検索

単語の末尾に「*」を使用すると、複数文字のワイルドカード検索を実行できます。引用符で囲まれた複数文字のワイルドカード検索は、0 個以上の文字を検索します。たとえば、Windows、Win95 または WindowsNT を検索するには、次を使用できます。

完全検索 (フレーズ)

Jira Software のように、完全一致するフレーズを検索するには、フレーズ全体を引用符 (") で囲む必要があります。これを行わない場合、順不同で両方の語が含まれるすべての作業項目が検索結果として返されます。これには Jira Software が含まれますが、「Jira is the best software!」も含まれます。

例

基本検索: フレーズ「jira ソフトウェア」を含むすべての作業項目を検索します。

検索フィールドに「Jira Software」と入力します。

高度な検索: jira とソフトウェアという語を含むすべての作業項目を順不同で検索します。

text ~ "jira software"

高度な検索: “Jira Software” と完全に一致するフレーズを含むすべての作業項目を検索します。

text ~ "\"jira software\""

高度な検索: "Jira Software" と完全一致のフレーズ "hello world" の両方を含むすべての作業項目を検索します。

text ~ "\"jira software"\" AND text ~ "\"hello world\""

高度な検索: 順不同で "Jira" と "ソフトウェア" という語を含み (あいまい検索)、かつ「hello world」と完全一致するフレーズも含むすべての作業項目を検索します。

text ~ "jira software" AND text ~ "\"hello world\""

前の例からわかるように、正確な語句を検索する場合、クエリには引用符のペアが 2 つ含まれます。 外側のものは JQL ルールを満たすために必要なものであり、検索クエリには関係しません。

ブール演算子

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

または

OR 演算子は既定の結合演算子です。つまり、2 つの単語間にブール演算子が存在しない場合、OR 演算子が使用されます。OR 演算子は 2 つの単語をリンクし、いずれかの単語を含むドキュメントが見つかった場合は一致するドキュメントを返します。これは和集合に相当します。OR の代わりに || 記号を使用することもできます。

"atlassian jira" または "confluence" を含むドキュメントを検索するには、次のクエリを使用します。

または

AND

AND 演算子は、1 つのドキュメントのテキストに両方の単語が存在する場合に、一致するドキュメントを返します。これは論理積に相当します。AND の代わりに && 記号を使用することもできます。

"atlassian jira" および "work item tracking" を含むドキュメントを検索するには、次のクエリを使用します。

必須用語

"+"（必須演算子）は、単一ドキュメントのフィールド内のどこかに "+" 記号に続く用語が存在しなければならないことを意味します。

"jira" を必ず含み、"atlassian" を任意で含むドキュメントを検索するには、次のクエリを使用します。

NOT

NOT 演算子は、NOT に続く単語を含むドキュメントを除外します。これは差集合に相当します。NOT の代わりに ! 記号を使用することもできます。

"atlassian jira" を含むが、"japan" は含まないドキュメントを検索するには、次のクエリを使用します。

NOT 演算子は、1 つの用語のみでは使用できません。たとえば、次の検索では結果は返されません。

除外用語

"-" は禁止演算子とも呼ばれ、"-" 記号に続く単語を含むドキュメントを除外します。

"atlassian jira" を含むが、"japan" は含まないドキュメントを検索するには、次のクエリを使用します。

グループ化

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

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

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

予約語

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

"a", "an", "abort", "access", "add", "after", "alias", "all", "alter", "and", "any", "are", "as", "asc", "at", "audit", "avg", "be", "before", "begin", "between", "boolean", "break", "but", "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", "it", "join", "last", "left", "less", "like", "limit", "lock", "long", "max", "min", "minus", "mode", "modify", "modulo", "more", "multiply", "next", "no", "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", "such", "sum", "synonym", "table", "that", "the", "their", "then", "there", "these", "they", "this", "to", "trans", "transaction", "trigger", "true", "uid", "union", "unique", "update", "user", "validate", "values", "view", "was", "when", "whenever", "where", "while", "will", "with"

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

単語の語幹抽出

Since Jira cannot search for work items containing parts of words (see below), word 'stemming' allows you to retrieve work items from a search based on the 'root' (or 'stem') forms of words instead of requiring an exact match with specific forms of these words. The number of work items retrieved from a search based on a stemmed word is typically larger, since any other work items containing words that are stemmed back to the same root will also be retrieved in the search results.

たとえば、要約フィールドでクエリ用語「customize」を使用して作業項目を検索する場合、Jira はこの単語の語根形「custom」を抽出し、「custom」に由来する単語が要約フィールドに含まれているすべての作業項目を取得します。

上の例では、"要約" フィールド内に次の単語を含む作業項目が取得されます。

• customized

• customizing

• customs

• customer

• など。

ステミング モード

英語の場合は、[設定] > [システム] > [一般設定] で [インデックス言語] を変更してステミング モードを選択できます。次の 3 つのモードがあります。

• 英語－高度のステミング

• 英語－適度のステミング

• 英語－最低限のステミング

これらの違いは、Jira 作業項目内の各単語をデータベースに保存する方法、つまりトークン化の方法です。中度または最小限のステミング モードを使用することをお勧めします。高度なステミングを有効にすると、/,@, _, ^ などの特殊文字を含むテキスト検索を検索ワード内 (例: summary ~ "atlassian_jira”) で行った場合、非常に高度にトークン化されます。その結果、返される検索結果が少なくなり、ユーザーの検索エクスペリエンスが低下します。