定義區域路徑並指派至小組
本文內容
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
新增區域路徑,以支援小組和根據產品、功能或商務區域分組工作專案。 在專案層級定義區域路徑之後,您會在小組組態下將路徑指派給小組。 您也可以建立區域路徑階層,以支持子區域,最多14層深。
若要執行下列工作,您必須定義區域路徑:
提示
您可以定義區域路徑結構,並將區域路徑指派給小組。 或者,您可以新增小組,並在該時間使用小組名稱建立區域路徑。 如果小組完全獨立,請建立一組平面的區域路徑。 不過,如果您想要建立小組階層,則想要建立區域路徑的樹狀結構階層。 如需詳細資訊,請參閱 設定小組 階層。
若要使用下列工具,小組必須訂閱區域路徑:
若要了解系統如何使用區域路徑,請參閱 關於區域和反覆項目路徑 。
必要條件
如果您還沒有專案, 請立即 建立一個專案。
請確定您是專案管理員群組的成員 ,以在根節點下新增區域路徑,或編輯或刪除任何子節點。 若要取得這些許可權,請參閱 變更專案層級許可權 。
將下列一或多個許可權設定為 [允許 ],以在節點底下新增、編輯和管理區域路徑:
建立子節點
刪除此節點
編輯此節點
檢視此節點中的許可權
根據預設,建立專案的用戶已設定這些許可權。 如需詳細資訊,請參閱 設定工作追蹤 的許可權和存取權。
請確定您已新增為小組管理員,或是專案管理員 群組的成員 ,以設定小組區域路徑。
如需區域路徑的命名限制,請參閱 關於區域和反覆專案、命名限制 。
開始使用
每個小組都能存取許多敏捷式工具,如關於小組和敏捷式工具中所述 。 每個工具都會參考小組的預設區域路徑。 大部分小組都會選擇一個區域路徑和數個反覆項目路徑,以支援其工作追蹤活動。 不過,為了支援其他案例,小組可以選擇數個區域路徑,使其待辦專案和面板上出現。
新專案包含對應至專案名稱的單一根區域。 系統會使用相同的項目名稱建立小組,並將根區域路徑指派給該小組。
如果您不熟悉管理專案和小組,設定專案和小組的最直接順序如下:
決定您想要支援以分類工作的區域路徑數目和名稱。 針對您定義的每個小組,至少新增一個區域路徑。 如需詳細資訊,請檢閱 關於區域和反覆專案 。
決定您想要支援的小組數目和名稱。 如需詳細資訊,請參閱 關於小組和敏捷式工具 。
開啟 [項目設定>] [專案組態 ],並定義區域路徑,以支援專案層級的步驟 1 和 2。 請遵循本文稍後提供的步驟: 開啟專案設定、專案組態 和 新增區域路徑 。
定義您需要支援步驟 2 的小組。 如需詳細資訊,請參閱 新增小組,從一個預設小組移至數個小組 。
開啟小組組態,並將預設和其他區域路徑指派給每個小組。 請遵循本文稍後提供的步驟:開啟小組設定 和設定小組默認區域路徑。。
將工作項目的區域路徑指派給您定義的區域路徑。 使用 大量修改 一次修改數個工作專案。
視需要,您可以隨時執行下列動作:
新增其他子節點
重新命名區域路徑(根區域路徑除外)
在另一個節點下移動子節點
刪除子節點
重新命名小組
變更對小組所做的區域路徑指派
開啟 [項目設定],列出項目區域
從專案設定 >面板> 專案組態 定義專案的區域和反覆專案。
列出專案區域路徑 | 新增專案區域路徑 | 列出小組區域路徑 | 設定小組區域路徑 | 重新命名或移動專案區域路徑 移除小組的區域路徑 |
您可以使用 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
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”。
例如,下列命令會將 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
Azure DevOps Server 不支援 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
Azure DevOps Server 不支援 Azure DevOps CLI 命令。
從小組配置檔開啟小組設定
您可以從項目設定>小組組態定義區域和反覆 專案。 您可以從小組工作追蹤待辦專案、面板或儀錶板快速流覽至它。
開啟小組的待辦專案或面板,然後選擇 [小組配置檔 >小組設定]。
在這裡,我們開啟 Fabrikam Fiber 小組的面板,並從該處開啟小組配置檔。
選擇 [ 反復項目和區域 ]。
如果您需要切換小組內容,請使用階層連結內的小組選取器。
設定小組區域路徑(s)
指派給小組區域路徑的所有工作專案都會出現在該小組的待辦專案和面板上。 您可以選取一或多個區域路徑,並選擇性地包含其子區域路徑。 當您想要支援跨數個小組或區域完成工作的匯總檢視時,請選擇包含子區域路徑。
默認區域路徑會決定指派給從小組內容建立之工作專案的預設區域路徑。
重要
出現在多個小組面板上的工作專案可能會產生不符合您預期之查詢結果。 因為每個小組都可以自定義面板 數據行和泳道 ,因此指派給不同面板上的工作專案的值可能不相同。 此問題的主要解決方法是依小組區域路徑維護工作專案的單一擁有權。
開啟 小組內容的 [區域 ]。
在這裡,我們會顯示 Fabrikam Fiber 小組的區域。
選擇要針對每個小組使用的區域路徑。
在此實例中,我們選擇啟用專案的子區域路徑。 管理小組現在可以追蹤所有小組的進度。
當您完成時,請重新整理小組的產品待辦專案頁面,您會看到指派給小組的工作專案。 將區域路徑新增至顯示的數據行,以查看對工作專案所做的工作分派。
開啟 小組內容的 [區域 ]。
在這裡,我們會顯示 Fabrikam Fiber 小組的區域。
選擇要針對每個小組使用的區域路徑。
在此實例中,我們選擇啟用專案的所有三個子區域路徑。 管理小組現在可以追蹤這三個小組的進度。
當您完成時,請重新整理小組的產品待辦專案頁面,您會看到指派給小組的工作專案。 將區域路徑新增至顯示的數據行,以查看對工作專案所做的工作分派。
您可以使用 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
Azure DevOps Server 不支援 Azure DevOps CLI 命令。
重新命名或移動區域路徑
系統會自動更新參考已更新區域路徑的工作項目和查詢。 每個 區域路徑 都會與唯一的 GUID 相關聯。
若要重新命名 區域路徑 ,請開啟入口網站 [項目設定>專案組態>區域 ] 頁面。
選擇節點的操作功能表,然後選取 [編輯 ]。
在開啟的對話框中,輸入新的名稱。
若要移動階層內的節點,請變更 [ 位置] 欄位。
注意
當您重新命名或變更節點的 [位置 ] 字段時,系統會自動更新參考 區域路徑 的現有工作專案。
從專案重新命名或移動區域路徑
您可以使用 命令來重新命名或移動項目 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
Azure DevOps Server 不支援 Azure DevOps CLI 命令。
刪除區域路徑
當您刪除區域路徑時,必須提供區域路徑 ,以用來更新指派給您要刪除的區域路徑 的工作專案。
重要
刪除區域路徑或重新設定反覆項目路徑 會導致無法復原的數據遺失。 例如,具有已變更 區域路徑 之小組的衝刺燒毀和速度圖表不會顯示精確的數據。 歷史趨勢圖會參考 區域路徑 和 反覆專案路徑 ,因為它們是在每次工作專案定義時所定義的。 刪除之後,您無法擷取這些路徑的歷程記錄數據。
您只能刪除任何工作專案不再使用的區域和反覆項目路徑。
若要刪除 區域路徑 ,請開啟入口網站 [項目設定>專案組態>區域 ] 頁面。
選擇節點的操作功能表,然後選取 [刪除] 或 [ 移除 ]。
在開啟的對話框中,選取 [區域路徑 ] 以重新指派工作專案,然後選擇 [ 刪除路徑 ]。
依區域繪製圖表進度
您可以快速產生 查詢 ,以根據區域路徑檢視進度。 例如, 將指派給每個小組區域路徑 的工作專案進度可視化,如下列堆棧條形圖所示。 選擇 [節點名稱] 以取得區域路徑的分葉節點。
問與答
問:我是否需要將區域路徑指派給小組?
A: 不可以。 您可以將區域路徑指派給小組,讓指派給該區域路徑的工作專案出現在小組的待辦專案和面板上。 根據預設,所有工作項目都會指派給根區域路徑。 這些工作專案會出現在為專案定義的預設小組中。
下一步
相關文章
如您所見,區域路徑在支援敏捷式工具、小組和管理工作專案方面扮演了主要角色。 請從下列文章深入瞭解如何使用這些欄位:
程式設計資源
區域路徑和反覆項目路徑也稱為 分類節點 。