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

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

新增區域路徑，依產品、功能或商務區域來組織小組和群組工作專案。 將區域路徑指派給小組，可確保這些路徑下的工作專案會出現在個別小組的待辦專案和面板上。 根據預設，所有工作項目都會指派給根區域路徑，並出現在專案的預設小組中。

在專案層級定義區域路徑之後，請將它們指派給小組組態內的小組。 您也可以建立區域路徑的階層式結構，以支持子區域，且深度最多可達 14 層。

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

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

提示

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

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

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

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

必要條件

權限：

• 若要設定小組區域路徑，請為小組管理員或專案管理員群組的成員。 根據預設，建立專案的使用者具有這些許可權。
• 若要在根節點下新增區域路徑，或編輯或刪除任何子節點，請成為 Project Administrators 群組的成員。
• 若要在節點下新增、編輯和管理區域路徑，請將下列一或多個許可權設定為 [允許]：
  • 建立子節點
  • 刪除此節點
  • 編輯此節點
  • 檢視此節點中的許可權

如需詳細資訊，請參閱 設定工作追蹤的許可權和存取權。

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

開始使用

每個小組都能存取各種敏捷式工具，如關於小組和敏捷式工具中所述。 這些工具會參考小組的預設區域路徑。 大部分的小組會使用一個區域路徑和數個反覆專案路徑來進行工作追蹤，但小組也可以在待辦專案和面板上使用多個區域路徑來支援不同的案例。

新專案包含對應至專案名稱的單一根區域，以及指派給此根區域路徑之相同名稱的預設小組。

如果您不熟悉管理專案和小組，請遵循下列步驟來設定專案和小組：

1. 定義區域路徑：決定分類工作所需的區域路徑數目和名稱。 每個小組至少新增一個區域路徑。 如需詳細資訊，請參閱 關於區域和反覆專案。
2. 定義小組：決定所需的小組數目和名稱。 如需詳細資訊，請參閱 關於小組和敏捷式工具。
3. 設定區域路徑：移至 [項目設定>] [專案組態>區域]，並定義您專案的區域路徑。 請遵循新增區域路徑中的步驟。
4. 建立小組：根據步驟 2 建立必要的小組。 如需詳細資訊，請參閱 新增小組，從一個預設小組移至數個小組。
5. 將區域路徑指派給小組：在小組設定中，將預設和其他區域路徑指派給每個小組。 執行設定小組預設區域路徑中的步驟。
6. 將區域路徑指派給工作專案：使用 大量修改 將工作專案指派給定義的區域路徑，以一次更新多個專案。

注意

將相同的區域路徑指派給多個小組可能會導致工作項目擁有權發生衝突。 如需詳細資訊，請參閱 多小組面板檢視的限制。

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

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

列出項目區域

若要列出項目區域，請執行下列步驟：

瀏覽器

從您的入口網站中，選取 [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

新增區域路徑

預設只會定義一個根區域。 在專案的根區域路徑下新增和子區域路徑，或作為子系新增至另一個區域路徑或小組。 新的區域路徑預設會新增至根節點。

您也可以將新的和子區域路徑新增至小組。 如需詳細資訊，請參閱 設定小組區域路徑。

瀏覽器

若要新增區域路徑，請執行下列步驟：

1. 反白顯示區域路徑，然後選擇 [ 新增子系]。 您可以選擇選取 區域路徑，然後選擇 [新增]，或選取 區域清單頂端的 [新增 ] 功能表項。

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

   

3. 選取 [儲存後關閉]

所有新區域都會新增為根區域路徑的子節點。

若要新增子區域路徑，請執行下列步驟：

1. 反白顯示區域路徑，然後選擇 [ 新增子系]。 您可以選擇選取 區域路徑，然後選擇 [新增子系 ]，或從區域清單頂端的功能表中選取 [ 新增子系 ]。

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

   

3. 選取 [儲存後關閉]

您也可以在 [小組>設定區域] 頁面上，將區域路徑新增至小組。

Azure DevOps CLI

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

如果您指定 --path 參數，新的區域路徑會新增為指定路徑的子節點。 如果您未指定 --path 參數，新的區域路徑會新增為根節點的子節點。

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

參數

• 名稱：必要。 區域路徑名稱。
• 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

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

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

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

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

   

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

   

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

   

設定小組區域路徑

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

注意

最多可以指派 300 個區域路徑。 如需詳細資訊，請參閱＜工作追蹤、程序和專案限制＞(機器翻譯)。

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

重要

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

瀏覽器

您可以選取現有的區域路徑，或從小組設定建立新的或子區域路徑。

1. 選取 [項目設定>] [小組組態>區域]。

2. 從頁面頂端的下拉式清單中選取您想要設定的小組。

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

   

3. 為小組選擇一或多個要作用中的區域路徑。

   

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

   

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

   

   

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. 在開啟的對話框中，選取 [區域路徑 ] 以重新指派工作專案，然後選擇 [ 刪除路徑]。

   

依區域繪製圖表進度

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

下一步

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

相關文章

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

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

程式設計資源

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

• 使用 az boards 區域 （Azure DevOps CLI）。
• 使用 Teams （REST API） 來管理小組組態。
• 利用分類節點 （REST API） 來組織工作項目分類。