インデックスを使用して Azure Boards と Azure DevOps でクイック参照データのクエリを実行する

  • [アーティクル]

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

クエリの開始、定義、操作に関するクエリの例や情報にすばやくアクセスするには、このインデックスを使います。 クエリ エディターの使い方については、「クエリを定義する」をご覧ください。 クエリが結果を返すのに時間がかかりすぎる場合は、「クエリの定義/ベスト プラクティス」を参照してください。

クエリの例

次の条件に基づいて作業項目の一覧を表示できます。

キーワード、ワイルドカード クエリ

タグ ベースのクエリ

状態、理由、またはワークフローの変更のクエリ

日付とイテレーション ベースのクエリ

リンクと添付ファイル数のクエリ

ID ベースのクエリ

作業項目数と数値フィールドのクエリ

履歴、ディスカッション、リビジョン変更のクエリ

チーム フォーカス クエリ

ビルドとテストのフィールドのクエリ

その他

クエリ タスク

各データ型でサポートされている演算子とマクロ

次の表では、さまざまなフィールド データ型で使用できる演算子とマクロを示します。 各フィールドは、データ型と関連付けられます。 各フィールドの説明の一覧で示されているデータ型は、作業項目フィールドのインデックスを使って検索できます。 クエリ句の定義に使用できる演算子は、選んだフィールドのデータ型に依存します。 データ型、演算子、マクロについて詳しくは、クエリのフィールド、演算子、マクロに関する記事をご覧ください。

注意

次のマクロは、Web ポータルからのみサポートされています: @CurrentIteration、@CurrentIteration +/- n、@Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity、@TeamAreas。 これらのマクロを含むクエリは、Visual Studio のチーム エクスプローラー、Microsoft Excel、または Microsoft Project で開くと機能しません。

データの種類

説明

サポートされている演算子とマクロ

Boolean

True/False 値をサポートします。 クエリ サンプル: 割り当てまたはワークフローの変更によるクエリの実行。

= , <> , =[Field] , <>[Field]

DateTime

@Today や @Today-1 などの変数、または 1/1/2012 などの値を指定できる日付フィールド。 個人プロファイルで設定した日付パターンで日付を入力します。 詳しくは、個人用の設定に関する記事をご覧ください。

クエリの例については、日付または @CurrentIteration によるクエリに関する記事をご覧ください。

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
マクロ: @Today (任意の DateTime フィールドで有効)

Azure DevOps 2019 Update 1 以降のバージョンでサポートされている追加のマクロ:
@StartOfDay、@StartOfWeek、@StartOfMonth、@StartOfYear (任意の DateTime フィールドで有効)

Double

Decimal とも呼ばれ、picklistDouble1 が含まれます。 0.2、3.5 などの実数。

クエリの例: 数値フィールドによるクエリ。

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

GUID

一意の ID を表す文字列。

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

HISTORY

履歴情報を追跡するために使われ、[履歴] フィールドにのみ割り当てられるカスタム書式設定フィールド。

クエリの例: 履歴と監査。

単語を含む、単語を含まない

HTML

[説明] または [再現ステップ] フィールドなどの書式設定された説明をサポートするテキスト文字列。 フルテキスト検索が利用可能な場合は、これらのフィールドに対してフルテキスト検索用のインデックスが自動的に作成されます。 クエリのサンプル: タイトル、ID、リッチテキスト フィールドによるクエリ。

Contains Words、Does Not Contain Words、Is Empty2、Is Not Empty2

ID

ユーザー ID を保持するために使われる String フィールド。 クエリ サンプル: 割り当てまたはワークフローの変更によるクエリの実行。

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Everマクロ: @me (すべての ID フィールドで有効)。

整数

picklistInteger1 も含まれます。 0、1、2、34 などの符号付き 32 ビット整数。

クエリのサンプル: 数値フィールドによるクエリ

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

マクロ: @Follows、@MyRecentActivity、@RecentMentions、@RecentProjectActivity (ID フィールドで使う場合に有効)。

PlainText

フルテキスト検索を使用できる場合に、長い説明をサポートし、フルテキスト検索用のインデックスが自動的に作成される、複数行のテキスト文字列。
クエリの例: タイトル、ID、リッチテキスト フィールドによるクエリ。

Contains Words, Does Not Contain Words, Is Empty, Is Not Empty

String

picklistString1 も含まれます。 最大 255 個の Unicode 文字を含むことができる短い単一行テキスト。 文字列フィールドは、[タイトル] フィールド、候補リスト (ドロップダウン メニュー)、ユーザー アカウント、タグ、その他のフィールドをサポートします。

クエリの例: タイトル、ID、リッチテキスト フィールドによるクエリ、候補リストの値によるクエリ。

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever

マクロ: [Any] ([作業項目の種類] フィールドで有効)、@Project ([チーム プロジェクト] フィールドで有効)。

TreePath

[区分パス] と [イテレーション パス] フィールドをサポートするフィールド型。 プロジェクトのツリー構造を定義します (区分パスとイテレーション パス)。

クエリの例: 区分パスまたはイテレーション パスによるクエリ、日付または現在のイテレーションによるクエリ。

Under, Not Under, =, <>, In, Not In

マクロ: @TeamAreas3 ([区分パス] フィールドで有効)
@CurrentIteration と @CurrentIteration+/- n4 ([イテレーション パス] フィールドで有効)

注意

  1. picklist... データ型は、継承されたプロセスに対して定義されたカスタム フィールドにのみ割り当てられます。 継承されたプロセス モデルは、Azure DevOps Server 2019 以降のバージョンでのみサポートされています。
  2. Is Empty と Is Not Empty 演算子は、Azure DevOps Server 2019 RC2 以降のバージョンでサポートされています。
  3. @TeamAreas マクロは、Azure Boards と Azure DevOps Server 2019 以降のバージョンでサポートされています。
  4. @CurrentIteration +/- n マクロは、Web ポータルから実行される場合にのみ、Azure DevOps Server 2019 以降のバージョンでサポートされます。

日付と時刻のパターン

DateTime フィールドに入力する日付と時間のパターンは、プロファイルで選んだものと一致する必要があります。 選択内容を表示または変更するには、「時刻とロケールのユーザー設定を設定する」を参照してください。

[時刻とロケール] ペインの [日付パターン] ドロップダウン オプションを示すスクリーンショット。[時刻とロケール] ペインの [時刻パターン] ドロップダウン オプションを示すスクリーンショット。

[日付パターン] フィールドと [時刻パターン] フィールドを含む [時刻とロケール] ペインを示すスクリーンショット。

選択フィールドのクエリの例

次の表は、一般的なクエリ フィールドと、サンプル クエリが提供されているデータ型の一覧です。 フィールドのデータ型を確認するには、作業項目のフィールドと属性に関する記事の「フィールド属性を一覧表示する」をご覧ください。

A

B

C

D-E-F

H-P

R

S

T

V-W