区分パスを定義してチームに割り当てる

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

製品、機能、またはビジネス領域に基づいてチームをサポートし、作業項目をグループ化するためのエリア パスを追加します。 プロジェクト レベルでエリア パスを定義したら、チーム構成でチームに割り当てます。 サブエリアをサポートするエリア パスの階層を作成することもできます。深さは最大 14 レベルです。

次のタスクを実行するには、区分パスを定義する必要があります。

• 区分パスに基づく作業項目のクエリとグラフ化
• 複数のチームに作業を割り当てる
• 管理チームと機能チームとの連携
• 区分パスを使ってバックログ、クエリ、ボード、計画をフィルター処理する

ヒント

区分パスの構造を定義し、チームに区分パスを割り当てることができます。 または、チームを追加し、そのときにチーム名で区分パスを作成することもできます。 チームが完全に独立している場合は、フラットな区分パスのセットを作成します。 ただし、チームの階層を作成する場合は、ツリー階層の区分パスを作成する必要があります。 詳細については、「チームの階層を構成する」を参照してください。

次のツールを使うには、チームが区分パスをサブスクライブする必要があります。

• ボード > すべてのツール
• バックログ > すべてのツール
• スプリント > すべてのツール
• 配信計画
• ロールアップ
• 分析 > すべて

システムでのエリア パスの使用方法については、「 領域パスと反復パス」を参照してください。

前提条件

• プロジェクトがまだない場合は、 今すぐ作成します。

• ルート ノードの下に領域パスを追加したり、子ノードを編集または削除したりするには、 Project Administrators グループのメンバーであることを確認します。 これらのアクセス許可を取得するには、「 Change プロジェクト レベルのアクセス許可を参照してください。

• ノードの下にエリア パスを追加、編集、管理するには、次の 1 つ以上のアクセス許可を Allow に設定します。

  • 子ノードを作成します
  • このノードを削除します
  • このノードを編集します
  • このノードのアクセス許可を表示する

  既定では、プロジェクトを作成したユーザーには、これらのアクセス許可が既に設定されています。 詳細については、「作業追跡のアクセス許可とアクセスを設定する」を参照してください。

• チーム管理者として追加されているかプロジェクト管理者グループのメンバーであることを確認して、チームエリアパスを設定します。

エリア パスの名前付け制限については、「 領域とイテレーションについて」の「名前付けの制限」を参照してください。

作業の開始

各チームは、「 チームとアジャイル ツールで説明されているように、多くのアジャイル ツールにアクセスできます。 各ツールは、チームの既定のエリア パスを参照します。 ほとんどのチームは、作業追跡アクティビティをサポートするために、1 つのエリア パスと複数のイテレーション パスを選択します。 ただし、他のシナリオをサポートするために、チームはバックログとボードに表示する複数のエリア パスを選択できます。

新しいプロジェクトには、プロジェクト名に対応する単一のルート領域が含まれています。 同じプロジェクト名でチームが作成され、ルート領域のパスがそのチームに割り当てられます。

プロジェクトとチームの管理を初めて使用する場合、プロジェクトとチームを構成するための最も簡単な順序は次のとおりです。

1. 作業を分類するためにサポートするエリア パスの数と名前を決定します。 少なくとも、定義したチームごとに 1 つのエリア パスを追加します。 詳細については、「 領域とイテレーションについてを確認してください。
2. サポートするチームの数と名前を決定します。 詳細については、「 チームとアジャイル ツールについてを確認してください。
3. Project の設定>プロジェクト構成>Areasを開き、プロジェクト レベルで手順 1 と 2 をサポートする領域パスを定義します。 この記事で後述する「 エリア パスの追加」の手順に従ってください。
4. 手順 2 をサポートするために必要なチームを定義します。 詳細については、「 チームを追加し、1 つの既定のチームから複数のチームに移行するを参照してください。
5. チーム構成を開き、各チームに既定およびその他の領域パスを割り当てます。 次の手順に従います チームの既定のエリア パスを設定します。
6. 作業項目の領域パスを、定義したエリア パスに割り当てます。 一括変更を使用して、複数の作業項目を一度に変更します。

Note

複数のチームに同じ領域パスを割り当てることができますが、2 つのチームが同じ作業項目のセットに対して所有権を要求すると、問題が発生する可能性があります。 詳細については、「 ボードとかんばん、マルチチーム ボード ビューの制限事項を参照してください。

必要に応じて、いつでも次のアクションを実行できます。

• 他の子ノードを追加する
• エリア パスの名前を変更する (ルート エリア パスを除く)
• 子ノードを別のノードの下に移動する
• 子ノードを削除する
• チームの名前を変更する
• チームに対して行われたエリア パスの割り当てを変更する

プロジェクト領域を一覧表示する

重要

お使いのプラットフォームとバージョンに対応するこの記事のバージョンを選択します。 バージョン セレクターは目次の上にあります。 Azure DevOps のプラットフォームとバージョンを検索します。

プロジェクトの領域とイテレーションの両方を、 Project Settings>Boards>Project 構成から定義します。

ブラウザー

• Web ポータルで 、(1) プロジェクト設定を選択し、(2) プロジェクト構成 、(3) Areas を選択します。

  

Azure DevOps CLI

プロジェクトエリアパスのリスト | プロジェクトエリアパスの追加 | チームエリアパスのリスト | チームエリアパスの設定 | プロジェクトエリアパスの設定 | チームからのエリアパスの削除

az boards area project list を使用して、プロジェクトに定義されている領域パスを一覧表示できます。 開始するには、「Azure DevOps CLI の概要」を参照してください。

az boards area project list [--depth]
                            [--path]
                            [--project]

パラメーター

• depth: 省略可能。 一覧表示する子ノードの深さ。 例: --depth 3。 指定しない場合は、最上位レベルのエリア パスのみが返されます。
• path: 省略可能。 区分の絶対パス。 \Area\ は、このパスと反復パスを区別する \ProjectNameの後に続く必要があります。 たとえば、--path \ProjectName\Area\AreaName のようにします。 ノード内でスペースを使用する場合は、二重引用符で囲みます (例: --path "\Fabrikam Fiber\Area\Service Delivery\Performance")。 指定しない場合は、ルート レベルからのエリア パスが一覧表示されます。
• project: 省略可能。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".

例

たとえば、次のコマンドは、Fabrikam Fiber プロジェクトの深さ 3 までの領域パスを一覧表示します。 その他の出力形式オプションについては、「 Azure CLI コマンドの出力形式」を参照してください。

az boards area project list --depth 3 --project 'Fabrikam Fiber' --output table
ID     Identifier                            Name                Path                                                Has Children
-----  ------------------------------------  ------------------  --------------------------------------------------  --------------
55302  91d8644a-e430-4fd0-aa95-742ea98770a3  Fabrikam Fiber      \Fabrikam Fiber\Area                                True
55373  26be05fd-e68a-4fcb-833f-497f6bee45f2  Service Delivery    \Fabrikam Fiber\Area\Service Delivery               True
55303  637dc203-0549-4415-9663-b6358ac27d21  Internet            \Fabrikam Fiber\Area\Service Delivery\Internet      False
55306  3f2067f9-684f-4121-8004-4a4745198b39  Voice               \Fabrikam Fiber\Area\Service Delivery\Voice         False
55372  4afc9ede-db1d-4703-8be6-95899b99be44  Email               \Fabrikam Fiber\Area\Service Delivery\Email         False
55381  f96d4738-c67e-42d0-bd4e-99f6b3fdeb22  Service Status      \Fabrikam Fiber\Area\Service Delivery\Service S...  False
55384  3a0c1189-6454-4ccd-9354-d72b653b7f74  TV                  \Fabrikam Fiber\Area\Service Delivery\TV            False
55380  4ea27e90-248c-41a0-8d11-eace6c9fd90e  Account Management  \Fabrikam Fiber\Area\Account Management             True
55382  4235f40d-753b-49dd-868f-82372065ec83  Shopping Cart       \Fabrikam Fiber\Area\Account Management\Shoppin...  False
55383  49d34650-6c65-446c-aff6-79edd3a21a75  Customer Profile    \Fabrikam Fiber\Area\Account Management\Custome...  False

エリア パスを追加する

既定では、ルート領域は 1 つだけ定義されます。 プロジェクトのルート領域パスの下に、または別のエリア パスまたはチームに子として、新しい子エリア パスを追加します。 既定では、新しいエリア パスがルート ノードに追加されます。

チームにエリア パスを追加することもできます。 詳細については、「 チームエリアパスの設定」を参照してください。

ブラウザー

[プロジェクトの設定] に移動し、[ プロジェクト構成>Areas を選択します。

新しいエリア パスを追加するには:

1. エリア パスを強調表示し、[新しい子を選択します。 必要に応じて、エリア パスの を選択して New を選択するか、領域一覧の上部にある New メニュー項目を選択できます。

2. ノードの名前 (255 文字以下) を入力します。 名前の制限の詳細については、「 領域とイテレーションの詳細」の名前付け制限を参照してください。

   

3. [保存して閉じる] を選択します。

すべての新しい領域が子ノードとしてルート領域パスに追加されます。

子領域パスを追加するには:

1. エリア パスを強調表示し、[新しい子を選択します。 必要に応じて、エリア パスのを選択し、[新しい子] 選択するか領域の一覧の上部にあるメニューから [新しい子を選択します。

2. ノードの名前 (255 文字以下) を入力します。 名前の制限の詳細については、「 領域とイテレーションの詳細」の名前付け制限を参照してください。

   

3. [保存して閉じる] を選択します。

エリア パスは、 Team 構成>Areas ページでチームに追加することもできます。

Azure DevOps CLI

領域のパスは、 az boards area プロジェクトの作成を使用してプロジェクトに追加できます。 開始するには、「Azure DevOps CLI の概要」を参照してください。

--pathパラメーターを指定すると、新しいエリア パスが子ノードとして指定したパスに追加されます。 --path パラメーターを指定しない場合、新しいエリア パスが子ノードとしてルート ノードに追加されます。

az boards area project create --name
                              [--path]
                              [--project]

パラメーター

• name:必須。 エリア パス名。
• path: 省略可能。 区分の絶対パス。 例: --path \ProjectName\Area\AreaName。 指定しない場合は、ルート レベルで領域を追加します。
• project: 省略可能。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".

例: JSON 形式

たとえば、次のコマンドは、ルート ノードの Fabrikam Fiber プロジェクトに音声領域パスを追加します。

az boards area project create --name Voice --project "Fabrikam Fiber"
{
  "attributes": null,
  "children": null,
  "hasChildren": false,
  "id": 55412,
  "identifier": "b00f86a2-3d49-4ad2-af01-da2537947baa",
  "name": "Voice",
  "path": "\\Fabrikam Fiber\\Area\\Voice",
  "structureType": "area",
  "url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/_apis/wit/classificationNodes/Areas/Voice"
}

例: テーブル形式

テーブル出力形式と同じコマンドを次に示します。

az boards area project create --name Voice --project "Fabrikam Fiber" --output table
ID     Identifier                            Name    Path                         Has Children
-----  ------------------------------------  ------  ---------------------------  --------------
55413  3c16691b-160c-4498-ab42-aa77b7f354fc  Voice  \Fabrikam Fiber\Area\Voice  False

チーム領域のパスを一覧表示する

チームの既定値はチーム設定から設定します。 チーム管理者でない場合は、 1 つとして追加します。 チーム設定を変更できるのは、チーム管理者またはプロジェクト管理者だけです。

ブラウザー

1. プロジェクトを開き、 プロジェクト設定>Team 構成>Areas を選択します。

   

2. チーム コンテキストを切り替える必要がある場合は、階層リンク内のチーム セレクターを使用します。

   

Azure DevOps CLI

az boards area team list を使用して、チームに対して定義されたエリア パスを一覧表示できます。 開始するには、「Azure DevOps CLI の概要」を参照してください。

az boards area team list --team
                         [--project] 

パラメーター

• team: 必須。 チームの名前または ID。
• project: 省略可能。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".

たとえば、次のコマンドは、Service Delivery チームのエリア パスを一覧表示します。 その他の出力形式オプションについては、「Azure CLI コマンドの出力形式」を参照してください。

az boards area team list --team "Service Delivery" --project "Fabrikam Fiber" --output table
Area                             Include sub areas    Is Default
-------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery  True                 True

チーム プロファイルからチーム設定を開く

領域とイテレーションの両方を Project Settings > Team 構成から定義します。 チーム作業追跡バックログ、ボード、またはダッシュボードからすばやく移動できます。

1. チームのバックログまたはボードを開き、 Team プロファイル >Team 設定を選択します。

   ここでは、Fabrikam ファイバー チームのボードを開き、そこからチーム プロファイルを開きます。

   

2. [ イテレーションと領域] を選択します。

   

3. チーム コンテキストを切り替える必要がある場合は、階層リンク内のチーム セレクターを使用します。

   

チーム区分パスの設定

チーム領域パスに割り当てられているすべての作業項目は、そのチームのバックログとボードに表示されます。 1 つ以上のエリア パスを選択し、必要に応じてサブエリア パスを含めることができます。 複数のチームまたは領域で行われた作業のロールアップ ビューをサポートする場合は、サブエリア パスを含めるように選択します。

Note

Teams には最大 300 個の エリア パスを割り当てることができます。 詳細については、「 作業の追跡、プロセス、およびプロジェクトの制限」を参照してください。

既定のエリア パスは、チーム コンテキストから作成された作業項目に割り当てられた既定のエリア パスを決定します。

重要

複数のチームのボードに表示される作業項目は、期待を満たさないクエリ結果を生成する可能性があります。 各チームはボード 列 および swimlanesをカスタマイズできるため、異なるボードに表示される作業項目に割り当てられた値は同じではない可能性があります。 この問題の主な回避策は、チーム区分パスによって作業項目の単一所有権を維持することです。

ブラウザー

既存のエリア パスを選択することも、チーム設定から新しいエリア パスまたは子エリア パスを作成することもできます。

1. プロジェクト設定>Team 構成>Areas を選択します。

2. ページの上部にあるドロップダウン リストから、構成するチームを選択します。

   ここでは、Fabrikam ファイバー チームの領域を示します。

   

3. チームでアクティブにする 1 つ以上のエリア パスを選択します。

   

   この例では、プロジェクトのサブエリア パスをアクティブ化することを選択します。 管理チームは、すべてのチームの進行状況を追跡できるようになりました。

   

4. 完了したら、チームの製品バックログ ページを更新すると、チームに割り当てられている作業項目が表示されます。 表示された列に領域パスを追加して、作業項目に対して行われた割り当てを表示します。

   

   

Azure DevOps CLI

チームの既定のエリア パスを設定したり、エリア パスを追加したりするには、 az boards area team addを使用します。 開始するには、「Azure DevOps CLI の概要」を参照してください。

az boards area team add --path  --team
                        [--include-sub-areas {false, true}]
                        [--project]
                        [--set-as-default]

パラメーター

• path: 必須。 区分の絶対パス。 例: --path \ProjectName\AreaName。
• team: 必須。 チームの名前または ID。
• include-sub-areas: 省略可能。 エリア パスの子ノードを含めます。 使用できる値: false、true。
• project: 省略可能。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".
• set-as-default: 省略可能。 チームの既定のエリア パスとして指定します。 既定値は False です。

例

たとえば、次のコマンドは、Fabrikam Fiber プロジェクトの Voice チームに音声領域パスを追加し、それを既定として設定し、サブエリアを含めます。

az boards area team add --path "\Fabrikam Fiber\Voice" --team Voice --project "Fabrikam Fiber" --include-sub-areas --set-as-default --include-sub-areas true --output table
Area                                   Include sub areas    Is Default
-------------------------------------  -------------------  ------------
Fabrikam Fiber\Service Delivery\Voice  False                False
Fabrikam Fiber\Voice                   True                 True

エリア パスの名前を変更または移動する

更新されたエリア パスを参照する作業項目とクエリは、システムによって自動的に更新されます。 各 Area パス は一意の GUID に関連付けられます。

ブラウザー

1. Area Path の名前を変更するには、Web ポータルの Project 設定>Project 構成>Areas ページを開きます。

2. ノードの コンテキスト メニューを選択し、 Edit を選択します。

   

3. 開いたダイアログで、新しい名前を入力します。

   

4. 階層内のノードを移動するには、 Location フィールドを変更します。

   Note

   ノードの Location フィールドの名前を変更すると、 Area パスを参照する既存の作業項目が自動的に更新されます。

Azure DevOps CLI

プロジェクトの領域パスの名前を変更または移動する

az boards area project updateコマンドを使用して、プロジェクトの領域パスの名前を変更または移動できます。 開始するには、「 Azure DevOps CLI の使用を開始する」を参照してください。

az boards area project update --path
                              [--child-id]
                              [--name]
                              [--project]

• path: 必須。 区分の絶対パス。 例: --path \ProjectName\AreaName。
• child-id: 省略可能。 既存の領域パスを移動し、指定したパス名または ID の子ノードとして追加します。
• name: 省略可能。 エリア パスの新しい名前を指定します。
• project: 省略可能。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".

例

たとえば、次のコマンドは、Fabrikam Fiber プロジェクトの Voice area パスの名前を Voice および Web に変更します。

az boards area project update --path "\Fabrikam Fiber\Area\Voice" --name "Voice and Web" --project "Fabrikam Fiber" --output table
ID     Identifier                            Name           Path                                Has Children
-----  ------------------------------------  -------------  ----------------------------------  --------------
55412  b00f86a2-3d49-4ad2-af01-da2537947baa  Voice and Web  \Fabrikam Fiber\Area\Voice and Web  False

チームからエリア パスを削除する

チームからエリア パスを削除するには、 az boards area team removeを使用します。

az boards area team remove --path
                           --team
                           [--project]

パラメーター

• path: 必須。 区分の絶対パス。 例: --path \ProjectName\AreaName。
• team: 必須。 チームの名前または ID。
• project: 省略可能。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber".

例

たとえば、次のコマンドは、Fabrikam Fiber プロジェクトの音声チームから \Service Delivery\Voice エリア パスを削除します。

az boards area team remove --path "\Fabrikam Fiber\Service Delivery\Voice" --team Voice --project "Fabrikam Fiber" --output table

エリア パスを削除する

Area パスを削除する場合は、削除するエリア パスに割り当てられている作業項目を更新するために使用するエリア パスを指定する必要があります。

重要

• Area パスの削除または Iteration Paths の再構成により、元に戻せないデータ損失が発生します。 たとえば、 Area Paths が変更されたチームのバーンダウンおよびバーンアップ ウィジェット グラフ、スプリント バーンダウン、ベロシティ グラフでは、正確なデータは表示されません。 履歴傾向グラフは、作業項目ごとに定義された エリア パス と Iteration Path を参照します。 一度削除すると、これらのパスの履歴データを取得することはできません。
• 削除できるのは、作業項目で使用されなくなった領域パスと反復パスのみです。

1. Area パスを削除するには Web ポータル Project 設定>Project 構成>Areas ページを開きます。

2. ノードのコンテキスト メニューを 選択し、[ 削除 ] または [ 削除] を選択します。

3. 開いたダイアログで、作業項目を再割り当てする Area Path を選択し、 Delete パスを選択します。

   

エリア別の進行状況をグラフ化する

クエリをすばやく生成してエリア パスに基づいて進行状況を表示できます。 たとえば、次の積み上げ横棒グラフに示すように、各チームのエリア パスに割り当てられている作業項目の進行状況表示します。 エリア パスのリーフ ノードを取得するには、[ノード名]を選択します。

Q & A

Q: チームにエリア パスを割り当てる必要はありますか。

A: いいえ。 チームにエリア パスを割り当てて、そのエリア パスに割り当てられた作業項目がチームのバックログとボードに表示されるようにします。 既定では、すべての作業項目がルート領域パスに割り当てられます。 これらの作業項目は、プロジェクトに対して定義されている既定のチームに表示されます。

次のステップ

イテレーション パスまたはスプリントを設定する

関連記事

ご覧のように、エリア パスは、アジャイル ツール、チーム、作業項目の管理をサポートする上で大きな役割を果たします。 これらのフィールドの操作の詳細については、次の記事を参照してください。

• 領域とイテレーションについて
• 別のチームを追加する
• チーム設定を構成し、チーム管理者を追加する
• 領域またはイテレーションに依存するアジャイル ツール
• 領域または反復パスによるクエリ
• 作業を追跡するためのアクセス許可とアクセス権の設定

プログラムによるリソース

エリア パスと反復パスは、 分類ノードとも呼ばれます。

• az boards area (Azure DevOps CLI)
• Teams (REST API)
• 分類ノード (REST API)