開啟 Bug 或使用者劇本範例報告

  • 發行項

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

若要產生列出開啟 Bug 或使用者劇本的報表，請選取 Power BI 中的 [矩陣] 報表，並使用類似本文中提供的查詢。 您產生的報表會依 [狀態] 和 [指派給] 字段細分的列表開啟 Bug 或使用者劇本，如下圖所示。

開啟 Bug 範例矩陣報告的螢幕快照。

注意

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

必要條件

  • 若要檢視分析數據和查詢服務，您必須是具有基本存取權或更高許可權的項目成員。 根據預設，所有專案成員都會獲得查詢分析的許可權，並定義分析檢視。
  • 若要瞭解有關服務與功能啟用和一般數據追蹤活動的其他必要條件，請參閱 存取分析的許可權和必要條件。

範例查詢

提供數個查詢，依區域路徑、反覆專案路徑或小組篩選 Bug 或用戶劇本。 所有這些查詢都會 WorkItems 指定實體集，因為它們會傳回目前而非歷程記錄數據。

注意

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

依區域路徑篩選的錯誤

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

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Bug' "
            &"and StateCategory ne 'Completed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

替代字串和查詢明細

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

  • {organization} - 您的組織名稱
  • {project} - 針對跨項目查詢，您的小組專案名稱或完全省略 “/{project}”
  • {areapath} - 您的區域路徑。 範例格式： Project\Level1\Level2

查詢明細

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

查詢元件

說明

$filter=WorkItemType eq 'Bug'

傳回 Bug。

and StateCategory ne 'Completed'

篩選出已完成的專案。 如需狀態類別的詳細資訊，請參閱 如何在 Azure Boards 待辦專案和面板中使用工作流程類別目錄狀態。

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

並篩選特定區域路徑下的工作專案。 若要依 Team Name 進行篩選，請使用 filter 語句 Teams/any(x:x/TeamName eq '{teamname})'。

&$select=WorkItemId, Title, WorkItemType, State, Priority, Severity, TagNames

選取要傳回的欄位。

&$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath)

選取可展開的屬性欄位AssignedTo、、 AreaIteration。

依小組篩選的用戶劇本

您可以查詢一或多個小組的開啟 Bug，而不是區域路徑。

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

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Bug' "
            &"and StateCategory ne 'Completed'' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

特定區域路徑和反覆項目路徑中的用戶劇本

下列查詢支持篩選特定區域路徑和反覆專案路徑的用戶劇本。

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

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'User Story' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and startswith(Iteration/IterationPath,'{iterationpath}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

（選擇性）重新命名查詢

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

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

展開 Power Query 編輯器 中的數據行

子 &$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath) 句會傳回包含數個字段的記錄。 在建立報表之前，您必須展開記錄，將其扁平化為特定欄位。 在此實例中，您會想要展開下列記錄：

  • AssignedTo
  • AreaPath
  • IterationPath

若要瞭解如何，請參閱 轉換分析數據以產生 Power BI 報表。

（選擇性）重新命名字段

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

關閉查詢並套用您的變更

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

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

建立矩陣報表

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

    開啟 Bug 報表的 Power BI 視覺效果和字段選取項目的螢幕快照。

  2. 新增 Assigned To 至數據 列。

  3. 新增State至數據行。

  4. 將 1WorkItemId1 新增至 [值]，並以滑鼠右鍵按兩下 1WorkItemId'，並確定 已選取 [計數 ]。

範例報表隨即顯示。

範例開啟 Bug 矩陣報告的螢幕快照。