Relatório de amostra de lead time e tempo de ciclo
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Você pode criar gráficos de prazo de entrega e de ciclo usando as consultas fornecidas neste artigo. O lead time e o tempo de ciclo indicam quanto tempo leva para o trabalho fluir pelo pipeline de desenvolvimento de uma equipe. O lead time mede o tempo total decorrido desde a criação dos itens de trabalho até a sua conclusão. O tempo de ciclo mede o tempo que uma equipe leva para concluir itens de trabalho quando começa a trabalhar ativamente neles.
A imagem a seguir mostra um exemplo de lead time médio dividido por atribuições de prioridade feitas às histórias de usuários.
Para saber mais sobre lead e tempo de ciclo, consulte widgets Lead Time e Cycle Time e Orientação de fluxo cumulativo, lead time e tempo de ciclo.
Observação
Este artigo pressupõe que você tenha lido Visão geral de relatórios de exemplo usando consultas OData e tenha uma compreensão básica do Power BI.
Pré-requisitos
- Para exibir dados do Analytics e consultar o serviço, você precisa ser membro de um projeto com acesso básico ou superior. Por padrão, todos os membros do projeto recebem permissões para consultar Análise e definir exibições do Analytics.
- Para saber mais sobre outros pré-requisitos relacionados à habilitação de serviço e recursos e atividades gerais de acompanhamento de dados, consulte Permissões e pré-requisitos para acessar o Analytics.
Consultas de exemplo
As consultas nesta seção oferecem suporte ao retorno de dados de lead e tempo de ciclo para Histórias de Usuário concluídas. Você pode consultar por caminho de área ou nome(s) de equipe. Todas essas consultas especificam o WorkItems
conjunto de entidades à medida que retornam dados calculados para cada item de trabalho pelo serviço do Google Analytics.
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 saber mais sobre o tipo de dados de cada valor, examine os metadados fornecidos para o correspondente EntityType
.
Tempo de execução e tempo de ciclo de retorno para histórias de usuários e 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, examine 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 'User Story' "
&"and StateCategory eq 'Completed' "
&"and CompletedDate ge {startdate} "
&"and startswith(Area/AreaPath,'{areapath}') "
&"&$select=WorkItemId,Title,WorkItemType,State,Priority,AreaSK "
&",CycleTimeDays,LeadTimeDays,CompletedDateSK "
&"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
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 projeto da sua equipe, ou omitir "/{project}" completamente, para uma consulta entre projetos{areapath}
- Seu caminho de área. Exemplo de formato:Project\Level1\Level2
{startdate}
- Inicie seu relatório para itens concluídos em ou após uma determinada data com o formato:YYYY-MM-DDZ
. Por exemplo:2022-04-01Z
representa 2022-abril-01. Não coloque entre aspas.
Detalhamento da consulta
A tabela a seguir descreve cada parte da consulta.
Parte da consulta
Descrição
$filter=WorkItemType eq 'User Story'
Retornar dados para Histórias de Usuário.
and StateCategory eq 'Completed'
Retornar apenas itens concluídos. O sistema calcula valores para Lead Time Days e Cycle Time Days somente para itens de trabalho que foram concluídos.
Observação
Se você olhar para os dados brutos de registros, você pode ver entradas onde CycleTimeDays=0
. Isso ocorre quando a História do Usuário ou o item de trabalho entra em um estado de categoria de fluxo de trabalho Em andamento e Concluído no mesmo dia. Para obter mais informações sobre categorias de estado de fluxo de trabalho, consulte Como os estados de fluxo de trabalho e as categorias de estado são usados em Listas de Pendências e Quadros.
and CompletedDate ge {startdate}
Retornar itens que são concluídos após a data especificada. Exemplo: 2022-04-01Z representa 2022-abril-01
and startswith(Area/AreaPath,'{areapath}')
Retorne itens de trabalho em um Caminho de Área específico especificado em'{areapath}'
. Para filtrar por nome de equipe, use a instrução Teams/any(x:x/TeamName eq '{teamname})'
filter .
&$select=WorkItemId, Title, WorkItemType, State, Priority
Selecione as propriedades a serem retornadas.
, CycleTimeDays, LeadTimeDays, CompletedDateSK
Retorne as propriedades que oferecem suporte a Lead Time Days, Cycle Time Days e CompletedDateSK
. CompletedDateSK retorna um valor de data como um inteiro
&$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath)
Expanda as propriedades de AssignedTo
, Iteration
e Area
entidades e selecione campos de entidade para elas.
Tempo de Entrega e Tempo de Ciclo de Retorno para Histórias de Usuários e equipes
Essa consulta é a mesma fornecida na seção anterior, exceto que filtra por vários nomes de equipe em vez de caminhos 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, examine 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 'User Story' "
&"and StateCategory eq 'Completed' "
&"and CompletedDate ge {startdate} "
&"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,AreaSK "
&",CycleTimeDays,LeadTimeDays,CompletedDateSK "
&"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
(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 .
Transformar dados no Power Query Editor
No Editor do Power Query, escolha a consulta com os dados que pretende transformar. Para um gráfico de tempo de Lead/Cycle, convém fazer as seguintes transformações:
- Expanda colunas como
Area
,Iteration
eAssignedTo
. - Transforme o tipo de dados das
LeadTimeDays
colunas eCycleTimeDays
em um número inteiro. - Transforme o tipo de dados da
CompletedDateSK
coluna de um inteiro em um valor de data.
Para saber como, consulte as seguintes seções em Transformar dados do Analytics para gerar relatórios do Power BI:
- Expandir colunas.
- Transforme as colunas LeadTimeDays e CycleTimeDays em números inteiros.
- Transformar um tipo de dados de coluna.
Feche a consulta e aplique suas alterações
Depois de concluir todas as transformações de dados, escolha Fechar & Aplicar no menu Página Inicial para salvar a consulta e retornar à guia Relatório no Power BI.
Criar o gráfico de tendências
No exemplo a seguir, a consulta foi renomeada para LeadCycleTime, mas nenhuma coluna foi renomeada.
No Power BI, escolha o relatório Gráfico de linhas em Visualizações.
Adicionar
CompletedDateSK
ao eixo X.Adicione
LeadTimeDays
ao eixo Y, clique com o botão direito do mouse e selecione Média.Adicionar
Priority
à Legenda.
O relatório de exemplo é exibido. Observe que, à medida que você passa o mouse sobre qualquer área no relatório, mais dados são mostrados.
Artigos relacionados
- Visão geral de relatórios de exemplo usando consultas OData
- Construir consultas OData para Análise
- Conectar-se usando consultas do Power BI e OData
- Referência de metadados para o Azure Boards Analytics
- Relatórios de exemplo e índice de referência rápida
- Adicionar uma segmentação de equipe a um relatório existente
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de