前置時間和週期時間小工具

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

前置時間和週期時間小工具會指出工作流程流經開發管線所需的時間。 前置時間會測量從建立工作專案到完成所經過的總時間。 週期時間會測量小組在開始主動處理工作專案時完成工作專案所需的時間。

下圖說明前置時間與週期時間有何不同。 前置時間是從 [工作專案建立] 計算到進入 [已完成] 狀態。 週期時間是從第一次輸入 [進行中] 或 [已解析 ] 狀態類別到輸入 已完成 狀態類別所計算。 如需詳細資訊，請參閱 關於待辦專案和面板中的工作流程狀態。

這些衡量方式有助於小組規劃、找出效率變化，並找出潛在的流程問題。 前置和週期時間愈短，您的小組擁有的輸送量就越大。 建議您小組在每個回顧之前或期間檢查前置時間和周期時程圖表。 使用前置時間協助預估傳遞時間並追蹤服務等級協定 （SLA）。 使用週期時間來識別潛在的程序問題、找出趨勢的變化，以及協助規劃。

如需詳細資訊，請參閱 累計流程、前置時間和週期時間指引。

必要條件

• 存取權：
  • 至少是具有基本存取權的項目成員。
  • 若要將小工具新增至小組儀錶板，請成為小組的成員。
• 許可權： 身為 小組管理員 或專案管理員，或擁有您授與的特定 儀錶板許可權 。
• 功能啟用： 已啟用 面板 。 如果停用，則不會顯示任何工作追蹤分析小工具。 若要重新啟用它，請參閱 開啟或關閉服務。
• 工作感知： 請注意本文稍後所列的必要和建議工作。

將小工具新增至儀錶板

1. 如果您尚未設定小組的面板，請加以設定。

   • 定義支援工作流程程序的數據行和泳道。

2. 將小工具新增至儀錶板。 有兩個小工具：週期時間和前置時間。 選取您要顯示與設定的 。 如需詳細資訊，請參閱使用

設定週期時間和潛在客戶時間小工具

[設定] 對話框與 [周期時間] 和 [前置時間] 小工具相同。 為小組設定這些小工具。 如需詳細資訊，請參閱 建立或新增小組。

1. 選取操作功能表圖示，然後選取 [設定] 以開啟組態對話框。

2. 修改標題，然後選取您想要監視的值：

   • 球隊
   • 工作項目
   • 泳道
   • 欄位準則
   • 時段

   

   若要選取 泳道，您必須選取 待辦專案。

   注意

   您只能選取已新增至待辦專案的工作項目類型。 若要將工作專案類型新增至待辦專案，請參閱自定義待辦專案或面板（繼承程式）。 如需內部部署 XML 進程，請參閱 處理組態 XML 元素參考。

3. 若要進一步篩選用來計算潛在客戶或週期時間的工作專案，請指定 Field Criteria。 例如，[發行] 欄位設定為 [里程碑 1] 的所有工作專案。

   

   注意

   未提供任何值給篩選，可能會導致選取所有工作專案，或可能是根據篩選準則類型而無效的篩選自變數。

4. 針對連續流程，選取 [ 滾動期間 ]，並指定您想要在圖表上檢視的天數。

   或者，針對固定範圍檢視，選取並指定 開始日期。 如果您的小組採用 Scrumban 程式或遵循標準短期衝刺程式，請選取此檢視。 這兩種圖表類型的主要差異在於固定範圍圖表在大部分情況下提供範圍變更的資訊。

5. 當完成時，選擇儲存。 下圖顯示顯示 60 天數據的範例潛在客戶時程圖表。

   

   若要讓潛在客戶時間和週期時程圖表提供有用的數據，您的小組必須快速 更新小工具追蹤之工作項目的狀態 。

解譯散佈圖控件圖表

前置時間和週期時間小工具都會顯示為散佈圖控件圖表。 它們會顯示摘要資訊，並提供數個互動式元素。

範例潛在客戶時間小工具

圖表點代表已完成的工作專案，而其水平軸上的位置代表小組完成的日期。 其垂直軸上的位置代表計算的前置時間或週期時間。

• 較大的點代表具有相同前置時間或週期時間的多個工作專案
• 點色彩對應至圖例中顯示的工作項目類型
• 深灰色點對應至工作項目類型的混合

摘要元素

• 針對針對圖表設定的主要工作項目類型，平均天數（平均前置時間或週期時間）。 這個數位可能不等於所有工作專案的平均週期時間或前置時間。 這取決於您用於小工具的設定。 平均數目是根據小組花費時間進行工作專案的每一天計算。
• 圖表計算中使用的待辦項目數目。 如果有三種以上的工作項目類型，您會看到其他專案的摘要。
• 黑色趨勢線表示移動平均。
• 趨勢線周圍的帶會顯示標準偏差。

互動式元素

• 將滑鼠停留在任何點上，以查看哪些工作專案參與數據點，以及這些專案的前置時間或週期時間。
• 選取一個點以開啟列出工作專案的工作項目或查詢。
• 選取圖例中的工作項目類型來篩選圖表， 以篩選該類型。 若要返回原始圖表，請重新整理儀錶板。

移動平均和標準偏差計算

• 每日移動平均值會對應到落在移動平均視窗中的數據點平均值。 以時間為基礎的移動平均時間範圍是根據目前日和前 N 天計算。 N 對應到圖表顯示的 20% 天數，捨入到最接近的奇數。

  例如，如果圖表顯示過去 30 天，則 N = 5 天。 30 天中的 20% 是六天四捨五入到最接近的奇數，也就是 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 - 取得小工具。

相關文章

• 取得累計流程、前置時間和週期時間的指引
• 瞭解工作流程看板
• 檢視和設定累計流量圖
• 瞭解待處理專案和面板中的工作流程狀態
• 探索 Agile、Scrum 和 CMMI 程式