次の方法で共有

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

  • [アーティクル]

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

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

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

必須コンポーネント

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

メモ

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

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

メモ

次のマクロは、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
イテレーション パス 名前付きスプリントまたは期間により作業項目を分類します。 このイテレーションは、プロジェクト階層で有効なノードである必要があります。 システム.イテレーションパス

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

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

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

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

フィールド名 説明 参照名 データ型
エリア識別子 この作業項目が割り当てられている領域の一意の ID。 System.AreaId 整数
イテレーション ID この作業項目が割り当てられているイテレーションの一意の ID。 System.IterationId (システム.イテレーションID) 整数
Node Name (ノード名) 領域パスの最後のノード名。 たとえば、領域パスが Project\A1\B2\C3 の場合、ノード名は C3 になります。 System.NodeName String

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

REST API

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