次の方法で共有

インデックスを使用してクイック参照データを照会する

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

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

クエリの例

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

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

タグ ベースのクエリ

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

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

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

ID ベースのクエリ

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

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

チーム フォーカス クエリ

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

Other

クエリ作業

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

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

Note

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

データの種類

Description

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

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 2020 以降のバージョンでサポートされている追加のマクロ::
@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

Identity

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

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

Integer

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 ([イテレーション パス] フィールドで有効)

Note

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

日付と時刻のパターン

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

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

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

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

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

A

B

C

D-E-F

H-P

R

S

T

V-W

関連コンテンツ

  • Last updated on