Relatório de amostra de prazo de entrega 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 ciclo usando as consultas fornecidas neste artigo. O tempo de espera e o tempo de ciclo indicam quanto tempo leva para o trabalho fluir através do pipeline de desenvolvimento de uma equipe. O lead time mede o tempo total decorrido desde a criação de 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 tempo médio de entrega dividido por atribuições de prioridade feitas às histórias de usuário.

Para obter mais informações sobre tempo de espera e ciclo, consulte Widgets de tempo de entrega e tempo de ciclo e Fluxo cumulativo, tempo de entrega e orientação de tempo de ciclo.

Pré-requisitos

• Acesso: Ser membro de um projeto com pelo menos acesso Básico .
• Permissões: por predefinição, os membros do projeto têm permissão para consultar o Analytics e criar vistas.
• Para obter mais informações sobre outros pré-requisitos relacionados com a ativação de serviços e funcionalidades e atividades gerais de monitorização de dados, consulte Permissões e pré-requisitos para aceder ao Analytics.

Consultas de amostra

As consultas nesta seção suportam o retorno de dados de tempo de ciclo e de lead para Histórias de usuário concluídas. Você pode consultar por caminho de área ou nome(s) da equipe. Todas essas consultas especificam o WorkItems conjunto de entidades à medida que retornam dados calculados para cada item de trabalho pelo serviço Analytics.

Retorno de tempo de entrega e tempo de ciclo para histórias de usuários e caminho de área

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

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)

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

Tempo de Retorno e Tempo de Ciclo para Histórias de Usuários e Equipes

Esta consulta é a mesma fornecida na seção anterior, exceto que filtra por vários nomes de equipe em vez de caminhos de área.

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

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)

(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/Ciclo, convém 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 para 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 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 gráfico de tendência

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

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

   

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 do relatório, mais dados são mostrados.

Artigos relacionados

• Explore relatórios de exemplo usando consultas OData
• Construir consultas OData para o Analytics
• Conectar-se ao Power BI usando consultas OData
• Consulte os metadados do Azure Boards Analytics
• Aceda a relatórios de exemplo e índice de referência rápida
• Adicionar uma segmentação de dados de equipe a um relatório existente