開啟 Bug 或使用者劇本範例報告
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
若要產生列出開啟 Bug 或使用者劇本的報表,請選取 Power BI 中的 [矩陣] 報表,並使用類似本文中提供的查詢。 您產生的報表會依 [狀態] 和 [指派給] 字段細分的列表開啟 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
、、 Area
Iteration
。
依小組篩選的用戶劇本
您可以查詢一或多個小組的開啟 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 Query 編輯器 中的數據行
子 &$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath)
句會傳回包含數個字段的記錄。 在建立報表之前,您必須展開記錄,將其扁平化為特定欄位。 在此實例中,您會想要展開下列記錄:
AssignedTo
AreaPath
IterationPath
若要瞭解如何,請參閱 轉換分析數據以產生 Power BI 報表。
(選擇性)重新命名字段
展開數據行之後,您可能會想要重新命名一或多個字段。 例如,您可以將資料列 AreaPath
重新命名為 Area Path
。 若要瞭解如何,請參閱 重新命名數據行欄位。
關閉查詢並套用您的變更
完成所有數據轉換之後,請從 [常用] 功能表選擇 [關閉及套用],以儲存查詢並返回 Power BI 中的 [報表] 索引卷標。
建立矩陣報表
在 Power BI 中,選擇 [視覺效果] 底下的 [矩陣] 報表。
新增
Assigned To
至數據 列。新增
State
至數據行。將 1WorkItemId1 新增至 [值],並以滑鼠右鍵按兩下 1WorkItemId',並確定 已選取 [計數 ]。
範例報表隨即顯示。