Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020
クエリを使用して、指定したフィールド条件に基づいてバグ、ユーザー ストーリー、またはその他の作業項目を一覧表示します。 チームはこれらのリストを実行して、作業のトリアージ、アイテムの一括更新、階層の確認を行います。 セマンティック検索では、探索する価値のある重複する補完的な機能が提供されます。
マネージド クエリを使用して次の手順を実行します。
- Web ポータルを使用して作業項目を一括更新する
- 作業項目をトリアージおよび更新する
- 作業項目の階層を確認する
- 作業項目の一覧をチームメイトと共有する
クエリとクエリ フォルダーは、Web ポータルまたは Visual Studio チーム エクスプローラーから作成できます。 1 つのクライアントで行った変更は、すべての変更が作業追跡データ ストアに格納されるため、他のクライアントに表示されます。
クエリの使用を開始する
作業項目のクエリを始めたばかりなら、作業項目クエリの表示、実行、または電子メール送信を読みます。 クエリ エディターのタスクとサンプル クエリのクイック リファレンスについては、「クエリのクイック リファレンス」を参照してください。
- 割り当てられた作業項目を検索するには、句の [割り当て先] フィールドの値として @Me マクロを使用します。
- 標準アクセス権を持つすべての有効なユーザーは、[ マイ クエリ] の下にクエリとフォルダーを作成できます。 [共有クエリ] でクエリまたはフォルダーを作成するには、投稿アクセス許可が必要です。 クエリに対するアクセス許可の設定を参照してください。
- 製品領域、イテレーション、または別のフィールドに焦点を当てる条件を追加して、クエリを変更します。 クエリを変更するには、 クエリ エディターを開きます。
- Excel でクエリを開き、フィールドを更新し、データベースに変更を発行します。
- フラット リスト クエリの円グラフ、列グラフ、または傾向グラフを作成して、状態または進行状況を視覚化します。 詳細については、「 グラフ」を参照してください。
クエリ機能
次のセクションでは、作業項目クエリの定義と管理に使用する関数の概要を示します。
- クエリ エディターを使用してクエリ フィルターを定義します。
- 句でクエリ マクロを使用して、フィールドを動的に対象とします。
- [クエリ結果] ページからクエリの結果とフォルダーを管理します。
クエリ フィルター
次の表は、各 Azure DevOps バージョンでサポートされているクエリ フィルター関数をまとめたものです。
Note
マネージド クエリでは近接検索はサポートされていませんが、セマンティック検索ではサポートされます。 さらに、セマンティック検索では * と ? の両方がワイルドカード文字としてサポートされており、複数のワイルドカード文字を使用して複数の文字を照合できます。 詳細については、「機能作業項目の検索」を参照してください。
フィルター関数
クエリのサポート
サポートされているバージョン
テキスト文字列検索 (単一テキスト、複数行テキスト、リッチ テキスト)
検索では、大文字と小文字が区別されません。
すべてのバージョン
ワイルド カード = *
すべてのバージョン
ダイレクト リンクまたはトポロジ/階層リンクの種類に基づいて、作業項目を検索します。
MODE (WIQL 構文) に基づいて、リンクされた作業項目をフィルター処理します
すべてのバージョン
AND および OR ブール演算子を使用して、句をグループ化および入れ子にします。
すべてのバージョン
フィールドの一致と以前の値に基づいて作業項目を検索します。
サポートされている演算子: Was Ever 特定の日付に定義された値に基づいて作業項目を検索します。
サポートされている演算子: ASOF (WIQL 構文)
すべてのバージョン
マクロを使用して、日付やその他のツール (チーム区分パス、チーム イテレーションなど) に基づいたクエリを作成します。
すべてのバージョン
組織またはコレクション内の 1 つ以上のプロジェクトの作業項目を検索します。 既定値は、現在のプロジェクトです。 [チーム プロジェクト] フィールドを使用すると、2 つ以上のプロジェクトに対してクエリを実行できます。
すべてのバージョン
2 つのフィールドの比較に基づいて作業項目を検索します。
サポートされている演算子: =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
すべてのバージョン
タグが含まれているか含まれていないかに基づいて作業項目を検索します。
サポートされている演算子: Contains, Does Not Contain
すべてのバージョン
空または空ではない HTML/リッチ テキスト フィールドに基づいて作業項目を検索します。
サポートされている演算子: Is Empty, Is Not Empty
すべてのバージョン
区切られたセット内の任意の値とフィールド値が一致する作業を検索します (一連の作業項目の種類、ワークフローの状態、選択リスト値など)。 値は、クライアント コンピューターに定義されている地域設定に対応するリスト区切り記号で区切ります。 たとえば、コンマ (,) を使用できます。
すべてのバージョン
ブール型フィールド値に基づいて作業項目を検索します。
すべてのバージョン
ディスカッションを通じて追加されたキーワードまたはフレーズに基づいて作業項目を検索します。
すべてのバージョン
列、スイムレーン、または完了/完了状態に基づいて作業項目を検索します。
すべてのバージョン
キーワードまたは選択フィールドに基づいてクエリ結果をフィルター処理します。
すべてのバージョン
クエリ句の一括移動、コピー、貼り付けを行うには、 WIQL エディターをインストールして使用します。
サポートされているマクロ
次の表は、Azure DevOps バージョンでサポートされているクエリ マクロまたは変数をまとめたものです。 これらのマクロの一部を使用して、通知をフィルター処理できます。
Note
特定のマクロは、Web ポータルからのみ使用できます。 これには、 @CurrentIteration、 @CurrentIteration +/- n、 @Follows、 @MyRecentActivity、 @RecentMentions、 @RecentProjectActivity、および @TeamAreas マクロが含まれます。 これらのマクロは、クエリを Excel にエクスポートしたり、通知フィルターをエクスポートしたり、チーム エクスプローラーまたは REST API から実行したりする場合にはサポートされません。
詳細な説明と例へのリンクについては、「クエリ フィールド、演算子、マクロ」を参照してください。
マクロ
クエリのサポート
サポートされているバージョン
任意の作業項目の種類 (Work Item Type=[Any])、または任意の状態 (State=[Any]) を検索します。
すべてのバージョン
Identity field=logged in user に一致する作業を検索します。
すべてのバージョン
Date-Time field=today に一致する作業を検索します。
すべてのバージョン
1 つ以上のプロジェクトで定義されている作業を検索します。
すべてのバージョン
チームの現在のイテレーションで定義されている作業を検索します。
すべてのバージョン
チームの現在のイテレーションで定義されている +/- n を検索します。
すべてのバージョン
現在ログインしているユーザーがフォローしている作業 (ID In @Follows) を検索します。
すべてのバージョン
最近変更された作業項目を検索します (ID In @MyRecentActivity)。「[作業項目] ページを使用して作業項目を表示および追加する」も参照してください。
すべてのバージョン
選択した日時フィールドが現在の日、月、週、または年内にある作業を、プラス/マイナスのオフセットを使用して検索します (例: Closed Date>=@StartOfDay-7)。
すべてのバージョン
指定したチームの区分パスまたはイテレーション パスに割り当てられている作業を検索します。例については、「区分またはイテレーション パスによるクエリの実行」を参照してください。
すべてのバージョン
クエリ結果とクエリ管理機能
次の機能は、クエリ結果の操作、クエリの保存と共有などをサポートするものです。
-
クエリ グラフをダッシュボードに追加する
-
対話型フィルターを適用する
-
列の並べ替えを選択する
-
クエリ列のオプションを選択する
-
クエリ結果をコピー
-
クエリ URL をコピー
-
クエリ グラフを作成する
-
クエリ フォルダーを作成する
サポートされていない機能
クエリは、作業項目と他の作業項目にリンクされた作業項目のみをサポートします。 マネージド クエリでは、次の機能はサポートされていません。
- テスト 計画、テスト スイート、およびテスト ケースの階層ビュー (これらの項目では親子リンクは使用されません)。 代わりに、[Test > Test Plans]\(テスト プラン\) ページで階層を表示します。
- ビルド、リリース、コード、その他の作業項目以外のオブジェクトなどのリンク オブジェクトを表示するビュー。
- あるプロジェクトから別のプロジェクトにリンクされている作業項目を一覧表示します。
- プロジェクト間クエリを Excel にエクスポートします (直接リンク クエリはフラット リストとしてエクスポートされます)。
クエリの種類 (フラット、ダイレクト リンク、ツリー)
Azure Boards では、3 種類のクエリがサポートされています。クエリの横にあるアイコンは、その種類を示します。 必要な結果に基づいて種類を選択します。
[クエリの種類]
使用ガイダンス
作業項目の単純なリスト
- 一括更新を実行するアイテムを一覧表示する
- 作業項目の一覧をトリアージする
- クエリ グラフを作成してダッシュボードに追加する
- アイテムをカウントしたり、数値フィールドを合計したりするグラフを作成する
- Excel にリストをエクスポートしてフィールドを更新する
作業項目とダイレクト リンク
- 他の作業項目に依存するリストの項目
- 関連アイテムまたは依存アイテムを検索する
- リンクされた作業項目を一覧表示して一括更新を実行する
- テスト関連のリンクを含む、リンクされた作業項目をトリアージする
- 孤立したバックログ項目を検索する (親のないアイテム)
Note
作業項目とダイレクト リンク のクエリは、フラット リストとして Excel にエクスポートされます。 Excel では複数のリンクの種類の変更がサポートされていないため、フラット リストとしてインポートされます。
作業項目のツリー
- Parent-Child 関連する作業項目またはその他のツリー トポロジ リンクの種類のツリーを一覧表示する
- 作業項目のトリアージ用階層リスト
- 階層リストを Excel にエクスポートしてフィールドを更新したり、階層を変更したりします
リンクの種類について詳しくは、「リンクの種類のリファレンス」を参照してください。
マイ クエリ、共有クエリ、お気に入り
[マイ クエリ] の下に保存されたクエリを表示して実行できるのは、あなただけです。 お気に入りのクエリをクエリ セレクターに表示します。
[共有クエリ] の下に保存されたクエリは、プロジェクト アクセス権を持つすべてのユーザーに表示されます。 共有クエリをフォルダーに整理し、すばやくアクセスできるようにお気に入りに追加します。 フォルダーとクエリに対するアクセス許可を設定して、他のユーザーが移動または編集できないようにすることができます。
詳細については次を参照してください:
クエリ ディレクトリ、クエリ フォルダー、階層リンク
[ クエリ] ページには、[お気に入り] タブと [すべてのタブ] タブがあります。 各タブには、特定のクエリを検索するためにフィルター処理できるディレクトリ ビューが表示されます。
[クエリ] ページ内を移動すると、フォルダー、サブフォルダー、またはクエリ ページを開くことができます。
選択すると、ページの上部にパンくずリストが表示されます。 フォルダー、サブフォルダー、またはクエリ ページに移動するために使用します。
開いているクエリのドロップダウン メニューから、お気に入りのクエリを選択することも、すべてのクエリのページに戻ることもできます。
詳しくは、 クエリに関する FAQ、移動、フォルダーに関する記事を参照してください。
クエリのグラフとウィジェット
フラット リスト クエリから円グラフ、棒グラフ、ピボット グラフ、傾向グラフを作成します (クエリは 1,000 個以下の作業項目を返す必要があります)。 クエリ グラフをダッシュボードに追加し、それらを再タイトルし、必要に応じて再構成します。
クエリベースのウィジェットは、ダッシュボードにクエリ情報 (アクティブなバグの数や作業項目の対話型リストなど) を表示します。 詳細については、以下をご覧ください。
クエリをサポートするためのカスタム フィールドを追加する
クエリのユーザー設定フィールドを追加するには、「 作業追跡エクスペリエンスをカスタマイズする」を参照してください。
タスクボードとクエリ リストの項目
タスクボードの内容が作成されたクエリの結果と異なる場合は、「 タスクボードアイテムとクエリリストアイテム 」を参照してください。
フルテキスト検索のクエリと照合順序設定
Contains 演算子または Contains Words 演算子でフルテキスト検索クエリを使用する場合は、SQL Server の照合順序が登録済みのワード ブレーカーを持つ言語に対応していることを確認します。 サポートされていない言語では、予期しない結果が生じる可能性があります。
詳細については次を参照してください:
REST API
プログラムでクエリを操作するには、次の REST API リソースのいずれかを参照してください。