Azure Boards と Azure DevOps のフィールド値比較によるクエリ

  • [アーティクル]

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

比較フィールド演算子を使って、あるフィールドの値と他のフィールドとの比較に基づいたクエリを作成できます。 このクエリは、以下に基づいて作業項目をフィルター処理するのに役立ちます。

  • 作業項目を作成したユーザーは、その作業項目に割り当てられたユーザーと同じか違うか? あるいは、どのユーザーがそれを閉じたか
  • どのタスクが目標とする日の前または後に閉じられたか。

サポートされるデータ型

比較フィールド演算子 =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field] は、次のフィールド データ型で使用できます。 [フィールド] と [値] で選んだデータ型は一致している必要があります。

  • ブール値 (=[Field], <>[Field] をサポートしています)
  • 日付/時刻
  • Double、Integer
  • GUID
  • ID
  • 文字列 (タグを除く)

注意

データ型と比較フィールドの演算子の組み合わせによっては、Title >=[Field] や Assigned To <=[Field] のように使う意味がない場合もあります。

サンプル フィルター

フィルターの対象

含まれるクエリ句

作業項目を作成したユーザー以外のユーザーによって閉じられた作業項目

Created By <>[Field] Closed By State = Closed

元の見積もりが、完了した作業より少ないタスク

Original Estimate <=[Field] Completed Work

目標日より前に完了した終了タスク

Target Date <=[Field] Closed Date State = Closed

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

次の表に、フィールド比較クエリをサポートするフィールドのインデックスを示します。

注意

一覧表示されたすべてのフィールドが、すべてのプロジェクトまたは作業項目の種類でサポートされているわけではありません。 ただし、クエリとフィールド比較の目的で使用できるカスタム フィールドを追加することで、プロセスまたは作業項目の種類をカスタマイズできます。 詳細については、「作業項目の種類 (継承プロセス) にカスタム フィールドを追加する」または「フィールド (オンライン XML プロセス) を追加または変更する」を参照してください。

A

B

C

D-E-F

H

I

J-L-M-N

O-P-Q

R

S

T

U-V-W

REST API

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