在此文章
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
反覆項目路徑也稱為 短期衝刺 ,支援將工作專案指派給時間間隔。 您可以在專案層級定義反覆專案路徑,然後每個小組都會選取他們要使用的路徑。 反覆項目路徑是所有選取它們的小組所使用的共享資源。 您可以建立一組平面的反覆專案路徑或路徑階層,以支持發行、子發行和短期衝刺。
定義反覆項目路徑,並在您想要使用下列工具時指派給小組:
提示
如果小組尚未訂閱或選取反覆專案路徑,該反覆運算路徑就不會出現在小組檢視或工具中。
如需新增反覆專案路徑的命名限制和限制的相關信息,請參閱 關於區域和反覆專案、命名限制 。
提示
若要快速更新反覆專案日期,請參閱 變更短期衝刺日期 。 不過,如果您需要定義反覆專案路徑和樹狀結構,請遵循本文中提供的指引。
必要條件
若要將反覆項目路徑新增至專案,您必須是專案管理員群組的成員 。 如果您還沒有專案, 請立即 建立一個專案。 根據預設,建立專案的用戶會設定這些許可權。
若要在節點下新增、編輯和管理反覆專案路徑,您必須將下列一或多個許可權設定為 [允許],才能管理您想要管理的節點:建立子節點 、刪除此節點、 編輯此節點,以及檢視此節點 的許可權。
若要設定小組反覆項目路徑,您必須新增為小組管理員 或專案管理員群組的成員 。
如需取得許可權的詳細資訊,請參閱 變更專案層級許可權 或 設定工作追蹤 的許可權和存取權。
開始使用
新建立的專案包含對應至專案名稱的單一根區域路徑。 您會在此根目錄下新增區域路徑。 此外,每個專案通常會指定一組預先定義的反覆項目路徑,以協助您開始追蹤您的工作。 您只需要指定日期。
如果您不熟悉管理專案和小組,請完成下列步驟:
檢閱 設定和自定義 Azure Boards 。
遵循定義區域路徑並指派給小組中 提供的指引,定義區域路徑和小組 。
決定您想要支援的反覆項目長度。 建議的做法是讓所有小組使用相同的短期衝刺步調。 如需指引,請檢閱 關於區域和反覆專案 。
判斷您是否要有短期衝刺和發行的平面結構或階層。
開啟 [項目設定>] [專案組態 ],並定義反復項目路徑,以支援專案層級的步驟 2 和 3。 請遵循本文稍後提供的步驟: 開啟專案設定、專案組態 和新增反覆專案, 以及設定反覆專案日期 。
開啟小組設定,並將預設和其他區域路徑指派給每個小組。 請遵循本文稍後提供的步驟: 開啟小組設定 和 設定小組默認反覆項目路徑 。
每個小組都應該將他們選取的預設反覆項目路徑指派給其工作專案。 請執行此動作,讓這些工作項目顯示在其產品待辦專案和面板上。 使用 大量修改 一次修改數個工作專案。 另 請參閱將待辦專案指派給短期衝刺 。
視需要隨時執行下列工作:
新增更多子反覆運算節點
重新命名反覆運算路徑(根路徑除外)
在另一個節點下移動子反覆運算路徑
刪除子反覆運算路徑
變更指派給小組的預設和選取反覆項目路徑
小組待辦專案反覆專案與預設反覆運算
每個小組都能存取許多敏捷式工具,如關於小組和敏捷式工具中所述 。 每個工具都會參考小組的預設區域路徑。 數個工具會參考小組的預設和選取的反覆項目路徑或短期衝刺。 大部分小組都會選擇一個區域路徑和數個反覆項目路徑,以支援其工作追蹤活動。 不過,為了支援其他案例,小組可以選擇數個區域路徑,使其待辦專案和面板上出現。
Teams 可以設定與待辦專案反覆專案不同的預設反覆專案。 待辦專案反覆項目會決定小組待辦專案和面板上出現的專案。 而且,默認反覆項目會決定指派哪些值給從小組內容建立的工作專案。
從小組內容建立的所有工作專案都會自動指派小組的預設區域路徑和預設反覆項目路徑。
列出專案反覆專案
您可以從專案設定>面板>項目組態定義項目的區域和反覆專案 。
從入口網站開啟 [項目設定 ]。
從 [專案設定 >面板> 專案組態 ] 定義專案的區域和反覆專案。
選擇 [1] [項目設定 ],視需要展開 [面板 ],然後選擇 [2] [項目組態 ] 和 [3] 反復專案 。
從入口網站開啟 [項目設定 ]。
從專案組態> 反覆專案定義專案的區域和反覆專案。
從入口網站中,選擇 [項目設定][1],選取 [項目組態][2],然後選取 [反復 專案](3)。
列出專案反覆專案路徑 | 新增專案反覆專案 | 清單小組反覆運算路徑 | 設定小組反覆專案路徑 | 刪除或更新專案反覆項目路徑
列出使用 az boards 反覆專案清單 為專案定義的反覆專案。 若要開始使用,請參閱 開始使用 Azure DevOps CLI 。
az boards iteration project list [--depth]
[--path]
[--project]
參數
depth :選擇性。 要列出的子節點深度。 範例:--depth 3。
path :選擇性。 反覆項目的絕對路徑。 \Iteration\
後面必須跟著 \ProjectName
,這會將它與區域路徑區別開來。 範例:-path \ProjectName\Iteration\IterationName。 如果在節點內使用空格,則以雙引弧括住,例如--path "\Fabrikam Fiber\Iteration\Sprint 1"
。 若未指定,請列出來自根層級的反覆項目路徑。
項目 :選擇性。 項目的名稱或識別碼。 範例:--project "Fabrikam Fiber"
。
範例
例如,下列命令會列出 Fabrikam Fiber 專案深度為 3 的區域路徑。 如需其他輸出格式選項的詳細資訊,請參閱 Azure CLI 命令的輸出格式
az boards iteration project list --depth 3 --project "Fabrikam Fiber" --output table
ID Identifier Name Path Has Children Start Date Finish Date
----- ------------------------------------ -------------- --------------------------------------------- -------------- -------------------- --------------------
55290 d77820e9-6bda-4deb-8052-cc519bc12ecc Fabrikam Fiber \Fabrikam Fiber\Iteration True
55292 5938b25d-7235-499e-815f-4fc19d95d24c Release 1 \Fabrikam Fiber\Iteration\Release 1 True
55297 c7063041-ff3a-4d7f-bb46-c433c7030d59 Sprint 1 \Fabrikam Fiber\Iteration\Release 1\Sprint 1 False 2019-01-01T00:00:00Z 2019-01-18T00:00:00Z
55298 dd10f1bf-bedd-4c6f-926f-b2abea81bb50 Sprint 2 \Fabrikam Fiber\Iteration\Release 1\Sprint 2 False 2019-01-21T00:00:00Z 2019-02-08T00:00:00Z
55340 862e961a-ac7a-4fcc-9ebc-8afd0c12fed5 Sprint 3 \Fabrikam Fiber\Iteration\Release 1\Sprint 3 False 2019-03-11T00:00:00Z 2019-03-29T00:00:00Z
55341 8548898e-4dfd-4515-9d6e-d476d90033a3 Sprint 4 \Fabrikam Fiber\Iteration\Release 1\Sprint 4 False
55342 d130534c-05dc-434b-a7f3-85689d11c36f Sprint 5 \Fabrikam Fiber\Iteration\Release 1\Sprint 5 False
55343 738f5c0b-c62b-4ba5-96ab-026e606b0cef Sprint 6 \Fabrikam Fiber\Iteration\Release 1\Sprint 6 False 2018-07-16T00:00:00Z 2018-08-03T00:00:00Z
55299 a0554e98-b1f1-4230-8500-733c739a0113 Release 2 \Fabrikam Fiber\Iteration\Release 2 False
55300 5c3a5d56-f860-4ebc-8838-7701256c88a4 Release 3 \Fabrikam Fiber\Iteration\Release 3 False
55301 ad722430-042b-4c45-87e5-8d67572d4fc1 Release 4 \Fabrikam Fiber\Iteration\Release 4 False
55364 8b738736-fef6-49f5-be2a-31c86add6589 Future \Fabrikam Fiber\Iteration\Future False
Azure DevOps Server 不支援 Azure DevOps CLI 命令。
新增反覆項目並設定反覆專案日期
以與新增區域相同的方式新增反覆專案。 如需在短期衝刺頻率內運作的詳細資訊,請參閱 Scrum 和短期衝刺規劃工具 。
從 [項目設定> ] [專案組態> 反復 專案] 新增和修改區域路徑。
針對以 Scrum 為基礎的專案,您會看到下列一組短期衝刺。
若要排程小組使用之每個短期衝刺的開始和結束日期,請反白顯示短期衝刺並選擇 [ 設定日期 ]。 或者,針對反覆專案路徑選取 [動作 ],然後選擇 [編輯]。
若要選取新的日期,請選擇行事曆圖示。
當您完成時,您有一組已排程的短期衝刺 - 類似下圖:
下一個步驟是 選擇每個小組所使用的 短期衝刺。
從 [反復專案 ],新增小組接著可以選取的反覆專案以供其使用。
從專案管理員或設定內容,從 [工作 >反復 專案] 頁面新增和修改區域路徑。
針對以 Scrum 為基礎的專案,您會看到下列一組短期衝刺。
若要排程小組使用之每個短期衝刺的開始和結束日期,請醒目提示短期衝刺並選擇 [ 設定日期 ]。 或者,針對反覆專案路徑選取 [動作 ] 操作功能表,然後選擇 [編輯]。
若要選取新的日期,請選擇行事曆圖示。
當您完成時,您有一組已排程的短期衝刺 - 如下所示:
下一個步驟是 選擇每個小組所使用的 短期衝刺。
使用 az boards 反覆運算專案 create 將反覆運算路徑新增至專案。 若要開始使用,請參閱 開始使用 Azure DevOps CLI 。
az boards iteration project create --name
[--finish-date]
[--path]
[--project]
[--start-date]
參數
名稱 :必要。 輸入反覆項目路徑的名稱。
finish-date :選擇性。 完成反覆專案的日期。 範例:“--finish-date 2019-06-21”。
path :選擇性。 反覆項目的絕對路徑。 範例:\ProjectName\Iteration\IterationName。 若未指定,請在根層級加入反覆專案。
項目 :選擇性。 項目的名稱或識別碼。 範例: --project "Fabrikam Fiber"
。
開始日期:選擇性。 輸入反覆項目路徑的開始日期。 範例:“2019-06-03”。 必須早於完成日期。
範例
例如,下列命令會新增Sprint 36,其從2019年9月1日開始,並在2019年9月30日結束,做為根節點上默認專案的反覆項目路徑。
az boards iteration project create --name "Sprint 36" --start-date 2019-09-01 --finish-date 2019-09-30
{
"attributes": {
"finishDate": "2019-09-30T00:00:00Z",
"startDate": "2019-09-01T00:00:00Z"
},
"children": null,
"hasChildren": false,
"id": 55411,
"identifier": "af3ef6a7-6551-451b-8f9f-63af7a60fc55",
"name": "Sprint 36",
"path": "\\Fabrikam Fiber\\Iteration\\Sprint 36",
"structureType": "iteration",
"url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/_apis/wit/classificationNodes/Iterations/Sprint%2036"
}
Azure DevOps Server 不支援 Azure DevOps CLI 命令。
列出小組反覆專案
從小組設定設定小組預設值。 如果您不是小組管理員, 請新增為一個 。 只有小組或專案管理員可以變更小組設定。
注意
Teams 最多可以指派 300 個反覆項目路徑 。 如需詳細資訊,請參閱<工作追蹤、程序和專案限制 >(機器翻譯)。
您可以從項目設定>面板>小組組態定義區域和反覆 專案。 從小組工作追蹤待辦專案、面板或儀錶板快速流覽至它。
開啟小組的待辦專案或面板,然後選擇 [小組配置檔 ],然後選擇 [小組設定]。
在這裡,我們會開啟 Web 小組的面板,並從該處開啟小組配置檔。
選擇 [ 反復項目和區域 ]。
如果您需要切換小組內容,請使用階層連結內的小組選取器。
列出使用 az boards 區域小組清單 為小組定義的反覆項目路徑。 若要開始使用,請參閱 開始使用 Azure DevOps CLI 。
az boards iteration team list --team
[--project]
[--timeframe]
參數
team :必要。 小組的名稱或標識碼。
項目 :選擇性。 項目的名稱或識別碼。
時間範圍 :選擇性。 根據相對時間傳回反覆項目的篩選。 僅 支援 Current 。
範例
例如,下列命令會列出服務傳遞小組的區域路徑。 如需其他輸出格式選項,請參閱 Azure CLI 命令的輸出格式
az boards iteration team list --team "Service Delivery" --project "Fabrikam Fiber" --output table
ID Name Start Date Finish Date Time Frame Path
------------------------------------ --------- ------------------------- ------------------------- ------------ ---------------------------------
c7063041-ff3a-4d7f-bb46-c433c7030d59 Sprint 1 2019-01-01T00:00:00+00:00 2019-01-18T00:00:00+00:00 past Fabrikam Fiber\Release 1\Sprint 1
dd10f1bf-bedd-4c6f-926f-b2abea81bb50 Sprint 2 2019-01-21T00:00:00+00:00 2019-02-08T00:00:00+00:00 past Fabrikam Fiber\Release 1\Sprint 2
862e961a-ac7a-4fcc-9ebc-8afd0c12fed5 Sprint 3 2019-03-11T00:00:00+00:00 2019-03-29T00:00:00+00:00 current Fabrikam Fiber\Release 1\Sprint 3
Azure DevOps Server 不支援 Azure DevOps CLI 命令。
選取小組短期衝刺並設定預設反覆項目路徑
您可以 為專案 定義短期衝刺,然後選取這些專案,讓每個小組都處於作用中狀態。 您可以指派建立新工作專案時要使用的預設反覆專案。
開啟 [項目設定 > 面板 > 小組組態 > 反復 專案] 小組。
在這裡,我們流覽至 Fabrikam Fiber 小組。
待辦專案反覆專案 。 只有指派給反覆專案等於或在此待辦專案反覆專案下,才會出現在小組的待辦專案和面板中。
此外,透過小組待辦專案或面板新增的所有工作項目都會指派待辦專案反覆專案。
默認反覆專案 。 默認反覆專案會定義當您從小組待辦專案或面板建立工作專案時要使用的反覆專案。 指定待辦專案反覆運算路徑下 定義的任何反覆 專案。 若要將新的工作專案指派給目前的反覆專案,請指定 @CurrentIteration 。 使用查詢中用來列出指派給小組之目前使用中 反覆專案的工作專案時所使用的相同巨集。
例如,您可能想要將所有新的工作專案新增至未來的反覆項目路徑,以便您用來分級並指派給定期間隔的特定短期衝刺。
注意
透過 [工作專案 ] 頁面或 小組儀錶板上的 [新增工作專案 ] 小工具新增的工作專案不會參考 指派給小組的默認反復項目路徑 。 相反地,系統會將用戶選取的最後一個 反覆項目路徑 指派給新的工作專案。 透過小組的 Sprints 待辦專案或工作面板新增的工作專案,一律會 指派與所選短期衝刺相關聯的反覆項目路徑 。
作用中的 短期衝刺。 為小組想要使用的每個短期衝刺待辦專案新增反覆專案。 從功能表選取每個短期衝刺,逐一新增。
當您完成時,應該會看到短期衝刺清單,如下所示。
如果您沒有看到所需的短期衝刺或日期,請新增或編輯專案的反覆專案,前提是您具有所需的許可權。 如需詳細資訊,請參閱 定義反覆專案(短期衝刺)路徑 。
若要查看新啟動的短期衝刺待辦專案,請重新整理小組 的產品待辦專案頁面 。
新增反覆專案路徑、設定預設反覆項目路徑,或使用下列 其中一個 az boards 反覆運算小組 Azure DevOps CLI 命令來設定小組的待辦專案反覆運算路徑。 若要開始使用,請參閱 開始使用 Azure DevOps CLI 。
az boards iteration team add --id --team
[--project]
az boards iteration team set-default-iteration --team
[--default-iteration-macro]
[--id]
[--project]
az boards iteration team set-backlog-iteration --id --team
[--project]
參數
team :必要。 小組的名稱或標識碼。
default-iteration-macro :選擇性。 預設反覆專案巨集,唯一有效的專案是 @CurrentIteration。
id :選擇性。 輸入反覆項目路徑的識別碼。 若要判斷標識碼,請使用 az boards 反覆運算專案清單 來列出反覆項目路徑。
項目 :選擇性。 項目的名稱或識別碼。 範例:--project “Fabrikam Fiber”。
範例
例如,下列命令會將 \Fabrikam Fiber\Iteration\Release 2 路徑新增至 Fabrikam Fiber 專案的服務傳遞小組。
az boards iteration team add --id a0554e98-b1f1-4230-8500-733c739a0113 --team "Service Delivery" --project "Fabrikam Fiber"
{
"attributes": {
"finishDate": null,
"startDate": null,
"timeFrame": "future"
},
"id": "a0554e98-b1f1-4230-8500-733c739a0113",
"name": "Release 2",
"path": "Fabrikam Fiber\\Release 2",
"url": "https://dev.azure.com/fabrikam/56af920d-393b-4236-9a07-24439ccaa85c/43e6bd2e-696f-492c-bbf7-9cde9cd420ea/_apis/work/teamsettings/iterations/a0554e98-b1f1-4230-8500-733c739a0113"
}
Azure DevOps Server 不支援 Azure DevOps CLI 命令。
重新命名或移動反覆專案
當您重新命名反覆專案,或移動樹狀結構階層內的節點時,系統會自動更新參考現有路徑的工作項目和查詢。
若要重新命名反覆項目路徑,請選擇 節點的操作功能表,然後選取 [ 編輯 ]。
在開啟的對話框中,輸入新的名稱。
若要移動階層內的節點,請變更 [位置] 欄位。
若要刪除節點,請從 [動作] 功能表選擇 [ 刪除 ] 選項。
注意
當您刪除反覆項目節點時,系統會使用您在刪除提示中輸入的節點,自動更新現有的工作專案。
使用下列 az boards 反覆運算專案 命令,重新命名、移動或刪除專案的反覆項目路徑。 若要開始使用,請參閱 開始使用 Azure DevOps CLI 。
重新命名或移動專案反覆項目路徑
若要重新命名或移動專案反覆項目路徑,請使用 az boards area project update
命令。
az boards iteration project update --path
[--child-id]
[--finish-date]
[--name]
[--project]
[--start-date]
參數
path :必要。 反覆項目的絕對路徑。 範例:\ProjectName\Iteration\IterationName。
child-id :選擇性。 移動現有的反覆項目路徑,並將其新增為指定路徑名稱或路徑標識符的子節點。
name :選擇性。 反覆運算路徑的新名稱。
項目 :選擇性。 項目的名稱或識別碼。 範例:--project “Fabrikam Fiber”。
finish-date :選擇性。 完成反覆專案的日期。 範例:“2019-06-21”。
開始日期:選擇性。 反覆項目路徑的開始日期。 範例:“2019-06-03”。 必須早於完成日期。
是 :選擇性。 請勿提示確認。
範例
例如,下列命令會更新 Fabrikam Fiber 專案的 Sprint 3 反覆運算路徑開始和結束日期。
az boards iteration project update --path "\Fabrikam Fiber\Iteration\Release 1\Sprint 3" --finish-date 2019-08-31 --start-date 2019-08-01 --project "Fabrikam Fiber" --output table
ID Identifier Name Start Date Finish Date Path Has Children
----- ------------------------------------ -------- -------------------- -------------------- -------------------------------------------- --------------
55340 862e961a-ac7a-4fcc-9ebc-8afd0c12fed5 Sprint 3 2019-08-01T00:00:00Z 2019-08-31T00:00:00Z \Fabrikam Fiber\Iteration\Release 1\Sprint 3 False
Azure DevOps Server 不支援 Azure DevOps CLI 命令。
刪除反覆項目路徑
重要
刪除區域路徑或重新設定反覆項目路徑 會導致無法復原的數據遺失。 例如,具有已變更 區域路徑 之小組的衝刺燒毀和速度圖表不會顯示精確的數據。 歷史趨勢圖會參考 區域路徑 和 反覆專案路徑 ,因為它們是在每次工作專案定義時所定義的。 刪除之後,您無法擷取這些路徑的歷程記錄數據。
您只能刪除任何工作專案不再使用的區域和反覆項目路徑。
當您刪除反覆項目路徑時,您必須提供反覆項目路徑 ,才能用來更新指派給您想要刪除之反覆專案的工作 專案。
若要刪除反復項目路徑 ,請開啟入口網站 [項目設定>專案設定反復 專案>] 頁面。
選擇節點的操作功能表,然後選取 [刪除] 或 [ 移除 ]。
在開啟的對話框中,選取 [反復項目路徑 ] 以重新指派工作專案,然後選擇 [ 刪除路徑 ]。
若要刪除專案反覆項目路徑,請使用 az boards area project delete
命令。 若要開始使用,請參閱 開始使用 Azure DevOps CLI 。
az boards iteration project delete --path
[--project]
[--yes]
參數
path :必要。 反覆項目的絕對路徑。 範例:\ProjectName\Iteration\IterationName。
項目 :選擇性。 項目的名稱或識別碼。 範例:--project “Fabrikam Fiber”。
是 :選擇性。 請勿提示確認。
Azure DevOps Server 不支援 Azure DevOps CLI 命令。
匯出/匯入反覆項目路徑
您無法匯出或匯入樹狀結構路徑,讓某個專案與另一個專案搭配使用。
使用 Azure CLI,您可以使用 az boards iteration
命令來列出針對某個專案定義的反覆項目,然後將反覆運算新增至另一個專案。 將反覆專案新增至另一個項目之後,您就可以使用 az boards iteration team
命令將反覆運算新增至小組,並設定小組的預設和待辦專案反覆項目路徑。
您可以使用 分類節點 (REST API) 和 Teams (REST API) 來執行類似的動作。
封存反覆項目路徑
過了一會兒,您可能會想要封存用於一年或更多過期短期衝刺的反覆項目路徑。 您可以在標籤為「封存」的節點下移動反覆項目路徑,以執行此動作。 所有工作項目都會使用移動的反覆運算路徑來更新。 此外,小組也可以取消選取過去的短期衝刺。 所有數據都會以新的反覆項目路徑指派在數據存放區中維護。
在封存反覆專案之前,請考慮您是否擷取了您想要的所有報表。
逐一查看圖表進度
您可以快速產生 查詢 ,以檢視這些區域的進度。 例如,您可以將 指派給短期衝刺 的工作專案進度可視化,如下列堆棧條形圖所示。
問與答
問:我是否需要將反覆項目路徑指派給小組?
答: 如果您的小組不使用短期衝刺來規劃和追蹤工作,則否。 您可以保留指派給小組的預設值。 接著,您可以使用產品和組合待辦專案和面板,不過您無法使用短期衝刺規劃工具。
相關文章
程式設計資源
區域路徑和反覆項目路徑也稱為 分類節點 。