Compartilhar via

Relatório de amostra de tempo de entrega e tempo de ciclo

  • Artigo

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

Você pode criar gráficos de lead time e ciclo usando as consultas fornecidas neste artigo. O tempo de espera 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 de itens de trabalho até sua conclusão. O tempo de ciclo mede o tempo que uma equipe leva para concluir os 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ário.

Captura de tela do relatório de gráfico de tendências do Tempo de Ciclo de Lead do Power BI.

Para obter mais informações sobre lead time e tempo de ciclo, consulte Widgets Lead Time e Cycle Time e Orientação cumulativa de fluxo, 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

  • 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 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

As consultas nesta seção dão suporte ao retorno de dados de tempo de lead e 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 de Análise.

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.

Tempo de Retorno e Tempo de Ciclo para Histórias de Usuário e Caminho da Á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 seu projeto de equipe ou omita totalmente "/{project}" para uma consulta entre projetos
  • {areapath} - Seu caminho de área. Formato de exemplo: 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 01 de abril de 2022. 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'

Devolva apenas itens concluídos. O sistema calcula valores para Dias de lead time e Dias de tempo de ciclo somente para itens de trabalho que foram concluídos.

Observação

Se você observar os dados brutos dos registros, poderá ver entradas em que CycleTimeDays=0. Isso ocorre quando a História do Usuário ou 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}

Devolva os itens 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 que você especificar'{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 Dias de Prazo de Entrega, Dias de Tempo de Ciclo e CompletedDateSK. CompletedDateSK retorna um valor de data como um número inteiro

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

Expanda as propriedades de AssignedTo, Iteratione Area entities e selecione os campos de entidade para eles.

Tempo de Retorno e Tempo de Ciclo para Histórias de Usuário 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 .

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

Transformar dados no Editor do Power Query

No Editor do Power Query, escolha a consulta com os dados que você deseja transformar. Para um gráfico de tempo de lead/ciclo, você desejará fazer as seguintes transformações:

  • Expanda colunas como Area, Iteratione AssignedTo.
  • Transforme o tipo de dados das LeadTimeDays colunas e CycleTimeDays em um número inteiro.
  • Transforme o tipo de dados da CompletedDateSK coluna de um inteiro em um valor de data.

Para saber como, confira as seguintes seções em Transformar dados do Analytics para gerar relatórios do Power BI:

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.

Captura de tela da opção Fechar e Aplicar Editor do Power Query.

Criar o gráfico de tendências

No exemplo a seguir, a consulta foi renomeada para LeadCycleTime, mas nenhuma coluna foi renomeada.

  1. No Power BI, escolha o relatório Gráfico de linhas em Visualizações.

    Captura de tela das seleções de Visualizações e Campos do Power BI para o relatório de gráfico de tendências de Lead Time.

  2. Adicione CompletedDateSK ao eixo X.

  3. Adicione LeadTimeDays ao eixo Y, clique com o botão direito do mouse e selecione Média.

  4. 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.

Captura de tela do relatório de gráfico de tendências de Tempo de Ciclo de Lead do Power BI de exemplo.