定義區域路徑並指派至小組
本文內容
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018
根據產品、功能或商務區域，新增區域路徑以支援小組和群組工作專案。 在專案層級定義區域路徑之後，您會在小組組態下將其指派給小組。 您也可以建立區域路徑階層，以支援子領域，最多 14 層深度。
若要執行下列工作，您必須定義區域路徑：
提示
您可以定義區域路徑結構，並將區域路徑指派給小組。 或者，您可以新增小組，並在該時間使用小組名稱建立區域路徑。 如果小組完全獨立，請建立一組一組一般的區域路徑。 不過，如果您想要建立小組階層，則您會想要建立區域路徑的樹狀結構階層。 若要深入瞭解，請參閱 設定小組階層 。
若要使用下列工具，小組必須訂閱區域路徑：
若要瞭解系統如何使用區域路徑，請參閱 關於區域和反復專案路徑 。
必要條件
如果您還沒有專案， 請立即建立一個專案 。
請確定您是 Project Administrators 群組的成員，以在根節點下新增區域路徑，或編輯或刪除任何子節點。 若要取得這些許可權，請參閱 變更專案層級許可權 。
將下列一或多個許可權設定為 [允許 ]，以在節點下新增、編輯和管理區域路徑：
建立子節點 刪除此節點 編輯此節點 檢視此節點中的許可權
根據預設，建立專案的使用者已設定這些許可權。 如需詳細資訊，請參閱 設定工作追蹤的許可權和存取 權。
請確定您已 新增為小組管理員 ，或是 Project Administrators 群組的成員，以設定小組區域路徑。
如需區域路徑的命名限制，請參閱 關於區域和反復專案、命名限制 。
開始使用
每個小組都可以存取一些敏捷式工具，如 關於小組和敏捷式工具 中所述。 每個工具都會參考小組的預設區域路徑 () 。 大部分小組選擇一個區域路徑和數個反復專案路徑，以支援其工作追蹤活動。 不過，若要支援其他案例，小組可以選擇數個區域路徑來出現在其待辦專案和麵板上。
新專案包含對應至專案名稱的單一根區域。 小組會使用相同的專案名稱建立，且根區域路徑會指派給該小組。
如果您不熟悉管理專案和小組，則設定專案和小組的最直接順序如下：
決定您想要支援以分類工作的區域路徑數目和名稱。 您至少要為每個您定義的小組新增一個區域路徑。 如需詳細資訊，請參閱 關於區域和反復專案 。
決定您想要支援的小組數目和名稱。 如需詳細資訊，請參閱 關於小組和敏捷式工具 。
開啟 [專案設定 > 專案 設定]，並定義區域路徑，以支援專案層級的步驟 1 和 2。 請遵循本文稍後提供的步驟： 開啟專案設定、專案設定 和 新增區域路徑 。
定義支援步驟 2 所需的小組。 如需詳細資訊，請參閱 新增小組，從一個預設小組移至數個小組 。
開啟小組組態，並將預設和其他區域路徑指派給每個小組 () 。 請遵循本文稍後提供的步驟： 開啟小組設定 和 設定小組預設區域路徑， (s) 。
將工作專案的區域路徑指派給您定義的區域路徑。 使用 大量修改 一次修改數個工作專案。
視需要，您可以隨時執行下列動作：
新增其他子節點
除了根區域路徑) 以外，請重新命名區域路徑 (
在另一個節點下移動子節點
刪除子節點
重新命名小組
變更對小組所做的區域路徑指派
重要
若要檢視平臺可用的內容，請確定您從位於目錄上方的版本選取器中選取本文的正確版本。 功能支援會因您從Azure DevOps Services或內部部署版本的Azure DevOps Server而有所不同。查閱您的 Azure DevOps 平臺和版本
開啟專案設定，列出專案區域
從[專案設定 >面板 > 專案] 組態 定義專案的區域和反復專案。
從[專案設定 ] 內容的 [工作 ] 頁面定義區域和反復專案。 從使用者內容中，選擇 [設定
從專案的入口網站中，選擇 [專案設定
如果您目前使用小組內容，請將滑鼠停留在 [ 設定 專案設定 ]。
選擇 [工作 ]。
列出專案區域路徑 | 新增專案區域路徑 | 列出小組區域路徑 | 設定小組區域路徑 | 重新命名或移動專案區域路徑 | 從小組移除區域路徑
您可以使用 az boards area project list 列出為專案定義的區域路徑。 若要開始使用，請參閱開始使用 Azure DevOps CLI 。
az boards area project list [--depth]
[--path]
[--project]
參數
深度 ：選擇性。 要列出的子節點深度。 範例：-depth 3。 未指定時，只會傳回最上層區域路徑。path ：選擇性。 區域的絕對路徑。 \Area\ 後面必須遵循 \ProjectName ，這會區分此路徑與反復專案路徑。 例如，-path \ProjectName\Area\AreaName。 如果在節點內使用空格，請用雙引號括住，例如 --path 「\Fabrikam Fiber\Area\Service Delivery\Performance」。 未指定時，會列出根層級的區域路徑。專案 ：選擇性。 專案的名稱或識別碼。 範例：--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 Server不支援 Azure DevOps CLI 命令。
新增區域路徑
預設只會定義一個區域。 將區域路徑新增至專案的根區域路徑底下，或新增為另一個區域路徑的子系。
您可以使用 az boards area project create 將區域路徑新增至專案。 若要開始使用，請參閱 開始使用 Azure DevOps CLI 。
az boards area project create --name
[--path]
[--project]
參數
名稱 ：必要。 區域路徑名稱。path ：選擇性。 區域的絕對路徑。 範例：--path \ProjectName\Area\AreaName。 如果未指定，請在根層級新增區域。專案 ：選擇性。 專案的名稱或識別碼。 範例：--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 Server不支援 Azure DevOps CLI 命令。
開啟小組設定，列出小組區域路徑
您可以從小組設定設定小組預設值。 如果您不是小組系統管理員， 請新增為一個 。 只有小組或專案管理員可以變更小組設定。
開啟您的專案，然後選取[專案設定 >小組設定 >區域 ]。
如果您需要切換小組內容，請使用階層連結內的小組選取器。
您可以從上方導覽列開啟小組設定。 選取您想要的小組，然後選擇 [小組設定 切換專案、存放庫、小組
您可以使用 az boards area team list 列出為小組定義的區域路徑。 若要開始使用，請參閱 開始使用 Azure DevOps CLI 。
az boards area team list --team
[--project]
參數
小組 ：必要專案。 小組的名稱或識別碼。專案 ：選擇性。 專案的名稱或識別碼。 範例：--project 「Fabrikam Fiber」。
例如，下列命令會列出服務傳遞小組的區域路徑。 如需其他輸出格式選項，請參閱 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 Server不支援 Azure DevOps CLI 命令。
從小組設定檔開啟小組設定
您可以從 [專案設定 > 小組 ] 組態定義區域和反復專案。 您可以從小組工作追蹤待辦專案、面板或儀表板快速流覽至它。
開啟小組的待辦專案或面板，然後選擇 [小組設定檔 小組設定 ]。
在這裡，我們會開啟 Fabrikam Fiber 小組的面板，並從該處開啟小組設定檔。
選擇 [反復專案和區域 ]。
如果您需要切換小組內容，請使用階層連結內的小組選取器。
設定小組區域路徑 ()
指派給小組區域路徑的所有工作專案都會出現在該小組的待辦專案和麵板上。 您可以選取一或多個區域路徑，並選擇性地包含其子領域路徑。 當您想要支援跨數個小組或區域完成工作的匯總檢視時，請選擇包含子領域路徑。
預設區域路徑會決定指派給從小組內容建立之工作專案的預設區域路徑。
重要
出現在多個小組工作流程看板上的工作專案，可能會產生不符合您期望的查詢結果。 由於每個小組都可以自訂工作流程看板 資料 行和 泳道 ，因此指派給不同面板上的工作專案值可能不相同。 此問題的主要因應措施是依小組區域路徑維護工作專案的單一擁有權。
開啟小組內容的 [區域 ]。
在這裡，我們會顯示 Fabrikam Fiber 小組的區域。
選擇每個小組 () 的區域路徑。
在此實例中，我們選擇啟用專案的子領域路徑。 管理小組現在可以追蹤所有小組的進度。
當您完成時，請重新整理小組的產品待辦專案頁面，您會看到指派給小組的工作專案。 將區域路徑新增至顯示的資料行，以查看對工作專案所做的工作分派。
開啟小組內容的 [區域 ]。
在這裡，我們會顯示 Fabrikam Fiber 小組的區域。
為每個小組選擇 () 的區域路徑。
在此實例中，我們選擇啟用專案的所有三個子領域路徑。 管理小組現在可以追蹤這三個小組的進度。
完成時，請重新整理小組的產品待辦專案頁面，您會看到指派給小組的工作專案。 將區域路徑新增至顯示的資料行，以查看對工作專案所做的工作分派。
您可以使用 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 ：必要。 小組的名稱或識別碼。include-sub-areas ：選擇性。 包含區域路徑的子節點。 接受的值：false、true。專案 ：選擇性。 專案的名稱或識別碼。 範例：--project 「Fabrikam Fiber」。set-as-default ：選擇性。 指定為小組的預設區域路徑。 預設值：False。
範例
例如，下列命令會將 Voice 區域路徑新增至 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
內部部署Azure DevOps Server不支援 Azure DevOps CLI 命令。
重新命名或移動區域路徑
系統會自動更新參考更新區域路徑的工作專案和查詢。 每個 區域路徑 都與唯一的 GUID 相關聯。
若要重新命名區域路徑 ，請開啟入口網站[專案 > 設定 > 專案設定區域] 頁面。
編輯 ]。
在開啟的對話方塊中，輸入新的名稱。
若要移動階層內的節點，請變更 [ 位置 ] 欄位。
注意
當您重新命名或變更節點的 [位置 ] 欄位時，系統會自動更新參考 區域路徑 的現有工作專案。
從專案重新命名或移動區域路徑
您可以使用 命令重新 az boards area project updateAzure DevOps CLI 。
az boards area project update --path
[--child-id]
[--name]
[--project]
path ：必要。 區域的絕對路徑。 範例：-path \ProjectName\AreaName。child-id ：選擇性。 移動現有的區域路徑，並將其新增為指定路徑名稱或識別碼的子節點。name ：選擇性。 指定區域路徑的新名稱。專案 ：選擇性。 專案的名稱或識別碼。 範例：--project 「Fabrikam Fiber」。
範例
例如，下列命令會將Fabrikam Fiber 專案的語音 區域路徑重新命名為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 ：必要。 小組的名稱或識別碼。專案 ：選擇性。 專案的名稱或識別碼。 範例：--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 Server不支援 Azure DevOps CLI 命令。
刪除區域路徑
刪除 區域路徑 時，您必須提供 區域路徑 ，以用來更新指派給您要刪除 之區域路徑 的工作專案。
重要
刪除 區域路徑 或重新設定 反復專案路徑 可能會導致資料遺失，而且無法還原。 例如，已變更 區域路徑 之小組的待處理或待用小工具圖表、短期衝刺待用和速度圖表不會反映正確的資料。 歷程趨勢圖表會參考每個工作專案過去一點所定義的 區域路徑 和 反復專案路徑 。 刪除 區域路徑 或 反復專案路徑 時，就無法擷取其歷程記錄資料。
若要刪除區域路徑 ，請開啟入口網站[專案 > 設定 > 專案設定區域] 頁面。
刪除 ] 或 [移除 ]。
在開啟的對話方塊中，選取要重新指派工作專案的區域 路徑 ，然後選擇 [ 刪除路徑 ]。
依區域繪製圖表進度
您可以根據區域路徑快速產生 查詢 來檢視進度。 例如， 將指派給每個小組區域路徑的工作專案進度視覺化 ，如下列堆疊橫條圖所示。 選擇 [節點名稱] 以取得區域路徑的分葉節點。
問 & 答
問：我是否必須指派區域路徑給小組？
答： 否。 您會將區域路徑指派給小組，讓指派給該區域路徑的工作專案出現在小組的待辦專案和麵板上。 根據預設，所有工作專案都會指派給根區域路徑。 這些工作專案會出現在為專案定義的預設小組中。
下一步
相關文章
如您所見，區域路徑在支援敏捷式工具、小組和管理工作專案方面扮演主要角色。 從下列文章深入瞭解如何使用這些欄位：
程式設計資源
區域路徑和反復專案路徑也稱為 分類節點 。
] 以開啟系統管理員內容。
]。
區域路徑，然後選擇 [ 新增子系]。
>小組設定]。
![小組設定檔，選擇 [反復專案和區域]](media/team-defaults/team-profile-choose-iterations-areas.png?view=azure-devops)
![小組、內部部署版本的 [工作]、[反復專案] 頁面](media/team-defaults/stdefaults-add-area-paths.png?view=azure-devops)
![[區域路徑] 節點開啟操作功能表的螢幕擷取畫面，選擇 [編輯] 選項。](media/areas/edit-area-rename-project-configuration.png?view=azure-devops)
![[編輯區域] 對話方塊的螢幕擷取畫面。](media/areas/edit-area-rename-dialog.png?view=azure-devops)
![[刪除區域] 對話方塊的螢幕擷取畫面。](media/areas/delete-area-path-dialog.png?view=azure-devops)
