クエリフィールド、演算子、値、および変数 (Team Explorer Everywhere)

2011-04-04

作業項目の検索クエリを作成する場合は、検索する作業項目のセットを指定する 1 つ以上の句を定義できます。それぞれの句では、フィールド、演算子、値/変数を指定できます。たとえば、特定のチームプロジェクトのすべての作業項目は、[チームプロジェクト] フィールド、等記号 (=) 演算子、チームプロジェクトの名前を値として指定することで検索できます。値を指定する代わりに、現在のチームプロジェクトを表す @Project などの変数も指定できます。

サンプルのクエリ句を次の表に示します。

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

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

このトピックの内容

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

最初の空白行の [フィールド] 列見出しの下をクリックし、下向きの矢印をクリックして使用できるフィールドを表示し、一覧から項目をクリックします。

詳細については、「Query Fields and Values」を参照してください。
同じ行の [演算子] 列見出しの下をクリックし、下向きの矢印をクリックして使用できる演算子を表示し、一覧から項目をクリックします。

詳細については、「Query Operators」を参照してください。
同じ行で、[値] 列見出しの下をクリックします。
値を入力するか、下向きの矢印をクリックして一覧から項目をクリックします。

変数を使用して現在のチームプロジェクト、ユーザー、または日付を指定する方法の詳細については、「Query Variables」を参照してください。
句を追加するには、左端の列のアスタリスク (*) をクリックします。

注意

2 番目の句を追加するには、追加した句のフィールドに値を設定しておく必要があります。

句は必要に応じて、クエリの末尾または既存の句の間に追加することができ、削除、グループ化、およびグループ解除を行うことができます。また、句の内容をコピーして、別の場所に貼り付けることもできます。詳細については、「クエリ条件の指定」を参照してください。

および/または

この列を使用すると、句のテスト方法を指定できます。この句および前の句の両方の抽出条件を満たす作業項目を検索する場合は、[AND] を指定します。この句または前の句のいずれかの抽出条件を満たす作業項目を検索する場合は、[OR] を指定します。

クエリフィールドと値

各フィールドの値を指定するときは、値がそのフィールドのデータ型に適合している必要があります。 Team Foundation のすべてのフィールドには、次の表で示されたデータ型のいずれかが設定されています。

データ型	格納されるデータ
DateTime	世界協定時刻 (UTC: Coordinated Universal Time) の日時。 @Today や @Today-1 などの変数や、「1/1/2009」などの値を指定できます。
Double (倍精度浮動小数点型)	0.2、3.5 などの実数。
GUID	一意の ID を表す文字列。
HTML	書式付き説明をサポートする文字列。
Integer (整数型)	0、1、2、34 などの符号付き 32 ビット整数。
PlainText	"説明" フィールドや "履歴" フィールドなどの長い説明をサポートする文字列。 PlainText フィールドに含まれる語句やキーワードに基づいて、作業項目を検索できます。
String	最大 255 文字の Unicode 文字を含む文字列。
TreePath	区分パスやイテレーションパスなどの分岐ツリー構造。有効値の一覧で項目をクリックする必要があります。同じツリー構造またはツリー構造の下で作業項目を検索できます。

クエリ演算子

次の表のクエリ演算子を使用すると、句内の各値を対応する作業項目内の値に関連付ける方法を指定できます。

クエリ演算子	作業項目の値が抽出条件と一致した場合に作業項目が返される	適用可能なフィールドの種類
=	句内の値と一致する。	数値、テキスト、日付、ツリー
<>	句内の値と一致しない。	数値、テキスト、日付、ツリー
>	句内の値より大きい。	数値、テキスト、日付
<	句内の値より小さい。	数値、テキスト、日付
>=	句内の値より大きいか等しい。	数値、テキスト、日付
<=	句内の値より小さいか等しい。	数値、テキスト、日付
=[フィールド]	指定したフィールドに含まれる値と一致する。	指定したフィールドと同じデータ型のすべてのフィールド
<>[フィールド]	指定したフィールドに含まれる値と一致しない。	指定したフィールドと同じデータ型のすべてのフィールド
>[フィールド]	指定したフィールドに含まれる値より大きい。	指定したフィールドと同じデータ型のすべてのフィールド
<[フィールド]	指定したフィールドに含まれる値より小さい。	指定したフィールドと同じデータ型のすべてのフィールド
>=[フィールド]	指定したフィールドに含まれる値より大きいか等しい。	指定したフィールドと同じデータ型のすべてのフィールド
<=[フィールド]	指定したフィールドに含まれる値より小さいか等しい。	指定したフィールドと同じデータ型のすべてのフィールド
次の値を含む	句内にテキスト値が含まれる。	テキスト
次の値を含まない	句内にテキスト値が含まれない。	テキスト
In	コンマで区切られた値と一致する。たとえば、ID が 100、101 および 102 の作業項目は、[ID] フィールドにこれらの値を指定すると検索できます。	数値、テキスト、日付、ツリー
グループ内	句内のグループのメンバーである値と一致する。たとえば、このフィールドを使用して、配布リストの任意のメンバーに割り当てられているすべての作業項目を検索できます。	カテゴリグループの文字列または名前メモグループ内演算子は、文字列型を使用しているフィールドまたは "作業項目の種類" フィールドにのみ使用できます。カテゴリグループの詳細については、Microsoft Web サイトの「カテゴリへの作業項目の種類のグループ化」を参照してください。
グループ外	句内のグループのメンバーである値と一致しない。	カテゴリグループの文字列または名前メモグループ外演算子は、文字列型を使用しているフィールドまたは "作業項目の種類" フィールドにのみ使用できます。カテゴリグループの詳細については、Microsoft Web サイトの「カテゴリへの作業項目の種類のグループ化」を参照してください。
次の値と等しかったことがある	句内の値が前のいずれかと一致する。	テキスト、日付
次の値の下	句内の値と一致するか、または句内のノードの下に含まれる。	ツリー
次の値の下ではない	句内の値と一致せず、かつ句内のノードの下に含まれない。	ツリー

クエリ変数

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

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