共用方式為

錯誤趨勢範例報告

  • 發行項

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

Bug 趨勢報告對於瞭解小組關閉作用中的 Bug 有多實用。 本文說明如何在一段時間內顯示處於指定狀態的 Bug 數目。 下圖顯示錯誤趨勢報告的範例。

錯誤趨勢折線圖報告的螢幕快照。

注意

本文假設您已閱讀 使用 OData 查詢 的範例報表概觀，並具備 Power BI 的基本瞭解。

必要條件

  • 存取：至少是具有基本存取權的項目成員。
  • 許可權： 根據預設，項目成員具有查詢分析及建立檢視的許可權。
  • 如需有關服務與功能啟用和一般數據追蹤活動之其他必要條件的詳細資訊，請參閱 存取分析的許可權和必要條件。

範例查詢

下列查詢會從 WorkItemSnapshot 實體集傳回數據，以支持產生趨勢報表。

注意

若要判斷篩選或報表用途的可用屬性，請參閱 Azure Boards 的元數據參考。 您可以使用的 或 NavigationPropertyBinding Path 值EntitySet底下EntityType的任何Property值來篩選查詢或傳回屬性。 每個 EntitySet 對應至 EntityType。 如需每個值之數據類型的詳細資訊，請檢閱針對對應 EntityType提供的元數據。

依區域路徑篩選的錯誤趨勢

下列查詢會依區域路徑和開始日期篩選 Bug。

將下列 Power BI 查詢直接複製並貼到 [取得資料>空白查詢] 視窗中。 如需詳細資訊，請參閱 使用 OData 查詢的範例報表概觀。

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate}  "
            &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
            &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

替代字串和查詢明細

以您的值取代下列字串。 請勿在替代中包含括號 {} 。 例如，如果您的組織名稱為 「Fabrikam」 ，請將 取代 {organization} 為 Fabrikam，而非 {Fabrikam}。

  • {organization} - 您的組織名稱
  • {project} - 針對跨項目查詢，您的小組專案名稱或完全省略 “/{project}”
  • {areapath} - 您的區域路徑。 範例格式： Project\Level1\Level2
  • {startdate} - 針對指定日期或之後完成的專案啟動報表，格式為： YYYY-MM-DDZ。 例如： 2022-04-01Z 代表 2022 年 4 月 1 日。 不要以引號括住。

查詢明細

下表描述查詢的每個部分。

查詢元件

說明

$apply=filter(

filter 語句子句的開頭。

WorkItemType eq 'Bug'

傳回 Bug。

and State ne 'Closed'

省略處於已關閉狀態的 Bug。

and startswith(Area/AreaPath,'{areapath}')

傳回您在'{areapath}' 中指定的特定區域路徑下的工作專案。 若要依小組名稱進行篩選，請使用 filter 語句 Teams/any(x:x/TeamName eq '{teamname})'。

and DateValue ge {startdate}

指定日期或之後的開始趨勢。 範例： 2021-04-01Z 代表 2021-April-01。

)

Close filter() 子句。

/groupby(

Start groupby() 子句。

(DateValue, State, WorkItemType, Priority, Severity, Area/AreaPath, Iteration/IterationPath),

依 DateValue分組，用於趨勢，以及您想要報告的任何其他欄位。

aggregate($count as Count)

藉由計算符合每個日期準則的 Bug 來匯總。

)

Close groupby() 子句。

由 Teams 篩選的錯誤趨勢

您可以依小組名稱而非區域路徑查詢錯誤趨勢。

將下列 Power BI 查詢直接複製並貼到 [取得資料>空白查詢] 視窗中。 如需詳細資訊，請參閱 使用 OData 查詢的範例報表概觀。

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}')"
            &"and DateValue ge {startdate}  "
            &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
            &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

每個星期五快照集的錯誤趨勢

使用每周快照集可減少提取至 Power BI 的數據量，並增加查詢效能。

將下列 Power BI 查詢直接複製並貼到 [取得資料>空白查詢] 視窗中。 如需詳細資訊，請參閱 使用 OData 查詢的範例報表概觀。

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate} "
            &"and Date/DayName eq 'Friday'  "
        &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

每個月第一個快照集的 Bug 趨勢

使用每月快照集可減少提取至 Power BI 的數據量，並增加查詢效能。

將下列 Power BI 查詢直接複製並貼到 [取得資料>空白查詢] 視窗中。 如需詳細資訊，請參閱 使用 OData 查詢的範例報表概觀。

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate} "
            &"and Date/DayOfMonth eq 1  "
        &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

（選擇性）重新命名查詢

您可以將預設查詢標籤 Query1 重新命名為更有意義的專案。 只要從 [ 查詢設定 ] 窗格輸入新名稱即可。

Power BI 查詢功能表選項、重新命名查詢的螢幕快照。

展開 Power BI 中的數據行

Area/AreaPath展開和 Iteration/IterationPath 數據行。 展開數據行會將記錄扁平化為特定欄位。 若要瞭解如何，請參閱 轉換分析數據以產生 Power BI 報表。

（選擇性）重新命名字段

展開數據行之後，您可能會想要重新命名一或多個字段。 例如，您可以將資料列 AreaPath 重新命名為 Area Path。 若要瞭解如何，請參閱 重新命名數據行欄位。

關閉查詢並套用您的變更

完成所有數據轉換之後，請從 [常用] 功能表選擇 [關閉及套用]，以儲存查詢並返回 Power BI 中的 [報表] 索引卷標。

Power Query 編輯器 [關閉並套用] 選項的螢幕快照。

建立折線圖報表

  1. 在 Power BI 中，選擇 [視覺效果] 底下的折線圖報表。

    Power BI [視覺效果] 和 [錯誤趨勢] 報表的 [字段] 選取項目的螢幕快照。

  2. 將 「新增至 X 軸，然後以滑鼠右鍵按下DateValue並選取 DateValue ，而不是Date Hierarchy。DateValue

  3. 新增 Count 至 Y 軸，然後按下滑鼠右鍵 Count ，並確定 已選取 [總和 ]。

  4. 新增 State 至 圖例。

範例報表隨即顯示。

範例錯誤趨勢折線圖報告的螢幕快照。

修改報表格式視覺效果

  • 若要修改報表的格式元素，請選擇 [格式化您的視覺效果 ] 圖示 （paintbrush） 圖示，並修改一或多個可用的設定。 例如，您可以修改趨勢圖中使用的折線色彩。

    適用於 Bug 趨勢報表的 Power BI 格式視覺效果選取項目螢幕快照。

如需詳細資訊，請參閱 開始使用格式化窗格。