다음을 통해 공유


버그 또는 사용자 스토리 샘플 보고서 열기

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

열려 있는 버그 또는 사용자 스토리를 나열하는 보고서를 생성하려면 Power BI에서 행렬 보고서를 선택하고 이 문서에 제공된 것과 유사한 쿼리를 사용합니다. 생성한 보고서에는 다음 이미지와 같이 상태할당 대상 필드별로 세분화되어 있는 열린 버그 또는 사용자 스토리가 나열됩니다.

버그 열기 샘플 행렬 보고서의 스크린샷.

참고 항목

이 문서에서는 OData 쿼리를 사용하여 샘플 보고서 개요를 읽고 Power BI에 대한 기본적인 이해를 가지고 있다고 가정합니다 .

필수 조건

  • 액세스: 최소한 기본 액세스 권한이 있는 프로젝트의 멤버여야 합니다.
  • 사용 권한: 기본적으로 프로젝트 멤버는 분석을 쿼리하고 뷰를 만들 수 있는 권한이 있습니다.
  • 서비스 및 기능 사용 및 일반 데이터 추적 활동과 관련된 기타 필수 구성 요소에 대한 자세한 내용은 Analytics에 액세스하기 위한 사용 권한 및 필수 구성 요소를 참조 하세요.

샘플 쿼리

영역 경로, 반복 경로 또는 팀을 통해 버그 또는 사용자 스토리를 필터링하는 여러 쿼리가 제공됩니다. 이러한 모든 쿼리는 기록 데이터가 아닌 현재 데이터를 반환할 때 엔터티 집합을 지정 WorkItems 합니다.

참고 항목

필터 또는 보고서 용도로 사용 가능한 속성을 확인하려면 Azure Boards에 대한 메타데이터 참조를 참조 하세요. 에서 사용할 수 있는 값 또는 아래 값을 Property 사용하여 쿼리를 EntityType 필터링하거나 NavigationPropertyBinding Path 속성을 반환할 수 있습니다 EntitySet. 각각 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'

버그를 반환합니다.

and StateCategory ne 'Completed'

완료된 항목을 필터링합니다. 상태 범주에 대한 자세한 내용은 Azure Boards 백로그 및 보드에서 워크플로 범주 상태를 사용하는 방법을 참조 하세요.

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

특정 영역 경로에서 작업 항목을 필터링합니다. 팀 이름으로 필터링하려면 필터 문을 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)

확장 가능한 속성 필드를 AssignedToIterationArea선택합니다.

팀별로 필터링된 사용자 스토리

영역 경로가 아닌 하나 이상의 팀에서 열린 버그를 쿼리할 수 있습니다.

다음 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

방법을 알아보려면 Analytics 데이터 변환을 참조 하여 Power BI 보고서를 생성합니다.

(선택 사항) 필드 이름 바꾸기

열을 확장한 후에는 하나 이상의 필드 이름을 바꿀 수 있습니다. 예를 들어 열 AreaPath Area Path의 이름을 .로 바꿀 수 있습니다. 방법을 알아보려면 열 필드 이름을 바꿉니다.

쿼리를 닫고 변경 내용 적용

모든 데이터 변환을 완료한 후 홈 메뉴에서 닫기 및 적용 을 선택하여 쿼리를 저장하고 Power BI의 보고서 탭으로 돌아갑니다.

Power Query 편집기 닫기 및 적용 옵션의 스크린샷

행렬 보고서 만들기

  1. Power BI의 시각화에서 행렬 보고서를 선택합니다.

    버그 열기 보고서에 대한 Power BI 시각화 및 필드 선택 스크린샷

  2. 행에 추가 Assigned To 합니다.

  3. 열에 추가 State 합니다.

  4. 에 1WorkItemId1을 추가하고 1WorkItemId'를 마우스 오른쪽 단추로 클릭하고 개수가 선택되어 있는지 확인합니다.

보고서 예제가 표시됩니다.

샘플 버그 열기 행렬 보고서의 스크린샷.