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

クエリが自分やチームに、目的の作業項目を検索できるようにフィルター条件を指定できます。こののアクティブ タスクが、割り当てられているかをチェックしたり、最近更新された作業項目を処理して、クエリの検索にマクロを使用します。

作業項目クエリはすべて 1 つ以上のクエリ句で構成されています。各句は、フィールド、演算子、および値を含みます。に、目的の作業項目のセットを検索するクエリの句とフィールドを追加、変更、およびグループ化します。クエリを定義するには、目的の結果を得られるまで、クエリのフィルター条件を調整したりできる反復的なプロセスです。

このトピックの内容

1. クエリの種類を選択します。

2. トップレベルのクエリのフィルター条件を指定します。

3. (省略可能) リンクされた作業項目のフィルター条件を指定します。

4. 、またはグループ解除のクエリ句を追加、削除、グループ化します。

5. クエリの結果とチェックを実行または中止し、

6. クエリのフィルター条件を調整します。

[!メモ]

次に示すのは、チーム エクスプローラーでの手順です。Team System Web Access での手順も似ていますが、細部は異なる可能性があります。

要件

• [Readers] のグループのメンバーである **[許可]**に設定 [このノードの作業項目を表示します] のアクセス許可がない。クエリのアクセス許可の詳細については、バグ、タスク、およびその他の作業項目の検索を参照してください。

1.クエリの種類を選択します。

1. チーム プロジェクトを開き、[作業項目] のページを選択し、を **[新しいクエリ]**を選択します。

   新しい [作業項目の単純なリスト (既定)] クエリが表示されます。

2. クエリ ツール バーで、検索するビュー、または作業項目の種類に応じて [クエリの種類] を選択します。

   •  [単純なリスト (既定)]: 単一層、フィルター条件に一致する作業項目の一覧を返します。他の作業項目にリンクする作業項目を検索する場合、作業項目を Office Excel および Office Project にエクスポートして列フィールドへの一括更新を行う場合、または一連の作業項目に関するレポートを生成する場合に、この種類のクエリを使用します。詳細については、「単純なリスト (既定) クエリの操作」を参照してください。

   • [作業項目とダイレクト リンク]: クエリのフィルター条件に一致する結果にリンクされているすべての作業項目をセカンダリ フィルター条件に基づいて階層のセットの作業項目を返します。作業項目は、展開および折りたたみが可能なビューで表示されます。詳細については、「リンクされた依存関係の操作 (ダイレクト リンク)」を参照してください。

   •  [作業項目のツリー]: クエリのフィルター条件に一致すると、親子リンクに基づくトップレベルの作業項目にリンクされているすべての作業項目が含まれますの多層セットの作業項目が。作業項目は、展開および折りたたみが可能な階層型のビューで表示されます。詳細については、「リンク階層の操作 (作業項目のツリー)」を参照してください。

   各クエリの型によってサポートされるタスクの概要については タスクの右側のクエリ ツールを選択します。を参照してください。

ページのトップへ

2.トップレベルのクエリのフィルター条件を指定します。

トップレベルのフィルター条件では、クエリ結果がチーム プロジェクトと作業項目の種類に限定されます。

[!メモ]

新しいクエリに対して定義された既定のフィルター条件は、現在のチーム プロジェクト (チーム プロジェクト = @Project) で、自分に割り当てられた (担当者 = @Me) すべての作業項目 (作業項目の種類 = [すべて]、および、状態 = [すべて]) を返します。

複数のチーム プロジェクトを操作している場合、1 つのクエリですべてのチーム プロジェクトを対象に検索できると便利なことがあります。

1. 検索する作業項目を含むチーム プロジェクトを指定します。取得する作業項目によって、次のように指定します。

   • 現在のチーム プロジェクトの作業項目の場合は、[チーム プロジェクト] [=] [@Project] とします。

   • 他のチーム プロジェクトの作業項目の場合は、[チーム プロジェクト] フィールドの [値] 列にチーム プロジェクトの名前を入力します。

   • 複数のチーム プロジェクトの作業項目の場合は、次の表に示す値を入力します。

     および/または	フィールド	[演算子]	値
     	チーム プロジェクト	In	<最初のチーム プロジェクト名>, <2 つ目のチーム プロジェクト名>, ...

     チーム プロジェクト名はコンマ (,) で区切ります。

2. 検索する作業項目の種類を指定します。取得する作業項目によって、次のように指定します。

   • すべての種類の場合は、[作業項目の種類] [=] [[すべて]] のままにしておきます。

   • 単一の型は、[作業項目の種類] のフィールドの [値] の列を選択し、目的の作業項目の種類を選択します。

   • 複数の種類の場合は、次の表に示す値を入力します。

     および/または	フィールド	[演算子]	値
     AND	作業項目の種類	In	<最初の作業項目の種類>, <2 つ目の作業項目の種類>, ...

     各作業項目の種類の名前はコンマ (,) で区切ります。

   • 名前付きのカテゴリに属するすべての種類の作業項目の場合は、次の表に示す値を入力します。

     および/または	フィールド	[演算子]	値
     AND	作業項目の種類	グループ内	<この作業項目の種類の名前>

     作業項目の種類のグループを定義する方法の詳細については、作業項目の種類のカテゴリのカスタマイズ [witadmin]を参照してください。

     トップレベルの条件をフィルターするために使用されるその他のオプションについては、「クエリ フィールド、演算子、値および変数」の「演算子」のセクションを参照してください。

3. クエリ ツール バーで、**[実行]**を 選択し、クエリが意図した結果を返すことを確認します。

4. **[クエリの保存]**を選択 します。詳細については、「作業項目クエリの保存、コピー、名前変更、および削除」を参照してください。

ページのトップへ

3.(省略可能) リンクされた作業項目のフィルター条件を指定します。

[作業項目とダイレクト リンク] か **[作業項目のツリー]**を選択 した場合は、リンクされた作業項目のフィルター条件を指定できます。または最上位層の作業項目がある。

フィルター条件を指定する作業項目とダイレクト リンク クエリ

1. 選択 そのクエリと一致する作業項目リンク。トップレベルの条件の設定を定義した句と同様に追加し、グループ化します。

   リンクされた作業項目のフィルター条件

   

2. 作業項目の第層の一覧をフィルター処理するに [リンクしているフィルター] の項目を選択する:

   • [最上位の作業項目すべてを戻す]: リンクされた作業項目のフィルター条件に関係なく、第 1 層のすべての作業項目を返します。最初の層にリンク番目の層の作業項目はリンクされた作業項目のフィルター条件に一致する場合。

   • 指定したリンクのある戻り値の作業項目だけです: 最初の層の作業項目はリンクされた作業項目のフィルター条件で指定される作業項目へのリンクである場合にのみ、を返します。

   • 指定のリンクを持たない戻り値の作業項目だけです: 最初の層の作業項目はリンクされた作業項目のフィルター条件で指定される作業項目へのリンクがない場合に、を返します。

3. (省略可能) **[選択された種類のリンクを戻す]**を選択し、フィルター条件に含めるリンクの種類のあるチェック ボックスを一つ以上オンにします。

4. クエリ ツール バーで、**[実行]**を 選択し、クエリが意図した結果を返すことを確認します。

5. クエリのフィルター条件を変更し、目的の作業項目の氏名を番目の層を取得するまでクエリを再実行してください。

フィルターの critera を作業項目のツリーに指定するには

1. **[リンクされた作業項目用フィルター]**の下で、トップレベルの条件の設定を定義した句と同様に追加し、グループ化します。

2. 次のように、作業項目の第層リストをフィルター処理 [リンクしているフィルター] を選択する:

   1. 最上位の作業項目に最初に一致します。***: トップダウンを検索します。すべての最初の層の作業項目が返されます。最初のレイヤーにリンクされているすべての作業項目はリンクされた作業項目のフィルター条件に一致する場合。

   2. [リンクされた作業項目を最初に照合する]: ボトムアップ検索します。すべてのリンクされた作業項目を検索し、見つかった項目にリンク最初の層の作業項目を返します。

3. (省略可能) **[ツリーの種類]**を選択します。ツリー トポロジのカスタムのリンクの種類を追加した場合、カスタム セットの階層リンクの種類に示されている値から選択できます。「リンクの種類要素のリファレンス」を参照してください。

4. クエリ ツール バーで、**[実行]**を 選択し、クエリが意図した結果を返すことを確認します。

5. クエリのフィルター条件を変更し、目的の作業項目の氏名を番目の層を取得するまでクエリを再実行してください。

ページのトップへ

4.、またはグループ解除のクエリ句を追加、削除、グループ化します。

各作業項目フィールドに対して新しい句を 1 つ追加して検索条件を絞り込み、目的の作業項目セットのみを返すようにできます。クエリから予期していた結果が得られなかった場合は、クエリ句を追加、削除、グループ化、またはグループ解除し、クエリ結果を絞り込むことができます。クエリ句の要素については、「クエリ フィールド、演算子、値および変数」を参照してください。

クエリ句はフィールド名、クエリ演算子、および値で構成されます。有用な結果を得るために必要な句をいくつでも使用できます。

数式または論理ステートメントの一部をかっこで囲むことに似ていますが、クエリの残りの部分とは別に一つの単位として操作するためのクエリ句をグループ化できます。句をグループ化する場合、グループ内の最初の句の および か または は、グループ全体に適用されます。

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

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

クエリ句を追加、削除、グループ化、またはグループ解除するには

1. 次のいずれかの方法で句を追加します。

   1. クエリのフィルター条件の最後に句を追加するには、新しい句を追加するには、ここをクリックしてくださいを選択します。

   2. または、句を挿入、行を強調表示するに句を挿入する最初の列のセルを選択するには、ショートカット メニューを開き、[句の挿入]を選択します。

      新しいクエリ句の行が、ポインターを置いた場所に追加されます。

   3. 句に または の句として扱う場合は矢印ボタンを およびの横にあるを選択し、またはを選択します。

      句、および前の句がなければ結果が一致する true の場合は および を選択します。この句または前の句が結果に一致する true の場合は または を選択します。

   4. [フィールド]、[演算子]、および [値] の値を指定します。

      クエリ列	使用方法
      フィールド	検索する作業項目の種類のフィールドを指定します。作業項目のセットは、フィールドに対して定義された演算子および値に基づいてフィルター処理されます。 Alt キーを押しながら↓キーを押すか、選択するフィールド名を入力してください。
      [演算子]	レコード内の指定したフィールドで検出された値をクエリが比較する方法を指定します。演算子の選択の対象として、たとえば [=] (等しい)、[<>] (等しくない)、[>] (より大きい)、[<] (より小さい)、[>=] (以上)、[<=] (以下)、[次の値を含む]、[次の値を含まない]、[次の値に含まれる]、[次の値と等しかったことがある] があります。
      値	選択したフィールドで検索する値を指定します。値の一覧の中から選択する場合は、矢印をクリックして、目的の値を選択します。クエリ変数を指定すると、クエリに値を動的に追加できます。 値の一覧の中から選択する場合は、矢印をクリックして、目的の値を選択します。フィルター処理する値が複数ある場合は、[次の値のいずれか] 演算子を使用し、値のコンマ区切りリストを指定します。動的な値を指定するには、有効なクエリ変数を指定します。

      詳細については、「クエリ フィールド、演算子、値および変数」を参照してください。

2. クエリ句を削除するには、句のショートカット メニューを開き、**[句の削除]**を選択 します。

3. 作業項目クエリ句をグループ化するには、次の手順を実行します。

   1. クエリ内で、行の左端にあるセルを選択して、グループに含めるクエリ句を選択します。複数の行を選択するには、Ctrl キーを押しながらクリックします。

   2. 選択した句のショートカット メニューを開き、**[句のグループ化]**を選択 します。

      句がグループ化されたことを示す角かっこが、クエリの左端余白に表示されます。

4. 作業項目クエリ句をグループ解除するには、次の手順を実行します。

   1. クエリ内で、行の一番左のセルをクリックして、グループ解除するクエリ句のグループ全体を選択します。複数の行を選択するには、Ctrl キーを押しながらクリックします。

   2. グループのショートカット メニューを開き、**[句のグループ解除]**を選択 します。

      クエリの左端余白から角かっこが除かれ、句がグループ解除されます。

      [!メモ]

      [句のグループ解除] が使用できない場合、クエリのグループに含まれる句の中に、選択されていないものがあります。すべての句を選択してから、もう一度操作してください。

ページのトップへ

5.クエリの結果とチェックを実行または中止し、

作業項目クエリを実行すると、クエリの抽出条件に一致する作業項目をチーム プロジェクト内で検索できます。作業項目に変更を加えることによってクエリ結果が変わる場合には、クエリを再実行してクエリ結果を更新できます。

1. クエリ ツール バーで、**[実行]**を選択 します。

   [!メモ]

   検索中の作業項目に対して定義されたフィールドを追加すると、クエリ結果がどのように表示され、並べ替えられるかを制御できます。詳細については、「列の追加、削除、順序変更、および並べ替え」を参照してください。

2. クエリの検索を取り消すには、[クエリの停止]を選択するか、または、[チーム] で、メニューの **[更新の中止]**を選択します。

3. クエリ結果を確認します。作業項目の一覧が、予期していた検索条件と一致しない場合は、必要に応じてフィルター条件を見直し、変更します。

ページのトップへ

6.クエリのフィルター条件を調整します。

• クエリ結果が、予期していた作業項目セットを返さなかった場合は、次のチェックを実行します。

  • 各句をチェックし、意図したとおりに定義されているかどうかを確認します。

  • 各句に [And/Or] の割り当てをチェックします。予期していた数よりも多くの作業項目が結果に含まれる場合は、AND 句ではなく OR 句が使用されています。

  • クエリ句のグループと、グループ化された句の AND/OR の割り当てをチェックします。

  • クエリ句をさらに追加し、クエリのフィルター条件を絞り込みます。

  • 「クエリ フィールド、演算子、値および変数」で説明したように、フィールド、演算子、および値を指定するためのオプションを確認します。クエリ句を変更し、別のフィールド、演算子、または値を使用するかどうかを決定します。

ページのトップへ

参照

処理手順

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

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

概念

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

作業項目クエリの例

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

その他の技術情報

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