Abrir bugs ou relatórios de amostra de histórias de usuários

Artigo
10/16/2024

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

Para gerar um relatório que lista bugs abertos ou histórias de usuários, selecione o relatório Matriz no Power BI e use uma consulta semelhante às fornecidas neste artigo. O relatório gerado lista bugs abertos ou histórias de usuários divididos por campos Estado e Atribuído a , conforme mostrado na imagem a seguir.

Captura de tela do relatório de matriz de amostra do Open Bugs.

Observação

Este artigo pressupõe que você leia Visão geral dos relatórios de exemplo usando consultas OData e tenha uma compreensão básica do Power BI.

Pré-requisitos

Níveis de acesso: você deve ser membro de um projeto com acesso básico ou superior.
Permissões: por padrão, os membros do projeto têm permissão para consultar o Analytics e criar vistas da propriedade.
Para obter mais informações sobre outros pré-requisitos relacionados à ativação de serviços e recursos e atividades gerais de rastreamento de dados, consulte Permissões e pré-requisitos para acessar o Analytics.

Consultas de exemplo

Várias consultas são fornecidas para filtrar bugs ou histórias de usuários por caminho de área, caminho de iteração ou equipe. Todas essas consultas especificam o conjunto de entidades, WorkItems pois retornam dados atuais e não históricos.

Observação

Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para Azure Boards. Você pode filtrar suas consultas ou retornar propriedades usando qualquer um dos Property valores em um EntityType ou NavigationPropertyBinding Path valores disponíveis com um EntitySet. Cada EntitySet corresponde a um EntityType. Para obter mais informações sobre o tipo de dados de cada valor, examine os metadados fornecidos para o EntityType.

Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Consulta em Branco de Dados>. Para obter mais informações, consulte Visão geral de relatórios de exemplo usando consultas 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

Você pode usar o código de consulta OData a seguir para modificar ou testar a consulta antes de usá-la no Power BI. Para obter mais informações, consulte Conectar-se usando consultas do Power BI e OData.

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)

Cadeias de caracteres de substituição e detalhamento de consulta

Substitua as cadeias de caracteres a seguir pelos valores. Não inclua colchetes {} com sua substituição. Por exemplo, se o nome da sua organização for "Fabrikam", substitua por {organization}Fabrikam, não {Fabrikam}.

{organization} - Nome da sua organização
{project} - O nome do seu projeto de equipe ou omita totalmente "/{project}" para uma consulta entre projetos
{areapath} - Seu caminho de área. Formato de exemplo: Project\Level1\Level2

Detalhamento da consulta

A tabela a seguir descreve cada parte da consulta.

Parte da consulta

Descrição

$filter=WorkItemType eq 'Bug'

Bugs de retorno.

and StateCategory ne 'Completed'

Filtre os itens concluídos. Para obter mais informações sobre categorias de estado, consulte Como os estados de categoria de fluxo de trabalho são usados em listas de pendências e quadros do Azure Boards.

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

E filtre itens de trabalho em um Caminho de Área específico. Para filtrar por Nome da equipe, use a instrução Teams/any(x:x/TeamName eq '{teamname})'filter .

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

Selecione os campos a serem retornados.

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

Selecione campos AssignedTode propriedade expansíveis , Iteration, Area.

Histórias de usuários filtradas por equipes

Você pode consultar bugs abertos por uma ou mais equipes em vez de Caminho da área.

Consulta do Power BI
Consulta 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

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)

Histórias de usuário em um caminho de área específico e caminho de iteração

A consulta a seguir dá suporte à filtragem de histórias de usuário para um Caminho de Área e um Caminho de Iteração específicos.

Consulta do Power BI
Consulta 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

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)

(Opcional) Renomear consulta

Você pode renomear o rótulo de consulta padrão, Query1, para algo mais significativo. Basta inserir um novo nome no painel Configurações de Consulta .

Captura de tela das opções de menu de consulta do Power BI, renomear consulta.

Expandir colunas em Editor do Power Query

A &$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath) cláusula retorna registros que contêm vários campos. Antes de criar o relatório, você precisa expandir o registro para nivelá-lo em campos específicos. Nesse caso, você desejará expandir os seguintes registros:

AssignedTo
AreaPath
IterationPath

Para saber como, confira Transformar dados do Analytics para gerar relatórios do Power BI.

(Opcional) Renomear campos

Depois de expandir as colunas, você pode querer renomear um ou mais campos. Por exemplo, você pode renomear a coluna AreaPath para Area Path. Para saber como, consulte Renomear campos de coluna.

Feche a consulta e aplique suas alterações

Depois de concluir todas as transformações de dados, escolha Fechar e Aplicar no menu Página Inicial para salvar a consulta e retornar à guia Relatório no Power BI.

Criar o relatório de matriz

No Power BI, escolha o relatório de matriz em Visualizações.
Adicionar Assigned To às linhas.
Adicionar State às colunas.
Adicione 1WorkItemId1 a Valores e clique com o botão direito do mouse em 1WorkItemId' e verifique se a Contagem está selecionada.

O relatório de exemplo é exibido.

Captura de tela do relatório de matriz de Bugs Abertos de Amostra.

Compartilhar via

Abrir bugs ou relatórios de amostra de histórias de usuários

Pré-requisitos

Consultas de exemplo

Bugs filtrados por Caminho de área

Cadeias de caracteres de substituição e detalhamento de consulta

Detalhamento da consulta

Histórias de usuários filtradas por equipes

Histórias de usuário em um caminho de área específico e caminho de iteração

(Opcional) Renomear consulta

Expandir colunas em Editor do Power Query

(Opcional) Renomear campos

Feche a consulta e aplique suas alterações

Criar o relatório de matriz

Comentários

Recursos adicionais

Compartilhar via

Abrir bugs ou relatórios de amostra de histórias de usuários

Pré-requisitos

Consultas de exemplo

Bugs filtrados por Caminho de área

Cadeias de caracteres de substituição e detalhamento de consulta

Detalhamento da consulta

Histórias de usuários filtradas por equipes

Histórias de usuário em um caminho de área específico e caminho de iteração

(Opcional) Renomear consulta

Expandir colunas em Editor do Power Query

(Opcional) Renomear campos

Feche a consulta e aplique suas alterações

Criar o relatório de matriz

Artigos relacionados

Comentários

Recursos adicionais