区分パスを定義してチームに割り当てる
[アーティクル] 07/03/2024
9 人の共同作成者
フィードバック
この記事の内容
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
製品、機能、またはビジネス領域に基づいてチームをサポートし、作業項目をグループ化するためのエリア パスを追加します。 プロジェクト レベルでエリア パスを定義したら、チーム構成でチームに割り当てます。 また、エリア パスの階層を作成して、サブエリア (最大 14 レベルの深さ) をサポートすることもできます。
次のタスクを実行するには、区分パスを定義する必要があります。
ヒント
区分パスの構造を定義し、チームに区分パスを割り当てることができます。 または、チームを追加し、そのときにチーム名で区分パスを作成することもできます。 チームが完全に独立している場合は、フラットな区分パスのセットを作成します。 ただし、チームの階層を作成する場合は、ツリー階層の区分パスを作成する必要があります。 詳細については、「チームの階層を構成する 」を参照してください。
次のツールを使うには、チームが区分パスをサブスクライブする必要があります。
システムでのエリア パスの使用方法については、「 領域パスと反復パス」を参照してください 。
前提条件
プロジェクトがまだない場合は、 今すぐ作成します 。
ルート ノードの下に領域パスを追加したり、子ノードを編集または削除したりするには、 Project Administrators グループのメンバーであることを確認します。 これらのアクセス許可を取得するには、「 Change プロジェクト レベルのアクセス許可 を参照してください。
ノードの下にエリア パスを追加、編集、管理するには、次の 1 つ以上のアクセス許可を Allow に設定します。
子ノードを作成します このノードを削除します このノードを編集します このノードのアクセス許可を表示する
既定では、プロジェクトを作成したユーザーには、これらのアクセス許可が既に設定されています。 詳細については、「作業追跡のアクセス許可とアクセスを設定する 」を参照してください。
チーム管理者として追加されているか プロジェクト管理者 グループのメンバーであることを確認して、チームエリアパスを設定します。
エリア パスの名前付け制限については、「 領域とイテレーションについて」の「名前付けの制限 」を参照してください。
作業の開始
各チームは、「 チームとアジャイル ツール で説明されているように、さまざまなアジャイル ツールにアクセスできます。 各ツールは、チームの既定のエリア パスを参照します。 ほとんどのチームは、作業追跡アクティビティをサポートするために、1 つのエリア パスと複数のイテレーション パスを選択します。 ただし、他のシナリオをサポートするために、チームはバックログとボードに表示する複数のエリア パスを選択できます。
新しいプロジェクトには、プロジェクト名に対応する単一のルート領域が含まれています。 同じプロジェクト名でチームが作成され、ルート領域のパスがそのチームに割り当てられます。
プロジェクトとチームの管理を初めて使用する場合、プロジェクトとチームを構成するための最も簡単な順序は次のとおりです。
作業を分類するためにサポートするエリア パスの数と名前を決定します。 少なくとも、定義したチームごとに 1 つのエリア パスを追加します。 詳細については、「 領域とイテレーションについて を確認してください。
サポートするチームの数と名前を決定します。 詳細については、「 チームとアジャイル ツールについて を確認してください。
Project 設定>Project 構成 を開き、プロジェクト レベルで手順 1 と 2 をサポートする領域パスを定義します。 この記事の後半で説明する「 プロジェクト設定を開く」、「プロジェクトの構成」、 および「 領域パスを追加 する」の手順に従います。手順 2 をサポートするために必要なチームを定義します。 詳細については、「 チームを追加し、1 つの既定のチームから複数のチームに移行する を参照してください。
チーム構成を開き、既定の領域パスと追加のエリア パスを各チームに割り当てます。 この記事で後述する「 チーム設定を開く 」および 「チームの既定の領域パスを設定する」の手順に 従います。
作業項目の領域パスを、定義したエリア パスに割り当てます。 一括変更 を使用して、複数の作業項目を一度に変更します。
必要に応じて、いつでも次のアクションを実行できます。
子ノードを追加する
エリア パスの名前を変更する (ルート エリア パスを除く)
子ノードを別のノードの下に移動する
子ノードを削除する
チームの名前を変更する
チームに対して行われたエリア パスの割り当てを変更する
プロジェクト設定を開き、プロジェクト領域を一覧表示する
プロジェクトの領域とイテレーションの両方を、 Project Settings >Boards >Project 構成 から定義します。
プロジェクトエリアパスのリスト | プロジェクトエリアパスの追加 | チームエリアパスのリスト | チームエリアパスの設定 | プロジェクトエリアパスの設定 | チームからのエリアパスの削除
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
Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。
エリア パスを追加する
既定では、1 つの領域のみが定義されます。 プロジェクトのルート領域パスの下に領域パスを追加するか、別のエリア パスに子として追加します。
領域のパスは、 az boards area プロジェクトの作成 を使用してプロジェクトに追加できます。 開始するには、「Azure DevOps CLI の概要 」を参照してください。
az boards area project create --name
[--path]
[--project]
パラメーター
name :必須。 エリア パス名。path : 省略可能。 区分の絶対パス。 例: --path \ProjectName\Area\AreaName。 指定しない場合は、ルート レベルで領域を追加します。project : 省略可能。 プロジェクトの名前または ID。 例: --project "Fabrikam Fiber"
たとえば、次のコマンドは、ルート ノードの 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
Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。
チーム設定を開き、チーム領域のパスを一覧表示する
チームの既定値はチーム設定から設定します。 チーム管理者でない場合は、 1 つとして追加します 。 チーム設定を変更できるのは、チーム管理者またはプロジェクト管理者だけです。
プロジェクトを開き、 プロジェクト設定 >Team 構成 >Areas を選択します。
チーム コンテキストを切り替える必要がある場合は、階層リンク内のチーム セレクターを使用します。
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
Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。
チーム プロファイルからチーム設定を開く
領域とイテレーションの両方を Project Settings > Team 構成から定義します 。 チーム作業追跡バックログ、ボード、またはダッシュボードからすばやく移動できます。
チームのバックログまたはボードを開き、 Team プロファイル Team 設定 を選択します。
ここでは、Fabrikam ファイバー チームのボードを開き、そこからチーム プロファイルを開きます。
[ イテレーションと領域] を選択します 。
チーム コンテキストを切り替える必要がある場合は、階層リンク内のチーム セレクターを使用します。
チームエリアのパスを設定する
チーム領域パスに割り当てられているすべての作業項目は、そのチームのバックログとボードに表示されます。 1 つ以上のエリア パスを選択し、必要に応じてサブエリア パスを含めることができます。 複数のチームまたは領域で行われた作業のロールアップ ビューをサポートする場合は、サブエリア パスを含めるように選択します。
既定のエリア パスは、チーム コンテキストから作成された作業項目に割り当てられた既定のエリア パスを決定します。
重要
複数のチームのボードに表示される作業項目は、期待を満たさないクエリ結果を生成できます。 各チームはボード 列 および swimlanes をカスタマイズできるため、異なるボードに表示される作業項目に割り当てられた値は同じではない可能性があります。 この問題の主な回避策は、チーム区分パスによって作業項目の単一所有権を維持することです。
チーム コンテキストの Areas を開きます。
ここでは、Fabrikam ファイバー チームの領域を示します。
各チームでアクティブにするエリア パスを選択します。
この例では、プロジェクトのサブエリア パスをアクティブ化することを選択します。 管理チームは、すべてのチームの進行状況を追跡できるようになりました。
完了したら、チームの製品バックログ ページを更新すると、チームに割り当てられている作業項目が表示されます。 表示された列に領域パスを追加して、作業項目に対して行われた割り当てを表示します。
チーム コンテキストの Areas を開きます。
ここでは、Fabrikam ファイバー チームの領域を示します。
各チームでアクティブにするエリア パスを選択します。
この例では、プロジェクトの 3 つのサブエリア パスをすべてアクティブにすることを選択します。 管理チームは、3 つのチームすべてで進行状況を追跡できるようになりました。
完了したら、チームの製品バックログ ページを更新すると、チームに割り当てられている作業項目が表示されます。 表示された列に領域パスを追加して、作業項目に対して行われた割り当てを表示します。
チームの既定のエリア パスを設定したり、エリア パスを追加したりするには、 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 プロジェクトの音声チームに音声領域パスを追加し、それを既定として設定し、サブ領域を含めます。
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
Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。
エリア パスの名前を変更または移動する
更新されたエリア パスを参照する作業項目とクエリは、システムによって自動的に更新されます。 各 Area パス は一意の GUID に関連付けられます。
Area Path の名前を変更するには、Web ポータルの Project 設定>Project 構成>Areas ページを開きます。
ノードの Edit を選択します。
開いたダイアログで、新しい名前を入力します。
階層内のノードを移動するには、 Location フィールドを変更します。
Note
ノードの Location フィールドの名前を変更すると、 Area パス を参照する既存の作業項目が自動的に更新されます。
プロジェクトの領域パスの名前を変更または移動する
az boards area project updateAzure 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
Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。
エリア パスを削除する
Area パス を削除する場合は、削除するエリア パス に割り当てられている作業項目を更新するために使用するエリア パス を指定する必要があります。
重要
Area パスの削除 または Iteration Paths の再構成により、元に戻せないデータ損失が発生します。 たとえば、 Area Paths が変更されたチームのバーンダウンおよびバーンアップ ウィジェット グラフ、スプリント バーンダウン、ベロシティ グラフでは、正確なデータは表示されません。 履歴傾向グラフは、作業項目ごとに定義された エリア パス と Iteration Path を参照します。 一度削除すると、これらのパスの履歴データを取得することはできません。削除できるのは、作業項目で使用されなくなった領域パスと反復パスのみです。
Area パスを削除するには Web ポータル Project 設定>Project 構成>Areas ページを開きます。
ノードのコンテキスト メニューを 削除 ] または [ 削除 ] を選択します。
開いたダイアログで、作業項目を再割り当てする Area Path を選択し、 Delete パス を選択します。
エリア別の進行状況をグラフ化する
クエリをすばやく生成して エリア パスに基づいて進行状況を表示できます。 たとえば、次の積み上げ横棒グラフに示すように、各チームのエリア パスに割り当てられている作業項目の進行状況
Q & A
Q: チームにエリア パスを割り当てる必要はありますか。
A: いいえ。 チームにエリア パスを割り当てて、そのエリア パスに割り当てられた作業項目がチームのバックログとボードに表示されるようにします。 既定では、すべての作業項目がルート領域パスに割り当てられます。 これらの作業項目は、プロジェクトに対して定義されている既定のチームに表示されます。
次のステップ
関連記事
ご覧のように、エリア パスは、アジャイル ツール、チーム、作業項目の管理をサポートする上で大きな役割を果たします。 これらのフィールドの操作の詳細については、次の記事を参照してください。
プログラムによるリソース
エリア パスと反復パスは、 分類ノード とも呼ばれます。
を選択し、[新しい子を選択できます。
![[プロジェクトの設定] の [チームの構成] ページ](media/areas/project-settings-team-configuration-preview.png?view=azure-devops-2019)
>Team 設定を選択します。![[Work Backlog]\(バックログまたはボード\) でチーム プロファイル アイコンを選択する](media/team-defaults/open-team-profile-choose-team-settings.png?view=azure-devops-2019)
![[チーム プロファイル]、[イテレーションと区分] を選択する](media/team-defaults/team-profile-choose-iterations-areas.png?view=azure-devops-2019)
![チームの [作業]、[イテレーション] ページ](media/team-defaults/stdefaults-add-area-paths-preview.png?view=azure-devops-2019)
![チームの [作業]、[イテレーション] ページ、オンプレミス のバージョン](media/team-defaults/stdefaults-add-area-paths.png?view=azure-devops-2019)
![[エリア パス] ノードのコンテキスト メニューを開いているスクリーンショット。[編集] オプションを選択します。](media/areas/edit-area-rename-project-configuration.png?view=azure-devops-2019)
![[領域の編集] ダイアログのスクリーンショット。](media/areas/edit-area-rename-dialog.png?view=azure-devops-2019)
![[領域の削除] ダイアログのスクリーンショット。](media/areas/delete-area-path-dialog.png?view=azure-devops-2019)
