テキスト フィールドを使用した課題の検索

Search for work items using the text field with the right syntax. You can use the syntax for text fields when searching for recent or specific work items (supported fields), and advanced search (when CONTAINS (~) operator is used).

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

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

クエリ用語

A query is broken up into terms and operators. There are two types of terms: single terms (e.g. "hello") and phrases (e.g. "hello dolly"). Query terms in Jira are not case-sensitive. Multiple terms can be combined together with Boolean operators to form a more complex query (see below). If you combine multiple terms without specifying any Boolean operators, they will be joined using AND operators.

用語の検索

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

完全検索 (フレーズ)

To find exact matches for phrases, for example Jira Software, you need to enclose the whole phrase in quote-marks ("). Otherwise, the search will return all work items that contain both words in no particular order - this would include Jira Software, but also Jira is the best software!.

例

Basic search: Find all work items that contain the phrase jira software:

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

Advanced search: Find all work items that contain the words jira and software, in no particular order.

text ~ "jira software"

Advanced search: Find all work items that contain the exact phrase “Jira Software”.

text ~ "\"jira software\""

Advanced search: Find all work items that contain both the exact phrase "Jira Software" and the exact phrase “hello world”.

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

Advanced search: Find all work items that contain the words “Jira” and “Software” in no particular order (a “fuzzy” search), and that also contain the exact phrase “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 のいずれかのを含む検索を確実に行うことができます。

予約語

To keep the search index size and search performance optimal in Jira, the following English reserved words (also known as 'stop words') are ignored from the search index and hence, the Jira text search features:

"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"

Be aware that this can sometimes lead to unexpected results. For example, suppose one work item contains the text phrase "VSX will crash" and another work item contains the phrase "VSX will not crash". A text search for "VSX will crash" will return both of these work items. This is because the words will and not are part of the reserved words list.

単語の語幹抽出

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 issues containing words that are stemmed back to the same root will also be retrieved in the search results.

For example, if you search for work items using the query term 'customize' on the Summary field, Jira stems this word to its root form 'custom', and will retrieve all work items whose Summary field also contains any word that can be stemmed back to 'custom'.

The above will retrieve work items whose Summary field contains the following words:

• customized

• customizing

• customs

• customer

• など。

ステミング モード

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

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

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

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

The difference between them is how each word in your Jira work item is saved in the database, or tokenized. We recommend that you use the moderate or minimal stemming modes. If you enable aggressive stemming, text searches with special characters like /,@, _, ^etc. inside the search word (for example summary ~ "atlassian_jira”) will be tokenized very aggressively. As a result, fewer search results will be returned and the search experience of your users will suffer.