クエリ フィールド、演算子、値および変数

更新: 2012 年 1 月 8

作業項目クエリを作成して、作業項目のリストを検索、作成します。一つ以上の句を定義して、目的の作業項目のセットを返す、チーム プロジェクトまたはチーム プロジェクト コレクション内のすべての作業項目をフィルター処理します。それぞれの句では、フィールド、演算子、および値または変数指定します。たとえば、特定のチーム プロジェクトのすべての作業項目をチーム プロジェクトの [チーム プロジェクト] のフィールド、等号 (=) 演算子およびの名前を値として指定することで検索できます。値を指定する代わりに、現在のチーム プロジェクトを表す [@Project] のような変数を指定できます。

サンプルのクエリ句

および/または	フィールド	[演算子]	価値
AND	チーム プロジェクト	=	@Project

クエリの一般的な情報の詳細については、「バグ、タスク、およびその他の作業項目の検索」を参照してください。ショートカット キーを使用したクエリ エディターまたはクエリ ビュー内での移動方法については、「クエリ エディターおよびクエリの結果ビューのショートカット キー」を参照してください。

このトピックの内容

• および/または

• クエリ フィールドと値

• クエリ演算子

• クエリ変数

• フルテキスト検索、単語の部分

• クエリは、フィールドのインデックス付き

クエリ句を定義するためのチェック リスト

1. 最初の空の行で、[フィールド] ]列見出しの下に、使用可能なフィールドの一覧を表示するには、矢印をクリックして一覧の項目を選択します。

   詳細については、「クエリ フィールドと値」を参照してください。

2. 同じ行の、[演算子] ]列見出しの下で、使用できる演算子の一覧を表示するには、矢印をクリックして一覧の項目を選択します。

   詳細については、「演算子」を参照してください。

3. 同じ行の、[値] ]列見出しの下に、値、または下向きの矢印をクリックし、ボックスの一覧の項目を選択します。

4. 変数を使用して現在のチーム プロジェクト、ユーザーまたはデータを指定する方法の詳細については、「変数」を参照してください。

5. 句を追加するには、[Click here to add a new clause] または [Add a new clause] を選択します。

   句は必要に応じて、句の末尾への挿入、既存の句の後への挿入 ()、削除 ()、グループ化 ()、およびグループ化の解除 () を行うことができます。

および/または

クエリ句の論理式を作成するには およびまたは を指定します。現在の句、および前の句の両方の条件を満たす作業項目を検索するには および を指定します。現在の句または前の句の条件を満たす作業項目を検索するには、または を指定します。

作業項目の目的のセットだけを返すように検索条件を調整する各作業項目フィールドの 1 個の新しい句を追加できます。クエリから予期していた結果が得られなかった場合は、クエリ句を追加、削除、グループ化、またはグループ解除し、クエリ結果を絞り込むことができます。

クエリ句をグループ化して、残りのクエリから分離した 1 つの単体として操作できます。これは、数学の方程式や論理式の一部をかっこで囲むのと似ています。句をグループ化する場合、グループ内の最初の句に対する AND または OR が、グループ全体に適用されます。

次の例に示すように、グループ化句は、対応する論理式に変換されます。最初の式は、優先度 1 である、または任意の優先順位のすべてのアクティブなバグ作業項目を返します。2 番目の式がアクティブであるかどうかを優先度 1 のすべてのバグとアクティブなすべての優先順位 1 の作業項目を返します。

グループ化された句	論理式
	Priority=1 OR (Work Item Type=Bug AND State=Active)
	Priority=1 AND (Work Item Type=Bug OR State=Active)

詳細については、「クエリのフィルター条件の指定」を参照してください。

クエリ フィールドと値

先ほどフィールドに指定した値がそのフィールドのデータ型に従っている必要があります。次の表は、サポートされているデータ型の一覧です:

データ型	格納されるデータ
DateTime	世界協定時刻 (UTC: Coordinated Universal Time) の日時。変数、@Today または @Today-1は、などの 1/1/2012 などの値を指定できます。
Double	0.2、3.5 などの実数。
GUID	一意の ID を表す文字列。
History	履歴情報を追跡するために使用されるカスタムして書式設定フィールド。このデータ型だけが [履歴] のフィールドをサポートするために使用されます。このフィールドでは、フルテキスト検索を自動的にフルテキスト検索が使用可能な場合に指示されます。この後で説明する フルテキスト検索、単語の部分 を参照してください。
HTML	書式設定説明をサポート [説明] または [ステップの再現] のフィールドなどの文字列。これらのフィールドは、フルテキスト検索を自動的にフルテキスト検索が使用可能な場合に指示されます。この後で説明する フルテキスト検索、単語の部分 を参照してください。 メモ Team Foundation Serverをアップグレードするとき、[説明] のフィールドは PlainText のフィールドの種類から HTMLに変更されます。witadmin changefield のコマンドを使用して必要に応じてこのフィールドのデータ型を元に戻すことができます。「作業項目フィールドの管理 [witadmin]」を参照してください。
Integer	0、1、2、34 などの符号付き 32 ビット整数。
PlainText	長い説明をサポートする [アプリケーション開始情報] のフィールドなどの文字列。これらのフィールドは、フルテキスト検索を自動的にフルテキスト検索を使用できる場合、指示されます。この後で説明する フルテキスト検索、単語の部分 を参照してください。
String	最大 255 文字の Unicode 文字を含むことができる短い文字列。
TreePath	区分パスやイテレーション パスなどの分岐ツリー構造。有効値のリスト項目を選択する必要があります。同じツリー構造またはツリー構造の下で作業項目を検索できます。詳細については、「区分およびイテレーションの作成および修正」を参照してください。

ページのトップへ

クエリ演算子

次の表のクエリ演算子を使用すると、句内の各値を対応する作業項目内の値に関連付ける方法を指定できます。作業項目フィールドに割り当てられるデータ型の詳細については、「Visual Studio ALM の作業項目フィールド参照」を参照してください。

クエリ演算子	作業項目の値が抽出条件と一致した場合に作業項目が返される	適用可能なデータの種類
=	句内の値と一致する。	番号を設定します Double、GUID、Integerと String、および TreePath含む DateTime
<>	句内の値と一致しない。	数値、String、DateTimeと TreePath
>	句内の値より大きい。	数値、Stringと DateTime
<	句内の値より小さい。	数値、Stringと DateTime
>=	句内の値より大きいか等しい。	数値、Stringと DateTime
<=	句内の値より小さいか等しい。	数値、Stringと DateTime
=[フィールド]	指定したフィールドに含まれる値と一致する。	指定されたフィールドと同じデータ型のフィールドの名前
<>[フィールド]	指定したフィールドに含まれる値と一致しない。	指定されたフィールドと同じデータ型のフィールドの名前
>[フィールド]	指定したフィールドに含まれる値より大きい。	指定されたフィールドと同じデータ型のフィールドの名前
<[フィールド]	指定したフィールドに含まれる値より小さい。	指定されたフィールドと同じデータ型のフィールドの名前
>=[フィールド]	指定したフィールドに含まれる値より大きいか等しい。	指定されたフィールドと同じデータ型のフィールドの名前
<=[フィールド]	指定したフィールドに含まれる値より小さいか等しい。	指定されたフィールドと同じデータ型のフィールドの名前
次の値を含む	、フィルター処理のために選択したフィールド内の文字列の正確なまたは部分的に一致することを示します。	String
次の値を含まない	、フィルター処理のために選択したフィールド内の文字列の正確なまたは部分的に一致は含まれません。	String
[語を含む]	、フィルター処理のために選択したフィールド内の厳密な文字列または単語が含まれます。ワイルドカード文字を含む句または部分は、* を入力できます。制約用に、サーバーと照合順序の要件については、フルテキスト検索 を参照してください。	フルテキスト検索のようになった集合テキスト フィールド、PlainText と HTML のすべてのフィールドおよび [タイトル] に対応する。
[語を含まない]	、フィルター処理のために選択したフィールド内の厳密な文字列または単語が含まれていません。	フルテキスト検索のために指示するテキスト フィールド。
In	区切られた値と一致する。たとえば、ID が 100、101 および 102 の作業項目は、[ID] フィールドにこれらの値を指定すると検索できます。 重要 値は、クライアント コンピューターに定義されている地域設定に対応するリスト区切り記号で区切ります。たとえば、コンマ (,) を使用できます。	数値、String、DateTime、TreePath
グループ内	句内のグループのメンバーである値と一致する。Team Foundation Server の既定グループ、カスタム グループ、またはカテゴリ グループを指定できます。たとえば、貢献者グループのメンバーに割り当てられているすべての作業項目を検索するクエリを作成できます。 メモ セキュリティ グループや配布グループを値として指定することはできません。	StringTeam Foundation Serverのユーザー グループまたはカテゴリ グループの名前と一致する。 メモ String のデータ型または [作業項目の種類] のフィールドを使用するフィールドを持つだけ [グループ内] の演算子を使用できます。 カテゴリ グループの詳細については、「作業項目の種類のカテゴリをグループ化するカテゴリの定義」を参照してください。
グループ外	句内のグループのメンバーである値と一致しない。	StringTeam Foundation Server のユーザー グループまたはチーム プロジェクト用に定義されたカテゴリ グループの名前と一致する。 メモ String のデータ型または [作業項目の種類] のフィールドを使用するフィールドを持つだけ [グループ外] の演算子を使用できます。 カテゴリ グループの詳細については、「作業項目の種類のカテゴリをグループ化するカテゴリの定義」を参照してください。
次の値と等しかったことがある	句内の値が前のいずれかと一致する。	String, DateTime
次の値の下	句内の値と一致するか、または句内のノードの下に含まれる。	TreePath
次の値の下ではない	句内の値と一致せず、かつ句内のノードの下に含まれない。	TreePath

ページのトップへ

クエリ変数

次の表の変数を使用すると、現在のユーザー、現在のプロジェクト、現在の日付に関連する作業項目を検索できます。

クエリ変数	使用方法
@Me	この変数を使用すると、ユーザー エイリアスを含むフィールドで、現在のユーザーのエイリアスを自動検索できます。たとえば、自分が開いた作業項目を検索するには、[フィールド] 列を [アクティブ化した人] に、[演算子] 列を [=] に、[値] 列を @Me に、それぞれ設定します。
@Project	この変数を使用すると、現在のチーム プロジェクト内の作業項目を検索できます。たとえば、現在のチーム プロジェクト内のすべての作業項目を検索するには、[フィールド] 列を [チーム プロジェクト] に、[演算子] 列を [=] に、[値] 列を @Project に、それぞれ設定します。
@Today	この変数を使用すると、現在の日付または以前の日付に関連する作業項目を検索できます。また、@Today 変数から日数を引いた値を使用することもできます。たとえば、[フィールド] 列を [アクティブ化された日] に、[演算子] 列を [>=] に、[値] 列を @Today - 7 に、それぞれ設定すると、過去 1 週間にアクティブ化されたすべての項目を検索できます。
[Any]	この変数を使用すると、特定のフィールドに定義されている値に関連した作業項目が検索されます。

ページのトップへ

フルテキスト検索、単語の部分

単語または語句の厳密な一致または部分的に対して検索するには [次の値を含む][次の値を含まない] かを指定します。厳密な句に対して検索したり、ワイルドカード文字、* を使用するには [語を含む][語を含まない] かを指定します。これらの演算子はフルテキスト検索インデックスを使用します。語の一部または句の末尾でのみワイルドカード文字を使用できません。

例については、「キーワードまたは語句に基づく作業項目の検索」および「[履歴] フィールドを使用した履歴の表示と作業項目の検索」を参照してください。

[!メモ]

すべての配置がフルテキスト検索をサポートしていません。たとえば、Express、Team Foundation サービスをサポートする SQL Azure SQL はフルテキスト検索をサポートしていません。これらのインスタンスで、[次の値を含む] と [次の値を含まない] の演算子だけに進めるのに。

[語を含む] と [語を含まない] は、テキスト フィールドに対して作成されたフルテキスト検索インデックスに基づいて項目をフィルター処理します。Team Foundation が自動的に PlainText と HTML のデータ型とフルテキスト検索の [タイトル] のフィールドを使用して、すべてのテキスト フィールドを指示します。この SQL Server が Team Foundation Server のサポートのフルテキスト検索をサポートする場合にのみインデックスと演算子を使用できます。

フルテキスト検索は、SQL Server に登録されている Word ブレーカーがある言語に対応する SQL の照合順序を必要とします。Team Foundation Server のインスタンスに使用する言語にサポートされているチーム プロジェクト コレクションのデータベースの照合順序の設定が対応する、検索結果は予測と一致しない場合があります。このような場合、[次の値を含む] または [次の値を含まない] の演算子を使用しようとした場合があります。

詳細については、フルテキスト検索クエリ、照合順序の設定を参照してください。

クエリは、フィールドのインデックス付き

フルテキスト検索インデックスに対して追加のクエリのインデックスが作成されます。これは、有効なインデックスは、これらのフィールドに基づいています。クエリのインデックスは、インデックス フィールドを含むクエリを実行する応答時間を短縮します。

既定では、次のフィールドは、インデックス付けされています: [担当者]、[作成日]、[変更者]、[状態]、[理由]、[区分 ID]、[イテレーション ID] と [作業項目の種類]。チームが、クエリで頻繁に使用する他のフィールドがある場合、クエリのインデックスに追加できます。

フィールドのインデックス作成を有効または無効にする witadmin indexfield のコマンドを使用します。「作業項目フィールドの管理 [witadmin]」を参照してください。

参照

処理手順

クエリのフィルター条件の指定

単純なリスト (既定) クエリの操作

リンク階層の操作 (作業項目のツリー)

概念

バグ、タスク、およびその他の作業項目の検索

その他の技術情報

リンクされた依存関係の操作 (ダイレクト リンク)

履歴の変更

日付	履歴	理由
2012 年 1 月 8	フルテキスト検索のために送信されるフィールドのセットのフィールドのデータ型と削除された Description を記述するテーブルを修正。フルテキスト検索の andn の 2 セクションを追加クエリに指示します。	情報の拡充