次の方法で共有

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

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

[領域パス] フィールドと [反復パス] フィールドは、すべての作業項目の種類のすべての作業項目フォームに表示されます。 プロジェクトのこれらのパス (エリア パス と イテレーション パス) を定義し、チームに関連付けるパスを選択します。

領域パスとイテレーション パスを操作する方法については、「 チームとアジャイル ツールについて」を参照してください。

Prerequisites

Category Requirements
アクセス レベル 共有クエリを表示して実行するには、プロジェクトメンバーである必要があります。
- 共有クエリを追加して保存するには:少なくとも Basic アクセス。
Permissions クエリを追加するフォルダーで [共同作成] アクセス許可が [許可] に設定されていること。 既定では、共同作成者グループにはこのアクセス許可がありません。

Note

パブリック プロジェクトの 利害関係者 アクセスが付与されたユーザーは、 基本 アクセスが付与されたユーザーと同様に、クエリ機能へのフル アクセス権を持っています。 詳細については、「利害関係者アクセスクイック リファレンス」を参照してください。

Category Requirements
アクセス レベル 共有クエリを表示して実行するには、プロジェクトメンバーである必要があります。
共有クエリを追加して保存するには：少なくとも Basic アクセスが必要です。
Permissions クエリを追加するフォルダーで [共同作成] アクセス許可が [許可] に設定されていること。 既定では、共同作成者グループにはこのアクセス許可がありません。

Note

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

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

クエリを作成し、[エリア パス] フィールドと [反復パス] フィールドを指定する場合は、次の演算子を使用できます。

Operator したいときに使用します。
= 特定の領域またはイテレーション パスを 1 つ指定する
<> 1 つの特定の領域または反復パスを除外する
In 領域または反復パスのセットにフィルターをかける
Not In 一連の領域または反復パスに割り当てられた項目を除外する
Under 選択した領域または反復パスの下にあるすべてのパスを指定する
Not Under 特定の領域または反復パスの下に割り当てられた項目を除外する

[反復パス] フィールドを選択すると、次のマクロを使用できます。 例については、このページのクエリの例を参照してください。

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

Note

Azure DevOps Web ポータルでは、 @CurrentIteration、 @CurrentIteration +/- n、 @TeamAreas (サービスとサーバー) などのマクロが評価されます。 Web 以外のクライアント (Visual Studio/Team Explorer、Excel、Project) と直接 WIQL/REST 呼び出しには、明示的な領域/反復パスが必要であり、未加工のマクロ トークンを受け入れられません。 Web UI にクエリを保存すると、通常、ポータルは、保存されている WIQL 内の具体的な値にマクロを展開します。Web UI の外部でクエリを使用する必要がある場合は、環境内でこの動作を確認します。

区分パス クエリ

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

複数の領域のエリア パスに対するクエリを示すスクリーンショット。

ノード名とキーワードベースのクエリ

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

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

複数の領域のノード名に対するクエリを示すスクリーンショット。

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

複数のスプリントのクエリを示すスクリーンショット。

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

複数の領域のノード名に対するクエリを示すスクリーンショット。

チームエリアパスのクエリ

@TeamAreas マクロを使用して、特定のチームが使用するエリア パスに割り当てられているアイテムを検索します。 = 演算子を指定します。 クエリ エディターでは、チーム名の入力を求められます。候補リストからチームを選択します。

チームに割り当てられたエリア パスに関するクエリを示すスクリーンショット。

分類フィールド リファレンス

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

フィールドごとに、data path=TreePath、reportable type=Dimension、index attribute=True。

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

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

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

フィールド名 Description 参照名 データの種類
エリア識別子 この作業項目を割り当てる領域の一意の ID。 System.AreaId Integer
イテレーション ID この作業項目を割り当てるイテレーションの一意の ID。 System.IterationId Integer
ノード名 領域パスの最後のノード名。 たとえば、領域パスが Project\A1\B2\C3 の場合、ノード名は C3 になります。 System.NodeName String

既定のレポート可能な種類は none です。 エリア ID と反復 ID にはインデックスがあります。 ノード名は存在しません。 フィールドの属性の詳細については、 作業項目のフィールドと属性を参照してください。

関連コンテンツ

REST API

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