Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022
前置時間和週期時間小工具顯示工作流經過開發管線所需的時間。 前置時間是從建立工作專案到完成的總時間。 週期時間是您的團隊在開始處理工作專案後完成工作專案所需的時間。
關鍵定義
前置時間 — 從建立工作專案 （或第一次進入待辦專案） 到達到 [已完成/已關閉] 狀態所經過的總時間。 前置時間衡量端對端交付，對於估計交付時間和跟踪 SLA 非常有用。
週期時間計算 — 從工作專案第一次轉換成作用中/進行中 （或已解決，如適用） 狀態類別，到最後轉換成 [已完成/已關閉] 狀態類別的期間。 對於重新啟用的工作項目，週期時間會從工作項目第一次進入「作用中」（或已解決）狀態種類開始，並在最後一次進入「已完成」狀態種類時結束。 週期時間包括整個作用中工作期間 （項目處於作用中狀態的所有時間），包括重新啟用後的任何作用中時間。
總週期時間 — 經過的總時間，包括作用中工作期間，以及重新啟用之前處於「已關閉/已完成」狀態的任何時間。 換句話說，總週期時間反映的是工作項目在關閉和稍後重新開啟時，整段有效運作及已關閉期間所經歷的全部時間。
範例（重新啟用）：新增→作用中→已解決→已關閉→新增→作用中→已關閉
在此情節中：
- 週期時間計算從第一次轉換到「作用中」開始，並在最後一次轉換到「已關閉」時結束（其匯總所有作用中的時間段）。
- 總週期時間包括活躍階段的跨度以及它們之間的關閉時期（因此它測量在活躍和關閉狀態中經過的全部時間）。
下圖顯示前置時間和週期時間的不同之處。 前置時間是從 建立工作專案 到工作專案進入 [已完成] 狀態的時間。 週期時間是從工作專案第一次進入 [進行中] 或 [已解決 ] 狀態類別到進入 [已完成] 狀態類別的時間。 如需詳細資訊，請參閱 關於待辦專案和面板中的工作流程狀態。
週期時間如何處理重新啟用的工作專案
對於重新啟用的工作項目 （從 [已完成] 狀態移回 [進行中] 狀態） ，週期時間會從工作項目第一次進入 [進行中 ] 或 [ 已解決 ] 狀態類別開始，並結束最後一次進入 [已完成] 狀態類別。 週期時間包括整個作用中工作期間，包括重新啟動後的任何時間。
範例案例：
- 新→ 作用中→已解決→已關閉 → 新→作用中→已關閉
- 週期時間計算： 從第一次轉換至「作用中」，到最後轉換至「已關閉」
- 總循環時間： 包括作用中工作期間，以及重新啟用前處於「已關閉」狀態的時間
此計算方法提供完成工作項目所需總時間的完整圖片，包括重新啟動後的任何重工或額外工作。 前置時間計算遵循相同的原則，它涵蓋從工作專案建立到最終完成的整個期間，無論任何中間完成狀態為何。
這些措施可協助團隊規劃、發現效率變化並發現可能的流程問題。 更短的交貨時間和週期時間意味著更快的團隊吞吐量。 在每次回顧之前或期間檢查前置時間和循環時間圖表。 使用前置時間來估計傳遞時間並追蹤服務等級協定 （SLA）。 使用週期時間來尋找流程問題、發現趨勢並協助進行規劃。
如需詳細資訊，請參閱 累計流程、前置時間和週期時間指引。
必要條件
| 類別 | 要求 |
|---|---|
| 存取層級 |
-
專案成員。 - 至少 基本 存取權。 |
| 許可權 |
-
團隊管理員 或專案管理員，或特定 儀錶板許可權 授與您。 - 若要將小工具新增至小組儀錶板：必須是小組成員。 |
| 功能啟用 | 已啟用 Azure Boards。 如果停用，則不會顯示任何工作追蹤分析小工具。 若要重新啟用它，請參閱 開啟或關閉服務。 |
| 任務感知 | 瞭解本文稍後所列的任何必要或建議工作。 |
| 類別 | 要求 |
|---|---|
| 存取層級 |
-
專案成員。 - 至少 基本 存取權。 |
| 許可權 |
-
團隊管理員 或專案管理員，或特定 儀錶板許可權 授與您。 - 若要將小工具新增至小組儀錶板：必須是小組成員。 |
| 功能啟用 |
-
已啟用 Azure Boards。 如果停用，則不會顯示任何工作追蹤分析小工具。 若要重新啟用它，請參閱 開啟或關閉服務。 - Analytics 已安裝並啟用。 Project Collection Administrators 群組的成員可以新增延伸模組或啟用服務。 組織擁有者會自動成為此群組的成員。 |
- 請確定您團隊的面板已定義支援工作流程的 欄 和 泳道 。
- 將小工具新增至儀錶板。 有兩個小工具：週期時間和前置時間。 選取您想要顯示和設定的項目。
設定循環時間和前置時間小工具
「週期時間」和「前置時間」元件的設定對話方塊是相同的。 為團隊配置這些小工具。 如需詳細資訊，請參閱 建立或新增小組。
選取
內容功能表圖示，然後選取 [設定] 以開啟設定對話方塊。修改標題，然後選取您想要監視的值：
- 球隊
- 工作項目
- 泳道
- 欄位準則
- 時段
若要選取 泳道，請選取 待辦事項。
注意
您只能選取新增至待辦專案的工作項目類型。 若要將工作專案類型新增至待辦專案，請參閱自定義待辦專案或面板（繼承程式）。 如需內部部署 XML 程序，請參閱 程序組態 XML 元素參考。
若要進一步篩選用來計算前置時間或週期時間的工作專案，請指定 Field Criteria。 例如，[發行] 欄位設定為 [里程碑 1] 的所有工作專案。
![[設定] 對話框、[交期] 小工具、篩選準則的螢幕截圖。](media/lead-cycle/field-criteria-release.png?view=azure-devops)
注意
如果您未提供篩選條件的值，則可能會選取所有工作專案，或篩選條件可能無效，視篩選準則的類型而定。
針對連續流程，選取 [ 滾動期間 ]，並指定您想要在圖表上檢視的天數。
或者，針對固定範圍檢視，選取並指定 開始日期。 如果您的小組採用 Scrumban 程式或遵循標準短期衝刺程式，請選取此檢視。 這兩種圖表類型的主要差異在於固定範圍圖表在大部分情況下提供範圍變更的資訊。
當完成時，選擇儲存。 下圖顯示一個範例的交期圖表，展示 60 天的數據。
若要讓前置時間及週期時間圖表提供有用的資料，您的小組需要快速更新小組件所追蹤之工作項目 的狀態 。
解譯散佈圖控制圖
「前置時間」和「週期時間」小工具都會顯示為散佈圖控制圖表。 它們顯示摘要資訊並提供數個互動元素。
範例交貨期小工具
圖表點代表已完成的工作專案。 它們在水平軸上的位置顯示團隊完成它們的日期，它們在垂直軸上的位置顯示計算的前置時間或週期時間。
- 較大的點會顯示具有相同前置時間或週期時間的多個工作專案
- 點色彩符合圖例中顯示的工作專案類型
- 深灰色點會顯示工作專案類型的混合
摘要元素
- 針對圖表設定之主要工作專案類型的平均天數 （前置時間或週期時間）。 此數字不一定是所有工作專案的平均週期時間或前置時間。 這取決於您如何設定小工具。 平均值是依據團隊在每個工作項目上花費的天數而來。
- 圖表計算中使用的待辦項目數目。 如果有三種以上的工作項目類型，您會看到其他專案的摘要。
- 黑色趨勢線顯示移動平均線。
- 趨勢線周圍的帶會顯示標準偏差。
互動式元素
- 將滑鼠停留在任何點上，以查看哪些工作專案構成資料點，以及這些專案的前置時間或週期時間。
- 選擇點以開啟工作項目或顯示工作項目的查詢列表。
- 選取圖例中的工作專案類型 （
、 
或其他圖示） 來篩選圖表，以篩選該類型。 若要返回原始圖表，請重新整理儀表板。
移動平均和標準偏差計算
每日移動平均：移動平均窗口中數據點的平均值，基於當前一天和前 N 天。 N 是圖表顯示天數的 20%，四捨五入到最接近的奇數。
- 範例：如果圖表顯示過去 30 天，則 N = 5 天 （30 天的 20% 為 6，向下捨入為 5）。
移動平均視窗：對於 4 月 10 日，視窗是前五天。 4 月 10 日移動平均是 4 月 5 日至 4 月 10 日所有數據點的平均。
- 如果移動平均線視窗沒有任何資料點，則圖表不會顯示移動平均線。 如果沒有足夠的天數來計算移動平均線，就會發生這種情況。
標準差：顯示為移動平均線周圍的波段，並根據同一移動平均線視窗中的所有資料點計算。
- 如果移動平均視窗沒有任何資料點，則圖表不會顯示標準差。
使用 REST API 新增小工具
使用下列 API 端點以程式設計方式新增小工具：
POST https://dev.azure.com/{organization}/{project}/{team}/_apis/dashboard/dashboards/{dashboardId}/widgets?api-version=7.1-preview.2
如需詳細資訊，請參閱 REST API - 取得小工具。