次の方法で共有


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

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

比較フィールド演算子を使用し、あるフィールドの値と別のフィールドの値を比較する方法に基づいてクエリを作成できます。 このクエリは、次の基準に基づいて作業項目をフィルター処理する場合に便利です。

  • 作業項目を作成した人物は、その作業項目に割り当てられた人物と同じか、それとも異なるか? それとも誰が閉じたのか
  • どのタスクが目標とする日より前または後に終了したか。

必須コンポーネント

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

メモ

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

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

サポートされるデータ型

比較フィールド演算子 (=[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]) は、以下のフィールド データ型で使用できます。 [フィールド][値] に選択したデータ型は一致している必要があります。

  • Boolean (=[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 プロセス)」を参照してください。

REST API

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