定義區域路徑並指派至小組

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

新增區域路徑，以支援小組和根據產品、功能或商務區域分組工作專案。 在專案層級定義區域路徑之後，您會在小組組態下將路徑指派給小組。 您也可以建立區域路徑階層，以支持子區域，最多14層深。

若要執行下列工作，您必須定義區域路徑：

• 根據區域路徑查詢和圖表工作專案
• 將工作指派給多個小組
• 與管理和功能小組合作
• 使用區域路徑篩選待辦專案、查詢、面板或計劃

提示

您可以定義區域路徑結構，並將區域路徑指派給小組。 或者，您可以新增小組，並在該時間使用小組名稱建立區域路徑。 如果小組完全獨立，請建立一組平面的區域路徑。 不過，如果您想要建立小組階層，則想要建立區域路徑的樹狀結構階層。 如需詳細資訊，請參閱 設定小組階層。

若要使用下列工具，小組必須訂閱區域路徑：

• 面板> 所有工具
• 待辦專案> 所有工具
• 衝刺> 所有工具
• 傳遞計劃
• 匯總
• 全部分析>

若要了解系統如何使用區域路徑，請參閱 關於區域和反覆項目路徑。

必要條件

• 如果您還沒有專案， 請立即建立一個專案。

• 請確定您是 Project 管理員 istrators 群組的成員，以在根節點下新增區域路徑，或編輯或刪除任何子節點。 若要取得這些許可權，請參閱 變更專案層級許可權。

• 將下列一或多個許可權設定為 [允許]，以在節點底下新增、編輯和管理區域路徑：

  • 建立子節點
  • 刪除此節點
  • 編輯此節點
  • 檢視此節點中的許可權

  根據預設，建立專案的用戶已設定這些許可權。 如需詳細資訊，請參閱 設定工作追蹤的許可權和存取權。

• 請確定您已新增為小組管理員，或是 Project 管理員 istrators 群組的成員，以設定小組區域路徑。

如需區域路徑的命名限制，請參閱 關於區域和反覆專案、命名限制。

開始使用

每個小組都能存取許多敏捷式工具，如關於小組和敏捷式工具中所述。 每個工具都會參考小組的預設區域路徑。 大部分小組都會選擇一個區域路徑和數個反覆項目路徑，以支援其工作追蹤活動。 不過，為了支援其他案例，小組可以選擇數個區域路徑，使其待辦專案和面板上出現。

新專案包含對應至專案名稱的單一根區域。 系統會使用相同的項目名稱建立小組，並將根區域路徑指派給該小組。

如果您不熟悉管理專案和小組，設定專案和小組的最直接順序如下：

1. 決定您想要支援以分類工作的區域路徑數目和名稱。 針對您定義的每個小組，至少新增一個區域路徑。 如需詳細資訊，請檢閱 關於區域和反覆專案。
2. 決定您想要支援的小組數目和名稱。 如需詳細資訊，請參閱 關於小組和敏捷式工具。
3. 開啟 [項目設定>] [專案組態 ]，並定義區域路徑，以支援專案層級的步驟 1 和 2。 請遵循本文稍後提供的步驟：開啟專案 設定、項目組態和新增區域路徑。
4. 定義您需要支援步驟 2 的小組。 如需詳細資訊，請參閱 新增小組，從一個預設小組移至數個小組。
5. 開啟小組組態，並將預設和其他區域路徑指派給每個小組。 請遵循本文稍後提供的步驟：開啟小組設定和設定小組默認區域路徑。。
6. 將工作項目的區域路徑指派給您定義的區域路徑。 使用 大量修改 一次修改數個工作專案。

注意

雖然您可以將相同的區域路徑指派給多個小組，但如果兩個小組宣告同一組工作項目的擁有權，這樣做可能會造成問題。 若要深入瞭解，請參閱 關於面板和工作流程看板、多小組工作流程看板檢視的限制。

視需要，您可以隨時執行下列動作：

• 新增其他子節點
• 重新命名區域路徑（根區域路徑除外）
• 在另一個節點下移動子節點
• 刪除子節點
• 重新命名小組
• 變更對小組所做的區域路徑指派

重要

選取對應至您平臺和版本的本文版本。 版本選取器位於目錄上方。 查閱您的 Azure DevOps 平臺和版本。

開啟專案 設定，列出項目區域

從 Project 設定> Boards>專案組態定義專案的區域和反覆專案。

瀏覽器

• 從您的入口網站，選擇 [1] [項目設定]，選擇 [2] [項目組態 ]，然後選擇 [3] [區域]。

  

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 “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

新增區域路徑

預設只會定義一個區域。 將專案根區域路徑底下的區域路徑，或做為子系新增至另一個區域路徑。

瀏覽器

• 若要新增子節點，請反白顯示區域路徑，然後選擇 [ 新增子系]。 您可以選擇選取 區域路徑，然後選擇 [ 新增子系]。

  輸入節點的名稱（255 個字元或更少）。 如需其他名稱限制，請參閱 關於區域和反覆專案、命名限制。

  

Azure DevOps CLI

您可以使用 az boards area project create 將區域路徑新增至專案。 若要開始使用，請參閱 開始使用 Azure DevOps CLI。

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

參數

• name：必要。 區域路徑名稱。
• path：選擇性。 區域的絕對路徑。 範例：-path \ProjectName\Area\AreaName。 若未指定，請在根層級加入區域。
• 項目：選擇性。 項目的名稱或識別碼。 範例：--project “Fabrikam Fiber”。

範例：JSON 格式

例如，下列命令會將 Voice 區域路徑新增至根節點的 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. 開啟您的專案，然後選取 [項目設定>小組設定>區域]。

   

2. 如果您需要切換小組內容，請使用階層連結內的小組選取器。

   

Azure DevOps CLI

您可以使用 az boards 區域小組清單來列出為小組定義的區域路徑。 若要開始使用，請參閱 開始使用 Azure DevOps CLI。

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

參數

• team：必要。 小組的名稱或標識碼。
• 項目：選擇性。 項目的名稱或識別碼。 範例：--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

從小組配置檔開啟小組設定

您可以從 Project 設定 > Team 組態定義區域和反覆專案。 您可以從小組工作追蹤待辦專案、面板或儀錶板快速流覽至它。

1. 開啟小組的待辦專案或面板，然後選擇 [小組配置檔>小組] 設定。

   在這裡，我們開啟 Fabrikam Fiber 小組的面板，並從該處開啟小組配置檔。

   

2. 選擇 [ 反復項目和區域]。

   

3. 如果您需要切換小組內容，請使用階層連結內的小組選取器。

   

設定小組區域路徑（s）

指派給小組區域路徑的所有工作專案都會出現在該小組的待辦專案和面板上。 您可以選取一或多個區域路徑，並選擇性地包含其子區域路徑。 當您想要支援跨數個小組或區域完成工作的匯總檢視時，請選擇包含子區域路徑。

注意

最多可以指派 300 個區域路徑。 若要深入瞭解，請參閱 工作追蹤、程序和專案限制。

默認區域路徑會決定指派給從小組內容建立之工作專案的預設區域路徑。

重要

出現在多個小組工作流程看板面板上的工作專案，可能會產生不符合您期望的查詢結果。 由於每個小組都可以自定義工作流程看板列和泳道，因此指派給不同面板上之工作專案的值可能不相同。 此問題的主要解決方法是依小組區域路徑維護工作專案的單一擁有權。

瀏覽器

1. 開啟 小組內容的 [區域 ]。

   在這裡，我們會顯示 Fabrikam Fiber 小組的區域。

   

2. 選擇要針對每個小組使用的區域路徑。

   

   在此實例中，我們選擇啟用專案的子區域路徑。 管理小組現在可以追蹤所有小組的進度。

   

3. 當您完成時，請重新整理小組的產品待辦專案頁面，您會看到指派給小組的工作專案。 將區域路徑新增至顯示的數據行，以查看對工作專案所做的工作分派。

   

   

Azure DevOps CLI

您可以使用 az boards 區域小組 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

重新命名或移動區域路徑

系統會自動更新參考已更新區域路徑的工作項目和查詢。 每個 區域路徑 都會與唯一的 GUID 相關聯。

瀏覽器

1. 若要重新命名 區域路徑，請開啟入口網站 [項目設定>專案組態>區域 ] 頁面。

2. 選擇節點的操作功能表，然後選取 [編輯]。

   

3. 在開啟的對話框中，輸入新的名稱。

   

4. 若要移動階層內的節點，請變更 [ 位置] 欄位。

   注意

   當您重新命名或變更節點的 [位置 ] 字段時，系統會自動更新參考 區域路徑的現有工作專案。

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：選擇性。 移動現有的區域路徑，並將其新增為指定路徑名稱或標識符的子節點。
• name：選擇性。 指定區域路徑的新名稱。
• 項目：選擇性。 項目的名稱或識別碼。 範例：--project “Fabrikam Fiber”。

範例

例如，下列命令會將 Fabrikam Fiber 專案的 Voice 區域路徑重新命名為 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 專案的 Voice 小組中移除 \Service Delivery\Voice 區域路徑。

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

刪除區域路徑

當您刪除區域路徑時，必須提供區域路徑，以用來更新指派給您要刪除的區域路徑的工作專案。

重要

刪除區域路徑或重新設定反覆項目路徑可能會導致數據遺失，且無法還原。 例如，已變更區域路徑的小組的燒毀或燒毀小工具圖表、短期衝刺燒毀和速度圖表不會反映正確的數據。 歷史趨勢圖會參考 區域路徑 和 反覆項目路徑 ，如過去針對每個工作項目定義。 刪除區域路徑或反覆項目路徑時，就無法擷取其歷程記錄數據。

1. 若要刪除 區域路徑，請開啟入口網站 [項目設定>專案組態>區域 ] 頁面。

2. 選擇節點的操作功能表，然後選取 [刪除] 或 [移除]。

3. 在開啟的對話框中，選取 [區域路徑 ] 以重新指派工作專案，然後選擇 [ 刪除路徑]。

   

依區域繪製圖表進度

您可以快速產生 查詢 ，以根據區域路徑檢視進度。 例如， 將指派給每個小組區域路徑的工作專案進度可視化，如下列堆棧條形圖所示。 選擇 [節點名稱] 以取得區域路徑的分葉節點。

問與答

問：我是否需要將區域路徑指派給小組？

A: 不可以。 您可以將區域路徑指派給小組，讓指派給該區域路徑的工作專案出現在小組的待辦專案和面板上。 根據預設，所有工作項目都會指派給根區域路徑。 這些工作專案會出現在為專案定義的預設小組中。

下一步

設定反覆項目路徑或短期衝刺

相關文章

如您所見，區域路徑在支援敏捷式工具、小組和管理工作專案方面扮演了主要角色。 請從下列文章深入瞭解如何使用這些欄位：

• 關於區域和反覆專案
• 新增另一個小組
• 設定小組設定並新增小組管理員
• 依賴區域或反覆專案的敏捷式工具
• 依區域或反覆專案路徑查詢
• 設定工作追蹤的許可權和存取權

程式設計資源

區域路徑和反覆項目路徑也稱為 分類節點。

• az boards area （Azure DevOps CLI）
• Teams （REST API）
• 分類節點 （REST API）