区分またはイテレーション パスによるクエリの実行

  • [アーティクル]

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

区分パスとイテレーション パスは、すべての作業項目の種類の作業追跡フォームに表示される 2 つのフィールドです。 プロジェクト (区分パスとイテレーション パス) に対して定義し、チームに関連付けるものを選択します。

区分およびイテレーション パスを操作する方法をよく理解するには、「チームおよびアジャイル ツールについて」を参照してください。

注意

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

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

クエリを作成し、[区分パス] および [イテレーション パス] フィールドを指定する場合は、次の演算子を使用できます。

演算子 使用するタイミング
= 特定の区分またはイテレーション パスを 1 つ指定します
<> 1 つの特定の区分またはイテレーション パスをフィルターで除外します。
In 区分またはイテレーション パスのセットをフィルターで除外します。
Not In 区分またはイテレーション パスのセットに割り当てられている項目を除外します。
Under 選択した区分またはイテレーション パスの下にあるすべてのパスを指定します。
Not Under 特定の区分またはイテレーション パスの下に割り当てられた項目を除外します。

これらの演算子と共に、[イテレーション パス] を選択すると、次のマクロを使用できます。 例については、「日付または現在のイテレーションによるクエリの実行」を参照してください。

マクロ 使用するタイミング
@CurrentIteration 選択したチーム コンテキストに関連付けられている現在のイテレーションを指定します。
@CurrentIteration +/- n 選択したチーム コンテキストに関連付けられたスプリントのスライディング ウィンドウへの割り当てに基づいて項目をフィルター処理します。
@TeamAreas 特定のチームに割り当てられた区分パスに基づいて項目をフィルター処理します。

注意

@CurrentIteration +/- n および @TeamAreas マクロは、Azure DevOps Server 2019 以降のバージョンでサポートされています。 これらのマクロは、Web ポータルからのみサポートされています。 これらのマクロを含むクエリは、Visual Studio/チーム エクスプローラー、Microsoft Excel、または Microsoft Project で開くと機能しません。

区分パス クエリ

次の例に示すように、In 演算子を使用して、複数の区分パスに割り当てられた作業項目をフィルター処理するように指定できます。

複数の区分の区分パスに対するクエリ

ノード名とキーワードに基づくクエリ

[ノード名] フィールドを使用すると、Contains 演算子を使用して、キーワードに基づいて区分パスに割り当てられた作業項目をフィルター処理できます。 [ノード名] は、ツリー階層内の最後のノードに対応する区分パスの最後のノードを指定します。

次のクエリでは、前の例と同じ結果が生成されます。

複数の区分のノード名に対するクエリ

この例では、フィルターは、最後のノードに「Azure」という単語が含まれているエリア パスに割り当てられた作業項目を返します。

複数のスプリントのクエリ

[ノード名] と In 演算子を使用する別の例を次に示します。

複数の区分のノード名に対するクエリ

チーム区分パス クエリ

@TeamAreas マクロを使用すると、特定のチームに割り当てられた区分パスに割り当てられている項目をすばやく検索できます。 = 演算子を指定します。 クエリ エディターは、チームの名前を入力するように求めるプロンプトを自動的に表示します。 チーム名を入力し、検索フィルタ条件に表示されるチーム値を選択することで追加できます。

チームに割り当てられた区分パスに対するクエリ

分類フィールド参照

フィールド名 説明 参照名
区分パス 作業項目を製品機能区分またはチーム区分に分類します。 この区分は、プロジェクト階層で有効なノードである必要があります。 System.AreaPath
イテレーション パス 名前付きスプリントまたは期間により作業項目を分類します。 このイテレーションは、プロジェクト階層で有効なノードである必要があります。 System.IterationPath

各フィールドについて、data path=TreePath、reportable type=Dimension、index attribute=True。

256 文字を超えるパス名を定義した場合、Microsoft Project ではそれを指定できません。 この問題を避けるには、パス名を 10 文字以下で定義し、ノードの入れ子レベルを 14 レベル以下にしてください。

ほとんどのフィールド ルールは、System.AreaPath や System.IterationPath フィールドなどのシステム フィールドに適用できません。 詳細については、「規則と規則の評価」を参照してください。

次のフィールドは、作業項目フォームには表示されませんが、作業項目の種類ごとに追跡されます。 これらのフィールドは、プロジェクトにおいて定義されている各分類値に対する数値を示します。 クエリのフィルター処理およびレポートの作成に、これらのフィールドを使用できます。

フィールド名 説明 参照名 データの種類
区分 ID この作業項目に割り当てられている区分の一意の ID。 System.AreaId Integer
イテレーション ID この作業項目が割り当てられているイテレーションの一意の ID。 System.IterationId Integer
Node Name (ノード名) 区分パスの最後のノードの名前。 たとえば、区分パスが Project\A1\B2\C3 の場合、ノード名は C3 です。 System.NodeName String

既定のレポート可能な種類は none です。 区分 ID とイテレーション ID はインデックス付けされ、ノード名はされません。 フィールド属性の詳細については、「作業項目のフィールドと属性」を参照してください。

REST API

プログラムでクエリを操作するには、次の REST API リソースのいずれかを参照してください。