次の方法で共有


フィールド値の比較によるクエリ

Azure DevOps サービス |Azure DevOps Server |Azure DevOps Server 2022

あるフィールドの値を別のフィールドの値と比較して作業項目をフィルター処理する場合は、比較フィールド演算子を使用します。 一般的な使用方法は以下のとおりです:

ヒント

この記事の後半でAIを使用してこのタスクを支援することができます。また、作業を開始するには、Azure DevOps MCP ServerでAIサポートを有効にする方法を参照してください。

  • 作成者が担当者または終了者と異なる作業項目を見つけます。
  • 元の見積もりが完了した作業より小さいタスクを検索します。
  • ターゲット日付より前に完了した終了したタスクを検索します。

必須コンポーネント

カテゴリ 必要条件
アクセス レベル - 共有クエリを表示して実行するには、プロジェクト メンバー である必要があります。
- 共有クエリを追加して保存するには:少なくとも Basic アクセス。
Permissions クエリを追加するフォルダーの貢献権限が許可に設定されていること。 既定では、 共同作成者 グループにはこのアクセス許可がありません。

メモ

パブリック プロジェクトの 利害関係者 アクセス権を持つユーザーは、 Basic アクセス権を持つユーザーと同様に、クエリ機能にフル アクセスできます。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。

カテゴリ 必要条件
アクセス レベル - 共有クエリを表示して実行するには、プロジェクト メンバー である必要があります。
- 共有クエリを追加して保存するには、少なくとも ベーシックアクセスが必要です。
Permissions クエリを追加するフォルダーの貢献権限が許可に設定されていること。 既定では、 共同作成者 グループにはこのアクセス許可がありません。

サポートされるデータ型

比較演算子 ( =[Field]<>[Field]>[Field]<[Field]>=[Field]<=[Field] ) は、次のデータ型と共に使用できます。 左側のフィールドと右側のフィールドのデータ型が一致している必要があります。

  • Boolean ( =[Field]<>[Field]をサポート)
  • 日付/時刻
  • Double、Integer
  • GUID
  • ID
  • 文字列 (タグを除く)

メモ

一部のデータ型/演算子の組み合わせは意味を成しません (たとえば、Title >= [Field]Assigned To <= [Field])。 比較を検証して、両方の側で互換性のあるデータ型が使用されていることを確認します。

サンプル フィルター

これらのテンプレートを出発点として使用します。 Query Editorの正確な構文は、クライアントによって若干異なる場合があります。不明な場合は、Web Query Editorで句をビルドし、保存された WIQL を確認します。

  • 作業項目を作成したユーザー以外が閉じた作業項目: [作成者] <> [終了] AND [状態] = 'Closed'

  • 元の見積もりが完了した作業時間未満のタスク: [元の見積もり] < [完了した作業時間]

  • 目標日より前に完了した終了タスク: [終了日] <= [ターゲット日] AND [状態] = 'Closed'

フィールド比較をサポートするフィールド

次の表に、比較クエリをサポートするフィールドを示します。 すべてのプロセスまたは作業項目の種類ですべてのフィールドを使用できるわけではありません。一部のユーザー設定フィールドまたはプロセス構成が必要です。 カスタマイズ リンクについては、次の注意事項を参照してください。

メモ

一覧表示されているすべてのフィールドがすべてのプロジェクト/プロセスに存在するわけではありません。 ユーザー設定フィールドを追加し、比較のために有効にすることができます。 作業項目の種類へのユーザー設定フィールドの追加 (継承されたプロセス) またはフィールドの追加または変更 (オンプレミスの XML プロセス) に関するページを参照してください。

B

C

R

メモ

フィールドとフィールドの比較のサポートは、クライアントによって異なります。 Web Query Editorでは、ほとんどのフィールド比較がサポートされています。複雑な比較 (たとえば、WAS EVER または高度な WIQL 式の一部の使用) では、WIQL を直接編集する必要があります (WIQL エディター拡張機能)。 不明な場合は、Web Query Editorで句をビルドし、保存された WIQL を調べます。

AI を使用してフィールド値の比較でクエリを実行する

エージェント モードで Azure Boards MCP Server が AI エージェントに接続されている場合は、自然言語プロンプトを使用して、フィールドとフィールドの比較に基づいて作業項目を検索できます。

Task プロンプトの例
作成者と担当者を比較する Find work items where Created By is different from Assigned To
推定精度を確認する List tasks where Completed Work exceeds Original Estimate
早期完了を発見する Show work items that were closed before their target date
変更履歴の比較 Find bugs where the person who last changed the item differs from the creator
過小評価された作業を検出する List tasks in the current sprint for <Contoso> where remaining work is more than double the original estimate
期限切れのアイテムを検索する Show active work items in <Contoso> where the target date is before today
努力の不一致を見つける List user stories in <Contoso> with story points greater than 8 but only 1 child task
計画済みと実際の比較 For completed tasks in the current sprint for <Contoso>, show original estimate vs completed work side by side
ゼロエフォート項目を検索する List active tasks in the current sprint for <Contoso> where both original estimate and remaining work are zero or empty
自己割り当て作業を識別する Show work items in <Contoso> where Created By equals Assigned To and state is still New

メモ

エージェント モードと MCP サーバーでは自然言語が使用されるため、これらのプロンプトを調整したり、フォローアップの質問をして結果を絞り込むことができます。

REST API

プログラムでクエリを操作するには、次の REST API リソースのいずれかを参照してください。

ヒント

WIQL または REST の参照名 ( System.IterationIdMicrosoft.VSTS.Common.Priorityなど) が必要な場合は、「 作業項目のフィールドと属性」を参照してください。