Пример отчета о времени выполнения и цикле

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Вы можете создавать временные и цикловые диаграммы с помощью запросов, указанных в этой статье. Время выполнения и время цикла указывают, сколько времени требуется для работы через конвейер разработки команды. Время свинца измеряет общее время, прошедшее от создания рабочих элементов до их завершения. Время цикла измеряет время, необходимое команде для завершения рабочих элементов после того, как они начнут активно работать над ними.

На следующем рисунке показан пример среднего времени выполнения, разделенного по назначениям приоритетов, сделанным для пользовательских историй.

Дополнительные сведения о времени свинца и циклах см . в мини-приложениях времени и времени цикла потенциальных операций и совокупном потоке, времени выполнения и цикле.

Примечание.

В этой статье предполагается, что вы читаете обзор примеров отчетов с помощью запросов OData и имеет базовое представление о Power BI.

Необходимые компоненты

• Доступ. Быть членом проекта с по крайней мере базовым доступом.
• Разрешения. По умолчанию члены проекта имеют разрешение на запросы аналитики и создания представлений.
• Дополнительные сведения о других предварительных требованиях для включения служб и функций и общих действий отслеживания данных см. в разделе "Разрешения и предварительные требования для доступа к аналитике".

Примеры запросов

Запросы в этом разделе поддерживают возврат данных времени свинца и цикла для завершенных пользовательских историй. Вы можете запросить по пути к области или имени группы. Все эти запросы указывают WorkItems набор сущностей, так как они возвращают данные, вычисляемые для каждого рабочего элемента службой Аналитики.

Примечание.

Сведения о доступных свойствах для фильтрации или отчета см . в справочнике по метаданным для Azure Boards. Вы можете отфильтровать запросы или возвращать свойства с помощью любого из Property значенийEntityType, доступных в разделе EntitySetили NavigationPropertyBinding Path значениях. Каждое EntitySet соответствует .EntityType Дополнительные сведения о типе данных каждого значения см. в метаданных, предоставленных для соответствующего EntityTypeзначения.

Возвращаемое время и время цикла для пользовательских историй и пути к области

Запрос Power BI

Скопируйте и вставьте следующий запрос Power BI непосредственно в окно получения пустого запроса данных>. Дополнительные сведения см. в разделе "Обзор примеров отчетов с помощью запросов 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

Запрос OData

Для изменения или тестирования запроса в Power BI можно использовать следующий код запроса OData. Дополнительные сведения см. в статье "Подключение с помощью запросов Power BI и OData".

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)

Строки подстановки и разбивка запросов

Замените следующие строки значениями. Не включайте скобки в подстановку {} . Например, если вашей организации присвоено имя Fabrikam, замените {organization} на Fabrikam, а не {Fabrikam}.

• {organization} — Название организации
• {project} — Имя проекта группы или полностью опустите "/{project}" для межпроектного запроса
• {areapath} — Путь к области. Пример формата: Project\Level1\Level2
• {startdate}— Запустите отчет для элементов, завершенных или после заданной даты с форматом: YYYY-MM-DDZ Например: 2022-04-01Z представляет 2022-апрель-01. Не заключайте в кавычки.

Разбивка запросов

В следующей таблице описана каждая часть запроса.

Часть запроса

Description

---

$filter=WorkItemType eq 'User Story'

Возвращает данные для пользовательских историй.

and StateCategory eq 'Completed'

Возвращает только завершенные элементы. Система вычисляет значения для дней времени свинца и времени цикла только для рабочих элементов, завершенных.

Примечание.

При просмотре необработанных данных записей могут отображаться записи CycleTimeDays=0. Это происходит, когда пользовательская история или рабочий элемент вводит состояние категории рабочего процесса "Ход выполнения " и завершено в тот же день. Дополнительные сведения о категориях состояний рабочего процесса см. в статье о том, как состояния рабочего процесса и категории состояний используются в невыполненных работах и досках.

and CompletedDate ge {startdate}

Возвращаемые элементы, которые завершаются после указанной даты. Пример: 2022-04-01Z представляет 2022-апрель-01

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

Возвращайте рабочие элементы в определенном пути области, в который вы указали'{areapath}'. Чтобы отфильтровать по имени команды, используйте инструкцию Teams/any(x:x/TeamName eq '{teamname})'фильтра.

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

Выберите свойства для возврата.

, CycleTimeDays, LeadTimeDays, CompletedDateSK

Возвращает свойства, поддерживающие дни времени свинца, дни цикла и CompletedDateSK. CompletedDateSK возвращает значение даты в виде целого числа

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

Разверните свойства для AssignedToIterationсущностей и сущностей и Area выберите для них поля сущностей.

Возврат времени и времени цикла для пользовательских историй и команд

Этот запрос совпадает с указанным в предыдущем разделе, за исключением того, что он фильтруется по нескольким именам команд, а не по путям к областям.

Запрос Power BI

Скопируйте и вставьте следующий запрос Power BI непосредственно в окно получения пустого запроса данных>. Дополнительные сведения см. в разделе "Обзор примеров отчетов с помощью запросов 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

Запрос OData

Для изменения или тестирования запроса в Power BI можно использовать следующий код запроса OData. Дополнительные сведения см. в статье "Подключение с помощью запросов Power BI и OData".

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)

(Необязательно) Переименование запроса

Вы можете переименовать метку запроса по умолчанию, query1, в что-то более понятное. Просто введите новое имя в области параметров запроса.

Преобразование данных в Редактор Power Query

В Редактор Power Query выберите запрос с данными, которые необходимо преобразовать. Для диаграммы времени свинца и цикла необходимо выполнить следующие преобразования:

• Разверните такие столбцы, как Area, Iterationи AssignedTo.
• Преобразуйте тип данных для LeadTimeDays столбцов в CycleTimeDays целое число.
• Преобразуйте тип данных для CompletedDateSK столбца из целого числа в значение даты.

Дополнительные сведения см. в следующих разделах в разделе "Аналитика преобразования" для создания отчетов Power BI:

• Разверните столбцы.
• Преобразуйте столбцы LeadTimeDays и CycleTimeDays в целые числа.
• Преобразование типа данных столбца.

Закройте запрос и примените изменения

Завершив все преобразования данных, нажмите кнопку "Закрыть" и "Применить " из меню "Главная ", чтобы сохранить запрос и вернуться на вкладку "Отчет " в Power BI.

Создание диаграммы трендов

В следующем примере запрос был переименован в LeadCycleTime, но столбцы не были переименованы.

1. В Power BI выберите отчет о графике в разделе "Визуализации".

   

2. Добавьте CompletedDateSK в ось X.

3. Добавьте LeadTimeDays в ось Y правой кнопкой мыши и выберите "Среднее".

4. Добавление Priority в условные обозначения.

В примере отчета отображается. Обратите внимание, что при наведении указателя мыши на любую область отчета отображаются дополнительные данные.

Связанные статьи

• Изучение примеров отчетов с помощью запросов OData
• Создание запросов OData для аналитики
• Подключение к Power BI с помощью запросов OData
• Ознакомьтесь с метаданными для Аналитики Azure Boards
• Доступ к примерам отчетов и индексу быстрого справочника
• Добавление среза команды в существующий отчет