次の方法で共有


セマンティック作業項目検索を実行する

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

作業項目を検索するには、ショートカット フィルターを使用したり、キーワードまたは語句を指定したりできます。 また、特定のフィールド/フィールド値、割り当てまたは日付の変更、Equals演算子, Contains演算子, そしてNot演算子を使用することもできます。 検索では大文字と小文字は区別されません。 セマンティック検索を使用して、次のタスクを実行します。

  • ID またはキーワードを使用して特定の作業項目を検索する
  • すべてのプロジェクトで 1 つ以上の作業項目を迅速かつ柔軟に検索する
  • すべての作業項目フィールドでフルテキスト検索を実行する
  • 特定のチーム メンバーに割り当てられた作業項目を確認する
  • 特定の作業項目フィールドを検索して作業項目の一覧をすばやく絞り込む
  • マネージド検索をサポートするキーワードを決定する

[前提条件]

  • アクセス レベル: すべてのプロジェクト メンバー: すべてのプロジェクト メンバーは、利害関係者、基本、および上位のアクセス レベルを持つユーザーを含む検索機能を使用できます。
  • 検索結果:
    • アクセスベースの結果: 組織全体またはコレクションを検索すると、プロジェクト メンバーがアクセスできる結果のみが一覧表示されます。
    • 利害関係者の制限事項:
      • Wiki 検索: 利害関係者 Wiki の検索結果は、プロビジョニングされた Wiki に限定されます。 公開された Wiki の結果は、利害関係者にはない通常のリポジトリにアクセスする必要があるため、表示されません。
      • コード検索: コード検索結果は利害関係者には表示されません。

ヒント

セマンティック検索を構成すると、次の図に示すように、検索ボックスが青いバーに移動します。

[作業項目の検索] テキスト ボックス

作業項目のセマンティック検索を開始する

セマンティック検索では、次の情報を検索できます。

  • 1 つ以上のプロジェクトが対象
  • フリー テキストを使用し、すべての作業項目フィールドが対象
  • 特定の作業項目フィールドが対象

フリー テキスト検索では、ユーザー設定フィールドを含むすべての作業項目フィールドが検索されるため、より自然な検索が行えます。 検索の一致が強調表示されているスニペット ビューに検索結果が表示されます。 セマンティック検索は作業項目の追跡と統合され、作業項目フォーム内で情報を表示、編集、コメント、共有するための使い慣れたコントロールが提供されます。

  1. ボード ページを選択し、検索ボックスにキーワードまたは語句を入力し、Enter キーを押すか、検索開始アイコン選択します。

    作業項目検索ボックス

  2. システムは検索結果をスニペットビューで表示し、見つかった一致部分が太字で示されます。

    検索結果

    この検索は、単語または語句を探す単純な検索文字列を使用するフルテキスト検索です。 作業項目検索は、検索用語の派生形と一致します。たとえば、"updating" を検索すると、"updated" と "update" という単語が見つかります。検索は大文字小文字を区別しません。

  3. 作業項目のスニペットを選択し、右側のウィンドウに表示します。

    検索ボックスから新しいブラウザー タブで検索結果を開くには、Ctrl + Enter キーを押すか、Ctrl キーを押したまま、検索開始アイコン アイコンをクリックします。 Google Chrome で、Ctrl + Shift + Enter キーを押して、フォーカスを新しいブラウザー タブに切り替えます。

セマンティック検索結果を微調整する

  1. 検索するフィールドを指定して、検索を微調整します。 a:とユーザー名を入力して、そのユーザーに割り当てられているすべてのアイテムを検索します。

    タイトル バーからの検索

    使用できるクイック フィルターは次のとおりです。

    • a:割り当て先:
    • c: 作成者:
    • s: 状態
    • t: (作業項目の種類)
  2. 作業項目のフィールド名の入力を開始します。たとえば、「ta」と入力します。

    入力時のクイック フィルター

    ドロップダウン リストには、ユーザー入力に一致する作業項目フィールド名の候補が表示され、ユーザーが検索を迅速に完了するのに役立ちます。 たとえば、 tags:Critical などの検索では、"重大" というタグが付いたすべての作業項目が検索されます。

  3. フィルターを追加して検索をさらに絞り込み、必要に応じてブール演算子を使用して用語を結合します。 たとえば、 a: Chris t: Bug s: Active は、"Chris" という名前のユーザーに割り当てられているすべてのアクティブなバグを検出します。

  4. 結果ページの上部にあるドロップダウン セレクター リストを使用して、検索を特定の種類と状態に絞り込みます。

::: moniker-end

Web ポータルから

Azure DevOps Services から即席の検索を使用することはできません。 セマンティック検索のみを使用できます。

Visual Studio チーム エクスプローラーから

コンテキスト メニュー アイコン コンテキスト メニューを開き、オプションを選択します。

[検索] ボックス メニュー (チーム エクスプローラー)

検索ボックスを使用した作業項目の検索 (チーム エクスプローラー)

検索テキスト ボックスを使用した作業項目の検索

検索ボックスでは、複数のショートカットを組み合わせたり、検索演算子を使用したりできます。

検索ボックスの内容を削除するには、検索ボックスの [クリア] アイコン (チーム エクスプローラー)[クリア] ボタンを使用します。 Visual Studio 内からコンテキストを検索ボックスに切り替えるには、 Ctrl キーを押しながら' キーを押します。

キーワードまたは語句による項目の検索

検索ボックスにキーワードまたは語句を入力すると、それらのキーワードや語句を [説明][ステップの再現]、または [タイトル] フィールドに含む作業項目の一覧が返されます。 それぞれの語句は引用符で囲みます。

[作業項目の検索] ボックスに、目的の作業項目の [タイトル][説明]、または [ステップの再現] フィールドに含まれるキーワードや語句を入力します。

複数の単語は引用符で囲みます。

たとえば、[タイトル] または [説明] フィールドに指定したキーワードが含まれる作業項目を検索するには:

  • "duplication" というキーワードの場合は、「duplication」と入力します。
  • "Getting Started" という語句の場合は、「"Getting Started"」と入力します。
  • "Getting Started" という語句または "feature" というキーワードの場合は、「feature "Getting Started"」と入力します。
次のキーワードまたは語句を含む項目のフィルター処理: 次の文字列を入力:
Duplication duplication
はじめに "Getting Started"
機能および概要 feature "Getting Started"

任意のテキスト フィールドに含まれているキーワードや語句に対して、部分または完全一致のクエリを実行できます。 または、フルテキスト検索インデックスに含まれているキーワードや語句でフィルター処理することで、フルテキスト検索クエリを実行できます。 Team Foundation は、PlainText データ型と HTML データ型のすべての long-text フィールドと、Title フィールドに対して、フルテキスト検索用のインデックスを自動的に作成します。

特定のフィールドおよびフィールド値による項目の検索

他のテキスト文字列フィールドに含まれているキーワードや語句に基づいて作業項目を検索するには、フィールドのフレンドリ名または参照名を指定します。 それぞれの語句は引用符で囲みます。 作業項目フォームでフィールドの上にマウス ポインターを置くと、フィールドのフレンドリ名を確認できます。 よく使用されるフィールドの参照名を確認したり、フォームに表示されていないフィールドを見つけるには、「作業項目フィールドのインデックス」を参照してください。

次の条件を満たす項目のフィルター処理: 次の文字列を入力:
添付ファイルが 1 つ含まれる。 System.AttachedFileCount=1
分割されたユーザー ストーリー。 T:Story Reason=Cut
または
T="User Story" System.Reason=Cut
解決者が Peter である。 "Resolved By":Peter
または
Microsoft.VSTS.Common.ResolvedBy:Peter
今日変更された。 "Changed Date"=@Today
テスト動作として昨日作成された。 "Created Date"=@Today-1 Activity=Test

Note

履歴説明などの一部のフィールドでは、部分的な単語テキスト検索がサポートされていません。 たとえば、[ 履歴 ] フィールドに reproducible behavior 語句が含まれており、 History:reproを検索した場合、作業項目は見つかりません。 ただし、完全な文字列 History:reproducibleを検索すると、作業項目が見つかります。

@Me または @Today マクロを使用する

@Me マクロは、作業項目の検索時に現在のユーザーのフル ネームに展開されます。 @Me マクロは、他のユーザーと共有できる検索を作成する場合に特に役立ちます。また、自分のユーザー名を指定するときに入力する文字数を減らすことができるので、作業を簡略化できます。 すべてのマクロの説明については、クエリ フィールド、演算子、マクロ、クエリのマクロまたは変数に関するページを参照してください。


フィルターの対象

次の文字列を入力


現在自分に割り当てられている

A=@Me


作成者が自分である。

C=@Me


昨日解決された

Resolved Date=@Today-1


7 日前に変更された

System.ChangedDate=@Today-7


Phone Saver チームによって昨日作成された

Created Date=@Today-1 And Area Path=FabrikamFiber\Phone Saver


Equals、Contains、および Not 演算子を使用する

次の検索演算子を使用して検索条件を指定します。

= (EQUALS) は、テキストの完全一致を検索します。
: (CONTAINS) は、テキストの部分一致を検索します。
- (NOT) は、特定のテキストを含む作業項目を除外します。 NOT 演算子は、フィールド名でのみ使用できます。

検索文字列の作成時に演算子を使用する方法の例を次に示します。

次の条件を満たす項目のフィルター処理: 次の文字列を入力:
担当者が Peter で、アクティブでない。 A:Peter -S=Active
[アクティビティ] フィールドが Development でなかった。 - Activity=Development
解決者が Peter である。 "Resolved By":Peter
タイトルまたは説明に triage というキーワードを含み、担当者が自分ではなく、終了していない。 triage -A=@me -S=Closed
アクティブなバグであり、担当者が自分であり、タイトルに bugbash というキーワードを含まない。 S=Active T=bug A=@Me -Title:bugbash

FAQ

Q: 検索ボックスでは、小なり/大なり演算子をサポートしていますか?

A: いいえ。 検索ボックスでは、より大きい (>) や、より小さい (<) のような比較演算子は認識されません。 これらの演算子を使ったクエリは、検索語句に変換されます。