Relatório de exemplo de pacote cumulativo de progresso de recursos
Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019
Este artigo mostra como criar um relatório de barras empilhadas para exibir o progresso dos Recursos com base em Histórias de Usuário infantis concluídas. O relatório exibe a porcentagem concluída por acúmulo de Pontos de História para um determinado conjunto de Recursos ativos. Um exemplo é mostrado na imagem a seguir.
Você pode visualizar gráficos de barras de progresso semelhantes da sua lista de pendências adicionando uma coluna de rollup. Para saber como, consulte Exibir progresso ou totais do rollup.
Nota
Este artigo pressupõe que você leu Visão geral de relatórios de exemplo usando consultas OData e tem uma compreensão básica do Power BI.
Pré-requisitos
- Nível de acesso: Você deve ser membro de um projeto com acesso Básico ou superior.
- Permissão: por padrão, os membros do projeto têm permissão para consultar o Google Analytics e criar exibições.
- Para obter mais informações sobre outros pré-requisitos relacionados à ativação de serviços e recursos e atividades gerais de controle de dados, consulte Permissões e pré-requisitos para acessar o Google Analytics.
Consultas de amostra
O progresso do recurso consulta a WorkItems
entidade para obter o estado atual do progresso.
Nota
Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para painéis do Azure. 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
um corresponde a um EntityType
arquivo . Para obter mais informações sobre o tipo de dados de cada valor, revise os metadados fornecidos para o .EntityType
Revisar o progresso do recurso com base em um caminho de área
Você pode colar a consulta do Power BI listada abaixo 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 'Feature' "
&"and State ne 'Removed' "
&"and startswith(Area/AreaPath,'{areapath}') "
&"and Descendants/any()"
&"&$select=WorkItemId,Title,Area,Iteration,AssignedTo,WorkItemType,State,AreaSK"
&"&$expand=Descendants( "
&"$apply=filter(WorkItemType eq 'User Story') "
&"/groupby((StateCategory), "
&"aggregate(StoryPoints with sum as TotalStoryPoints)) "
&") "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Cadeias de caracteres de substituição e detalhamento de consulta
Substitua as seguintes cadeias de caracteres por seus valores. Não inclua parênteses com a {} sua substituição. Por exemplo, se o nome da sua organização for "Fabrikam", substitua {organization}
por Fabrikam
, não {Fabrikam}
.
{organization}
- Nome da sua organização{project}
- O nome do seu projeto de equipe, ou omitir/{project}
completamente, para uma consulta entre projetos{areapath}
- O Caminho da Sua Área. Exemplo de formato:Project/Level1/Level2
.
Detalhamento da consulta
A tabela a seguir descreve cada parte da consulta.
Parte da consulta
Descrição
$filter=WorkItemType eq 'Feature'
Retornar recursos.
and State ne 'Cut'
Omitir recursos marcados como Recortar.
and startswith(Area/AreaPath,'{areapath}')
Retornar itens de trabalho em um Caminho de Área específico. A substituição por Area/AreaPath eq '{areapath}'
retorna itens 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 .
and Descendants/any()
Filtre todos os itens de trabalho que tenham pelo menos um ou "qualquer" descendente. Inclui todos os recursos com pelo menos um item de trabalho filho. Para obter todos os itens de trabalho com seus descendentes, mesmo que eles não tenham nenhum, execute uma consulta sem o Descendants/any()
filtro. Para omitir Recursos que não têm Histórias de Usuário filhas, substitua por any(d:d/WorkItemType eq 'User Story')
.
Para todos os itens de trabalho com e sem descendentes:
$filter=endswith(Area/AreaPath,'suffix')
&$select=WorkItemId,Title,WorkItemType,State,Area, Descendants
&$expand=Descendants($select=WorkItemId)
Para todos os itens de trabalho com pelo menos um descendente:
$filter=endswith(Area/AreaPath, 'suffix')and Descendants/any()
&$select=WorkItemId,Title,WorkItemType,State,Area, Descendants
&$expand=Descendants($select=WorkItemId)
&$select=WorkItemId, Title, WorkItemType, State
Selecione as propriedades a serem retornadas.
&$expand=Descendants(
Início da cláusula de expansão Descendants
$apply=filter(WorkItemType eq 'User Story')
Filtre os descendentes. Inclua apenas Histórias de Usuário (omita Tarefas e Bugs).
/groupby((StateCategory),
Agrupe o pacote cumulativo por StateCategory. Para obter mais informações sobre Categorias de Estado, consulte Como os estados do fluxo de trabalho e as categorias de estado são usados em Listas de Pendências e Painéis.
aggregate(StoryPoints with sum as TotalStoryPoints))
Soma agregada de Pontos de História.
)
Cláusula de fechamento Descendants()
.
Revisar o progresso do recurso para uma equipe
A consulta a seguir é a mesma usada acima, exceto que filtra por Nome da Equipe em vez de Caminho de Área.
Você pode colar a consulta do Power BI listada abaixo 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 'Feature' "
&"and State ne 'Cut' "
&"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 Descendants/any() "
&"&$select=WorkItemId,Title,WorkItemType,State,AreaSK "
&"&$expand=Descendants( "
&"$apply=filter(WorkItemType eq 'User Story') "
&"/groupby((StateCategory), "
&"aggregate(StoryPoints with sum as TotalStoryPoints)) "
&") "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Transformar os dados no Power Query Editor
A consulta retorna várias colunas que você precisa expandir antes de poder usá-las para criar um relatório. Qualquer entidade puxada usando uma instrução OData $expand retorna um registro com potencialmente vários campos. Expanda o registro para nivelar a entidade em seus campos.
Para o relatório de progresso do recurso, você precisará realizar as seguintes transformações:
- Expanda a
Descendants
coluna em duas colunas:Descendants.StateCategory
eDescendants.TotalStoryPoints
- Aplicar transformação de Coluna Dinâmica na
Descendants.StateCategory
coluna para separar categorias de Estado individuais - Substitua valores nulos em todas as colunas dinâmicas.
- Adicione uma coluna personalizada para representar a porcentagem concluída. A coluna personalizada exibirá erros se houver colunas nulas nas colunas de Estado pivotadas.
Para saber como, consulte as seguintes seções em Transformar dados do Analytics para gerar relatórios do Power BI:
- Expanda a coluna Descendentes.
- Coluna Pivot Descendants.StateCategory.
- Substitua valores nulos.
- Criar uma coluna calculada de porcentagem concluída
Nota
Neste exemplo, os valores de Estado para User Story incluem Proposed, In Progress e Completed.
Feche a consulta e aplique as alterações
Depois de concluir todas as suas transformações de dados, escolha Fechar & Aplicar no menu Início para salvar a consulta e retornar à guia Relatório no Power BI.
Criar o relatório de gráfico de barras empilhadas
No Power BI, escolha Relatório de gráfico de barras empilhado em Visualizações.
Adicionar
Title
ao eixo Y.Adicione
PercentComplete
ao Eixo X, clique com o botão direito do mouse e selecione Soma.
O relatório de exemplo é exibido.
Artigos relacionados
- Visão geral de relatórios de exemplo usando consultas OData
- Construir consultas OData para o Google Analytics
- Conectar-se usando consultas do Power BI e OData
- Referência de metadados para o Azure Boards Analytics
- Exemplos de relatórios e índice de referência rápida
- Adicionar uma segmentação de dados de equipe a um relatório existente