Performing Text Searches

This page provides information on how to perform text searches. It applies to both simple searches and advanced searches . (Note that this page does not apply to Quick Search).

On this page:

Query Terms

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

A Single Term is a single word such as "test" or "hello".

A Phrase is a group of words surrounded by double quotes such as "hello dolly".

Multiple terms can be combined together with Boolean operators to form a more complex query (see below).

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

Term Modifiers

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

Wildcard Searches: ? and *

JIRA は、単一文字および複数文字のワイルドカード検索に対応しています。

To perform a single character wildcard search use the "?" symbol.

To perform a multiple character wildcard search use the "*" symbol.

The single character wildcard search looks for terms that match that with the single character replaced. For example, to search for "text" or "test" you can use the search:

te?t

Multiple character wildcard searches looks for 0 or more characters. For example, to search for Windows, Win95 or WindowsNT you can use the search:

win*

You can also use the wildcard searches in the middle of a term. For example, to search for Win95 or Windows95 you can use the search

wi*95

Fuzzy Searches: ~

JIRA supports fuzzy searches. To do a fuzzy search use the tilde, "~", symbol at the end of a Single word Term. For example to search for a term similar in spelling to "roam" use the fuzzy search:

roam~

この検索では、foam や roams などの単語が検索されます。

注意：あいまい検索で見つかった用語は、自動的にブースト係数 0.2 を取得します。

Proximity Searches

JIRA supports finding words are a within a specific distance away. To do a proximity search use the tilde, "~", symbol at the end of a Phrase. For example to search for a "atlassian" and "jira" within 10 words of each other in a document use the search:

"atlassian jira"~10

Boosting a Term: ^

JIRA は、検索された用語に基づいてドキュメントを照合し、関連度を提供します。検索語の重要度を高めるには、検索語の末尾でキャレット "^" 記号をブースト係数 (数値) と共に使用します。ブースト係数が高くなると、用語の関連性が強くなります。

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

atlassian jira

and you want the term "atlassian" to be more relevant boost it using the ^ symbol along with the boost factor next to the term. You would type:

atlassian^4 jira

This will make documents with the term atlassian appear more relevant. You can also boost Phrase Terms as in the example:

"atlassian jira"^4 querying

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

Boolean Operators

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

または

The OR operator is the default conjunction operator. This means that if there is no Boolean operator between two terms, the OR operator is used. The OR operator links two terms and finds a matching document if either of the terms exist in a document. This is equivalent to a union using sets. The symbol || can be used in place of the word OR.

To search for documents that contain either "atlassian jira" or just "jira" use the query:

"atlassian jira" || jira

または

"atlassian jira" OR jira

AND

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

To search for documents that contain "atlassian jira" and "issue tracking" use the query:

"atlassian jira" AND "issue tracking"

必須用語: +

The "" or required operator requires that the term after the "" symbol exist somewhere in a the field of a single document.

To search for documents that must contain "jira" and may contain "atlassian" use the query:

+jira atlassian

NOT

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

To search for documents that contain "atlassian jira" but not "japan" use the query:

"atlassian jira" NOT "japan"

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

NOT "atlassian jira"

除外用語: -

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

To search for documents that contain "atlassian jira" but not "japan" use the query:

"atlassian jira" -japan

グループ化

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

To search for either "atlassian" or "jira" and "bugs" use the query:

bugs AND (atlassian OR jira)

This eliminates any confusion and makes sure you that bugs must exist and either term atlassian or jira may exist.

Escaping Special Characters: \

JIRA supports escaping special characters that are part of the query syntax. The current list of special characters is:

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

To escape these characters, use the \ before the character. For example, to search for (1+1) use the query:

 \(1\+1\) 

Reserved Words

Certain common words are ignored from the search and search index.

Note that this can sometimes lead to unexpected results. For example, suppose one issue contains the words "VSX will crash" and another issue contains the words "VSX will not crash". A phrase search for "VSX will crash" will return both of the issues. This is because the words will and not are part of the reserved words list.

The full list of reserved English words is:

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

Note that your JIRA Administrator can alter the behavior of JIRA in relation to these reserved words by changing the Indexing Language from "English" to "Other" under Administration > General Configuration.

制限事項

Please note that the following limitations of Lucene apply to JIRA:

単語レベルの一致のみ

You cannot search on word parts, only on whole words.