テキスト検索

標準テキスト検索

属性ベースの検索として解析されず、一重引用符で囲まれていない入力は、標準のテキスト検索として解析されます。標準のテキスト検索では、大文字と小文字が区別されません。

クエリが次のように記述されているこの例を検討してください。

スペースを含む属性の値を検索するときは、中括弧で値を設定する必要があります。この規則に従わない場合、値の最初の単語が、その前にある属性の値として解析されます。後続の単語はテキストとして解析されます。

この検索照会でのハイライトは、単語 in が状態フィールドの値として解析されたことを示していますが、これは無効です。単語 progress はハイライトされておらず、テキストとして解析されています。

クエリ内のテキストを検索するには、次のガイドラインに従います。

• この単語に一致する形式を含む課題を見つけるために単一の用語を入力してください。

  言語が索引付けされている場合、YouTrack は指定された 1 つまたは複数の単語の形態素を含む課題も返します。

• 複数の単語を入力して、指定したすべての単語を任意の順序で含む課題を検索します。

• ワイルドカードを使用してテキスト検索を拡張し、検索条件と完全には一致しない文字を含めます。

  詳しくは、テキスト検索のワイルドカードを参照してください。

どの属性を検索するかを指定しないと、YouTrack はカスタムフィールドを含め、任意の属性に一致する単語とその形態的な異形を含むすべての課題を返します。特定の issue 属性に一致するテキストを含む issue に結果を制限する方法については、テキスト属性を参照してください。

標準のテキスト検索で探していた課題が返されない場合は、次のいずれかの方法を試してください。

• 単語、フレーズ、文字列を一重引用符で囲んで設定します。

  この構文は、指定された文字列と完全に一致する課題を返します。詳細については、完全一致検索を参照してください。

• 指定した単語形式に完全に一致する課題を見つけるには、一重引用符で一重項を設定してください。

  YouTrack が単一の用語を含む検索をどのように処理するかについての詳細は、単一の用語を検索するを参照してください。

• 単語をフレーズとして含む課題を見つけるには、複数の用語を引用符で囲みます。

  フレーズは、検索クエリ内のテキストと一致し、同じ順序で表示される単語形式の連続したグループとして定義されます。フレーズにストップワードが含まれている場合は、そのストップワードは課題内の任意の単語に置き換えられます。

  YouTrack がフレーズを検索する方法の詳細については、フレーズの検索を参照してください。

完全一致検索

任意の文字列に完全に一致する課題を検索できます。

この文字列は、特定の単語形式からランダムな文字のシーケンスまで、何でもかまいません。このタイプの検索では、指定された単語、ステミング、フレーズ、ストップワード、標準のテキスト検索でサポートされているその他の自然言語機能の形態学的バリアントは無視されます。

完全一致検索クエリは、次の点で標準のテキスト検索とは異なります。

• 完全一致検索では大文字と小文字が区別されます。テキスト検索クエリでは大文字と小文字が区別されません。

• 完全一致検索クエリでは、指定した課題属性に一致する文字列を含む課題に結果を制限することはできません。検索結果には、値をテキストとして格納するすべての課題属性に一致する文字列を含むすべての課題が含まれます。

指定した文字列と完全に一致する課題を見つけるには、文字列を一重引用符で囲みます。例:

• '[i]++' を検索すると、任意の課題属性（おそらくコードスニペットまたはスタックトレース）に文字列 [i] ++ を含む課題が返されます。

• 'JetBrainz' のように、単一の単語の特定のスペルミスを含む課題を見つけることができます。

単一の用語を検索する

特定の形式の単語を含む課題を見つけるには、2 つの選択肢があります。

• 検索クエリで検索する単語を指定して、関連性の高い順に結果を並べ替えます。指定された形式の単語を含む課題は、結果の上部に表示されます。指定された用語の他の形式を含む課題はリストの下部に表示されます。

• 一重項を引用符で囲みます。この構文では、検索結果には指定された単語形式に完全に一致するもののみが含まれます。指定された単語の他の形式は結果から除外されます。

これら 2 つの検索クエリの検索結果の違いを比較します。

この例の検索クエリには、単一用語 documenting が含まれています。結果は関連性によってソートされます。

このクエリは 51,000 件以上の課題を返します。これには、documenting に類似するすべての語形（document や documentation など）を含む課題が含まれます。ただし、結果を関連度で並べ替えると、documenting という単語を含む課題がリストの上位に表示されます。課題の概要で完全一致した課題には、他の課題フィールドでの一致よりも高い関連度スコアが割り当てられます。

この例では、単一の用語が一重引用符で囲まれています: 'documenting' クエリは 170 件の課題のみを返します。documenting に類似した単語形式のみを含む課題は結果から除外されます。

ここでは、リストの一番上にある課題の概要に、指定された単語形式が含まれていない課題がいくつか表示されています。ただし、このリストのすべての課題には、コメントやカスタムフィールドなど、課題のどこかに documenting という単語と完全に一致するものが含まれています。結果を他の属性で並べ替えても、指定された単語形式を含む課題のみを見つけることができます。

フレーズの検索

YouTrack は、フレーズとして引用符で囲まれた複数の用語の検索を処理します。フレーズ検索によって返される課題には、指定された順序で表示される、クエリで指定されたすべての単語に一致するフォームが含まれています。

フレーズにストップワードを入力すると、ワイルドカードであるかのように処理され、検索結果内の任意の単語に置き換えることができます。詳しくは、ストップワードを参照してください。

フレーズを指定したクエリの検索結果には、フレーズ内の各単語の形態変化が含まれます。特定のフレーズと完全に一致する課題を見つけたい場合は、次のいずれかを実行できます。

• フレーズを検索して、関連性の高い順に結果を並べ替えます。フレーズ内の単語と完全に一致する単語形式を含む課題は、リストの上位に表示されます。

• 各用語の間に AND 演算子を使用して、フレーズの各単語を目的の形式で指定するクエリを作成します。例: "documenting" AND "source" AND "code" フレーズにストップワードが含まれていない限り、この回避策はフレーズと完全に一致するものを見つけるのに役立ちます。

この対応策はすべての用語および句のための完全な一致をサポートしません。例: [i]++ のようなコード構成を含む課題を見つけたい場合は、検索結果に多くの一致は見つかりません。これは、このような文字列は索引付けされず、単語として解析されないためです。

テキスト属性

課題の概要、説明、コメント、添付ファイル名、コードブロック内の単語を検索するように検索を制限することができます。これらの属性はデータをテキストとして文字列として格納します。

テキスト属性を指定すると、クエリはテキスト検索として実行されます。指定された値に完全に一致するものを検索する代わりに、YouTrack は指定された属性に格納されているテキストの文字列内に一致する単語の形を含む課題を返します。

例: クエリ Subsystem: {Agile Board} は、サブシステムフィールドに値アジャイルボードが割り当てられている課題のみを返します。これは属性ベースの検索であり、完全一致のみを返します。クエリ description: "Agile Board" は、「アジャイルボード」という単語に一致するものを課題の説明のフレーズとして含む課題を返します。これはテキスト検索であり、指定された属性で一致する可能性のあるものを返します。結果には、「アジャイルボード」などの他のバリアントを含む説明の課題が含まれます。

次の属性を参照する検索クエリはテキスト検索として実行されます。

• 添付

• コード

• コメント

• description

• 概要

• work

補足テキストフィールドを参照するクエリもテキスト検索として実行されます。

関連性による並べ替え

テキスト検索を実行すると、結果は関連性によってソートできます。このソートオプションは、次の条件下で検索結果に適用できます。

• 検索クエリには、テキスト検索で解析される文字列が少なくとも 1 つ含まれています。これには、要約、説明、コメント、添付ファイル名、コード内のテキストの一致を検索する属性ベースの検索クエリが含まれます。

• 検索クエリには明示的な並べ替え属性が含まれていません。明示的な並べ替え属性は、関連性によるデフォルトの並べ替えをオーバーライドします。

• 検索クエリに OR 式が含まれていません。

この条件を満たす保存済み検索の結果は、関連性によってソートすることもできます。ただし、保存された検索にカスタムオーダーが保存されている場合、カスタムオーダーは関連性によるソートをオーバーライドします。

• 手動でオーダーされた課題は、カスタムオーダーに表示されます。

• 手動でオーダーされていない課題は、最後の更新によってソートされます。

通常、関連性はデフォルトのソート順として、テキストを検索するクエリの検索結果に適用されます。検索結果の順序を変えたい場合は、いくつかのオプションがあります。

• 属性のソートメニューを使用して、関連性による結果のソートをオーバーライドします。このメニューを開いて別の検索属性を選択するには、現在の並べ替え属性をクリックします。これにより、選択した並べ替え属性が明示的に現在のクエリに追加されます。

  明示的な並べ替え属性は、属性のソートメニューから削除するか、クエリ文字列から手動で削除することで破棄できます。明示的な並べ替え属性をすべて削除すると、検索結果は再び関連性によって並べ替えられます。

• YouTrack プロファイルのテキスト検索のデフォルトのソートを切り替えます。

  YouTrack プロファイルには、テキスト検索の結果を関連性でソートするか、最終更新でソートするかを選択できる設定があります。Updated に設定すると、それ以外の場合は関連性でソートされる結果が、最後の更新でソートされます。結果を関連性で並べ替えるオプションは使用できなくなりました。検索結果を関連性で並べ替えるには、この設定を相関に戻す必要があります。

  このオプションの主な目的は、ユーザーが関連性による並べ替えを無効にできるようにすることです。最終更新でソートしたいクエリや、関連性がより適切なクエリがある場合は、相関をデフォルト設定のままにして、検索に明示的なソート属性を追加して、必要に応じてこのソート順をオーバーライドすることをお勧めします。クエリ。

  YouTrack プロファイルの設定オプションの詳細については、一般的なプロファイル設定を参照してください。

現在検索結果に適用されている並べ替えオプションは、常に検索ボックスのすぐ下に表示されます。

関連性は、各号にある一致する語形の数に基づいています。issue summary の一致は、他の issue 属性の一致よりもわずかに高い重み付けがされています。説明、コメント、その他の issue 属性に複数の一致がある課題は、要約に 1 つの一致がある課題よりも関連性が高くなります。

関連性は、組み込みの機械学習モデルによってさらに強化されます。このモデルは、以下のような様々な特徴に基づいて課題をランク付けします。

• 新鮮さ。つまり、新しい課題には検索結果でより高いランキングが割り当てられます。

• 人気度が高いため、コメントや投票数の多い課題は、あまり注目されていない課題よりも上位にランク付けされます。

• パーソナライゼーションとは、過去にやり取りした課題が、あなたの作業にとってより関連性が高いとみなされることを意味します。

テキスト検索のワイルドカード

ワイルドカードを 1 つ以上の文字のプレースホルダーとして使用できます。

• * — 文字列内の 0 個以上の文字に一致します。単語の先頭または末尾に配置すると、検索では、接頭辞または接尾辞がそれぞれ付いている単語の一致が返されます。

  例: *view を検索すると、view、review、overview、preview、purview などの単語を含む課題が返されます。

  このワイルドカードは、属性ベースの検索の値の最後に使用することもできます。詳細については、属性ベースの検索のワイルドカードを参照してください。

• ? — 文字列内の任意の 1 文字と一致します。このワイルドカードは、テキスト属性の検索にのみ使用できます。フィールドに値が string タイプとして格納されている場合でも、このワイルドカードを使用してカスタムフィールドの値を検索することはできません。

任意の単語の先頭、中間、末尾にワイルドカードを使用できます。

ストップワード

YouTrack のデフォルト言語として英語を使用している場合、検索クエリが処理される前に除外される一般的な単語がいくつかあります。これらはストップワードと呼ばれます。これらの単語は、クエリのパフォーマンスを向上させるために削除されています。ストップワードは次のように処理されます。

• ストップワードを単一の検索語として使用しても、無視されます。

• フレーズにストップワードを入力すると、ワイルドカードであるかのように処理され、検索結果内の任意の単語に置き換えることができます。

• 検索結果でストップワードはハイライトされません。

次のストップワードは YouTrack によって無視されます。

検索結果

テキスト検索を使用すると表示される課題のリストでは、クエリで指定された単語に一致するすべての単語形式がハイライトされます。

フレーズを検索すると、クエリは各単語のフォームを含む課題のみを指定された順序で返します。指定された単語のいずれかに一致する単語フォームが結果でハイライトされます。一見すると、検索があなたの質問に一致しない課題を返したと思うかもしれません。ただし、各号を開くと、その号には検索条件に一致する一連の単語が含まれていることがわかります。

テキスト検索で課題が多すぎる場合は、追加の検索パラメーターを使用して、結果を特定のプロジェクト、サブシステム、課題の種類に限定します。結果を制限して、要約、説明、コメントにのみテキストを含む課題を表示することもできます。

ステミング

YouTrack で使用する言語でテキスト索引が有効になっている場合、関連する単語は共通の語幹にマッピングされます。YouTrack でテキストを検索すると、検索クエリに入力したすべての形式の単語を含む課題が返されます。たとえば、検索クエリ description: {search attribute} は、説明に 'search' または 'attribute' という単語が含まれる課題だけでなく、'searches' , 'searched' , 'searching' , 'attributes' , 'attribution' など、他の形式の単語が含まれる課題も返します。この機能を使用すると、完全に一致する単語のみが結果に含まれる場合に除外される可能性のある課題を見つけることができます。

テキストの索引付けは、すべてのデフォルト言語に対して自動的に有効になります。これは、YouTrack でそのまま提供される言語のいずれかでテキストの文字列を格納するすべての課題属性に対してステミングが有効になることを意味します。英語の場合、テキストの索引付けを無効にすることはできません。

詳しくは、検索に最適化された言語を参照してください。

トークン化

YouTrack は、テキスト文字列の各単語をトークンに分割します。英字または数字のすべての連続した文字列は、1 つのトークンの一部です。複数の単語を検索すると、クエリはトークンの文字列として解釈されます。

• 単語が中括弧で囲まれている場合、各トークンは別々に評価されます。検索結果には、クエリ内の任意のトークンに一致する任意の単語を含むすべての課題が含まれています。

• 単語が引用符で囲まれている場合、トークンはシーケンスとして評価されます。検索結果には、指定された順序ですべてのトークンと一致する単語を含む課題のみが含まれます。

YouTrack は、検索で指定されたトークンに対応する単語を含む issue を返します。課題のテキストは単語に分割されています。空白と句読点は、単語の始まりと終わりを決めるために使用されます。ピリオドとアンダースコアも区切り文字として認識されます。

ファジー検索

正確なパターンではなく近似パターンに一致する単語を見つけるには、あいまい検索を使用します。あいまい検索では、検索クエリで指定された単語から数文字以内の単語が検索されます。このテクニックを使用すると、スペルの誤り、単語の一部、名前のわずかな違いなどを考慮できます。

例: 検索クエリ comments: {michael~} は、コメントに Michael という名前だけでなく、Mikhail のような他のスペルも含む課題を返します。

通常、あいまい一致では、無関係な一致が多数返されます。このオプションは、検索している単語のスペルが間違っている可能性が高いことがわかっている場合にのみ使用してください。