次の方法で共有


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

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

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

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

必須コンポーネント

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

メモ

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

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

サポートされるデータ型

比較演算子 ( =[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

R

U – W

メモ

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

REST API

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

ヒント

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