作業項目クエリを定義する

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Azure Boards の作業項目クエリでは、指定したフィルター条件に基づいて作業項目のリストが生成されます。 これらのマネージド クエリを保存して他のユーザーと共有できます。

この記事の後半で、推奨される ベスト プラクティスをご確認ください。

前提条件

クエリ フィルターを選択する

クエリ エディターから、サンプル クエリが含まれる記事にジャンプするためのフィルターを選択します。 クエリ フィルターに加えて、 クエリ結果にフィルターを対話的に適用できます。

[フィルター] 機能を使用して、クエリを対話的にフィルター処理することもできます。

クエリを開く

フラット リスト クエリを定義する

新しいクエリは、Web ポータルの [クエリ] タブまたはチーム エクスプローラーの [作業項目] タブから開始します。

プロジェクト間またはプロジェクト内でクエリを実行する

新しいクエリは、既定では、現在のプロジェクトにスコープが設定されています。 しかし、組織またはプロジェクト コレクション内で定義されている作業項目を検索するクエリを作成できます。 しかし、保存したすべてのクエリは、特定のプロジェクトに保存されます。

句を定義する

クエリを作成するには、1 つまたは複数の句を定義します。 各句では、1 つのフィールドのフィルター条件を定義します。

サンプルのクエリ句

フィールド データ型に基づく使用可能な演算子の一覧については、 クエリ インデックスのクイック リファレンスに関する記事を参照してください。

すべての句は、 And ステートメントとして追加されます。 グループ化を変更するには、 [Or] を選択します。 句のステートメントが必要なシーケンスで確実に実行されるように、句をグループ化します。

クエリ句を定義するためのチェックリスト

1. 最初の空白行の [フィールド] 列見出しで、下向きの矢印をクリックして使用できるフィールドを表示し、一覧から項目をクリックします。 詳細については、「クエリ フィールドと値」を参照してください。

2. 同じ行の [演算子] 列見出しで、下向きの矢印を選択して使用できる演算子のリストを表示し、リストで項目を選びます。 詳細については、「演算子」を参照してください。

3. 同じ行の [値] 列見出しで、値を入力するか、下向きの矢印を選択し、リストで項目を選びます。 マクロまたは変数を使用して現在のプロジェクト、ユーザー、日付、またはその他の選択項目を指定する方法の詳細については、「変数」を参照してください。

4. 句を追加するには、 [新しい句の追加] 選択します。

   クエリの末尾に句を追加することも、対応するアイコンを使用して次のタスクを実行することもできます。

   • 新しいフィルター行を挿入
   • フィルター行を削除
   • 選択した句のグループ化
   • 句のグループ解除

作業項目ツリーを使用して階層を表示する

[作業項目のツリー] クエリを使用して、作業項目のリストを入れ子になった多層のリストとして表示できます。 たとえば、すべてのバックログ項目と、それらにリンクされたタスクを表示できます。 ツリーのさまざまな部分に注目するには、 [すべて展開] または [すべて折りたたむ] を選択します。

ダイレクト リンクを使用して依存関係を表示する

タスク、バグ、イシュー、フィーチャーなど、追跡対象となっている他の作業に依存する作業項目を追跡するには、 [作業項目とダイレクト リンク] クエリを使用します。 たとえば、実装中の他の項目や修正中のバグに依存するバックログ項目を表示できます。

チーム間の依存関係を追跡するには、ダイレクト リンク クエリを使用します。 このクエリは、チームが行うコミットメントを管理するのにも役立ちます。 最上位およびリンクされた作業項目のフィルター条件を選択してください。 また、依存関係をフィルター処理するリンクの種類を選択してください。

各リンクの種類の詳細については、 リンクの種類のリファレンスに関するページを参照してください。

AND/OR 論理式を使用する

クエリ句の論理式を作成するには、 And または Or を指定します。 現在の句と前の句の両方の条件を満たす作業項目を検索するには、 And を使用します。 現在の句か前の句のいずれかの条件を満たす作業項目を検索するには、 Or を使用します。

作業項目フィールドごとに 1 つの新しい句を追加して、検索条件を絞り込みます。 必要な作業項目のセットのみが返されるように句を追加します。 クエリで期待どおりの結果が得られない場合は、対象を絞り込みます。 クエリ句を追加、削除、グループ化、またはグループ解除することで、クエリの結果を改善できます。

クエリ句をグループ化すると、それらはクエリの残りの部分とは別の 1 つのユニットとして動作します。 句のグループ化は、数学の方程式や論理式の一部をかっこで囲むのと似ています。 句をグループ化すると、グループ内の最初の句の And または Or がグループ全体に適用されます。

句のグループ化

グループ化されたクエリ句は、クエリの残りの部分とは別の 1 つのユニットとして動作します。 句のグループ化は、数学の方程式や論理式の一部をかっこで囲むのと似ています。 グループ内の最初の句の And または Or 演算子は、グループ全体に適用されます。

次の例に示すように、グループ化された句は対応する論理式に変換されます。

クエリ	グループ化された句	論理式
1
2
3

これらのクエリは、種類が Bug で、次の論理式を満たす作業項目を返します。

• クエリ 1: AND State=Active OR Assigned to @Me
• クエリ 2: AND (State=Active OR Assigned to @Me)
• クエリ 3: OR (State=Active AND Assigned to @Me)

1 つまたは複数の句をグループ化するには、それらを選び、 (句のグループ化) アイコンを選択します。

複数のグループ化された句をグループ化することもできます。 各句のチェック ボックスをオンにしてください。 その後、 (句のグループ化) アイコンを選択します。

クエリ結果で期待される結果が返されない場合は、次の手順を行います。

• それぞれの句が意図したとおりに定義されていることを確認します。
• 各句の And/Or 割り当てを確認します。 予期していた数よりも多くの作業項目が結果に含まれるときは、多くの場合、 Or 句ではなく And 句が存在します。
• クエリ句をグループ化するか、クエリ句のグループとグループ化されたそれぞれの句の And/Or の割り当てを変更する必要があるかどうかを判断します。
• クエリ句をさらに追加し、クエリのフィルター条件を絞り込みます。
• フィールド、演算子、および値を指定するためのオプションを確認します。
• この記事の後半の ベスト プラクティスを参照してください。

句のグループ解除

句のグループ化を解除するには、グループ化された句の (句のグループ解除) アイコンを選択します。

クエリ結果の既定の列幅を設定する

クエリ結果の既定の列幅を設定するには、次の手順を実行します。

1. 変更するクエリを開きます。
2. 列ヘッダーの端をドラッグすることにより、手動で列幅を目的のサイズに調整します。
3. 新しいクエリとして保存する場合は、 [保存] または [名前を付けて保存] を選択します。
4. クエリを閉じて再度開き、列幅が保持されていることを確認します。

現在、Azure DevOps では、すべてのセッションにわたって保持される既定の列幅の設定はサポートされていません。 列幅はクエリごとに保存されるため、クエリごとに個別に調整して保存する必要があります。

ダッシュボードでクエリ結果を表示する

クエリ結果は、次の 2 つのウィジェットで表示されます。 作業項目は、これらのウィジェットから直接開くことができます。

• 自分に割り当てられた作業: サインインしているユーザーに割り当てられている提案済みまたはアクティブな作業項目をすべて一覧表示します。 [ID]、[状態]、および [タイトル] の各フィールドが一覧表示されます。
• クエリ結果ウィジェット: フラット、ツリー、またはダイレクト リンクのクエリの結果を表示します。 ウィジェットを通じて表示されるフィールドを構成したり、列フィールドのサイズを変更したり、ツリー クエリやダイレクト リンク クエリを展開したり折りたたんだりすることができます。

詳細については、「ダッシュボードにウィジェットを追加する」を参照してください。

クエリをハイパーリンクとして定義する

クエリ ハイパーリンクでは作業項目クエリ言語 (WIQL: Work Item Query Language) が使用されます。これは Transact-SQL に似ています。 詳細については、「作業項目クエリ言語 (WIQL) の構文」を参照してください。

https://dev.azure.com/OrganizationName/ProjectName/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

https://dev.azure.com/fabrikam/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.State%5D%3D'Active'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'

SELECT [System.ID], [System.Title]
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug'
   AND [System.State]='Active'
   AND [System.AreaPath]='FabrikamFiber\Web'

https://{ServerName}/{CollectionName}/{ProjectName}/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%2C%20%5BSystem.State%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'%20%20

http://fabrikam:8080/tfs/DefaultCollection/FabrikamFiber/_workitems?_a=query&wiql=
SELECT [System.ID], [System.Title], [System.State] 
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug' 
   AND [System.AreaPath]='FabrikamFiber\Web'   

ベスト プラクティス

次のベスト プラクティスは、作成できる以下のクエリに適用されます。

集中型で選択的なクエリを作成する

クエリに必要なすべてのフィルターを適用して、選択性の高いクエリを定義します。 クエリの選択性が高ければ高いほど、結果セットは小さくなります。 結果セットが小さくなればなるほど、クエリの対象が絞られ、選択性が高まります。

タグを使って作業項目を分類する

カスタム フィールドではなく、 作業項目タグ を使って作業項目を分類します。 タグでフィルター処理するクエリは、通常、文字列の一致でフィルター処理するクエリよりも高速に実行されます。

カスタム フィールドの一致や部分一致とは異なり、 Tags Contains 操作によるクエリは、すべての作業項目テーブルの完全なスキャンは必要ありません。

文字列の一致に Contains words を使う

文字列の一致でフィルター処理するには、 Contains 演算子ではなく Contains Words を使います。 Contains Words 演算子は、指定されたフィールドの全文検索を実行し、より速く完了する傾向があります。

Contains 演算子ではテーブル スキャンが実行され、処理は Contains Words 演算子の場合よりも遅くなります。 また、より多くの CPU サイクルを消費します。 これらの CPU サイクルにより、レート制限が発生する可能性があります。 詳細については、「レートと使用量の制限」を参照してください。

In Group 演算子で小さなグループを指定する

In Group 演算子は、値のグループ内の一致に基づいて作業項目をフィルター処理します。 値のグループは、チーム、セキュリティ グループ、または 作業追跡カテゴリに含まれる値に対応します。 たとえば、チームのメンバーに割り当てられているすべての作業項目を検索するクエリを作成できます。 または、要件カテゴリ (Microsoft.RequirementCategory) に属するすべての作業項目を検索します。

多数のメンバーを含むグループでフィルター処理すると、結果セットが大きくなり、非選択的になる傾向があります。 また、グループが大規模な Microsoft Entra グループに対応する場合、クエリでは Microsoft Entra ID からそのグループを解決するためにかなり大きなコストが発生します。

否定演算子の使用を避ける

<>, Not In, Not Under, Not In Group などの否定演算子では、非選択的なクエリや大きな結果セットが生成される傾向があります。

必要な場合にのみ、否定演算子を使用します。 常に、最初に代替案を見つけるようにします。 たとえば、 Field1 に値 A、 B、 C、 D がある場合、 Field1 <> D 句を否定する代わりに、 Field1 In A, B, C 句を指定します。

文字列比較を避ける

文字列比較を含むクエリでは、本質的に非効率的なテーブル スキャンが生成されます。 特にクエリのパフォーマンスが低い場合は、タグや特定のカスタム フィールドを代わりに使うことをお勧めします。

Or 演算子を制限する

クエリで定義される Or 演算子の数を制限します。 クエリは、 Or 演算子を使う数が少ないほど、うまく動作します。 Or 演算子が多すぎると、クエリが非選択的になる可能性があります。 クエリの実行速度が遅い場合は、 Or 演算子句をクエリ句の先頭に並べ替えます。

クエリを保存する

内部最適化により、保存したクエリは保存していないクエリよりもパフォーマンスが向上する傾向があります。 クエリを再利用する予定がある場合は、常にクエリを保存します。 WIQL クエリが REST API を介して実行される場合でも、Web ポータルを介して WIQL を保存して REST API 呼び出しを行うため、、将来のパフォーマンス低下が起こりにくくなります。

クエリを実行する

場合によっては、適切な最適化プランに到達するのにクエリを数回実行する必要があります。 必ず、クエリを保存し、30 分間に最大 10 回実行してください。 これにより、システムでは、クエリに最も適した最適化プランを調べて探し出すことができます。

関連記事

• クエリのクイック リファレンス。
• クエリに関する FAQ
• フラット リスト クエリのグラフ化
• 列オプションの変更
• 作業項目フィールドのインデックス
• キーボード ショートカット