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

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

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

ヒント

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

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

必須コンポーネント

カテゴリ 必要条件
プロジェクト メンバーシップ プロジェクトの メンバーとして追加 する必要があります。
アクセス レベル - 共有クエリを表示して実行するには、Projectメンバーである必要があります。
- 共有クエリを追加して保存するには、少なくとも Basic アクセス権が必要です。
Permissions クエリを追加するフォルダーで、[共同作成] アクセス許可が [許可] に設定されていることを確認してください。 組織では、このアクセス許可を付与するために 共同作成者 グループを手動で構成する必要がある場合があります。

メモ

共有クエリを保存するには、十分なアクセス レベルと 投稿 アクセス許可の両方が必要です。 基本的なアクセスでは不十分です。

カテゴリ 必要条件
プロジェクト メンバーシップ プロジェクトの メンバーとして追加 する必要があります。
アクセス レベル - 共有クエリを表示して実行するには、Projectメンバーである必要があります。
- 共有クエリを追加して保存するには、少なくとも Basic アクセス権が必要です。
Permissions クエリを追加するフォルダーで、[共同作成] アクセス許可が [許可] に設定されていることを確認してください。 組織では、このアクセス許可を付与するために 共同作成者 グループを手動で構成する必要がある場合があります。

メモ

共有クエリを保存するには、十分なアクセス レベルと 投稿 アクセス許可の両方が必要です。 基本的なアクセスでは不十分です。

サポートされるデータ型

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

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

メモ

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

サンプル フィルター

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

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

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

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

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

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

メモ

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

B

C

DーF

H

I

  • ID (システム)
  • 影響の評価 (CMMI)
  • アーキテクチャへの影響 (CMMI)
  • 開発プロセスへの影響 (CMMI)
  • 技術出版物への影響 (CMMI)
  • テストへの影響 (CMMI)
  • ユーザー エクスペリエンスへの影響 (CMMI)
  • はビルド (TCM) に統合されました
  • 問題 (TCM)
  • イテレーション ID (システム)

R

メモ

フィールドとフィールドの比較のサポートは、クライアントによって異なります。 Web クエリ エディターでは、ほとんどのフィールド比較がサポートされています。複雑な比較 (たとえば、WAS EVER または高度な WIQL 式の一部の使用) では、WIQL を直接編集する必要があります (WIQL エディター拡張機能)。 不明な場合は、Web クエリ エディターで句をビルドし、保存された 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など) が必要な場合は、「 作業項目のフィールドと属性」を参照してください。