Пример отчета о схеме накопительного потока (CF)

Статья
01/10/2024

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

В этой статье показано, как отобразить NEWS CF для указанной команды. Эти данные также доступны через встроенное мини-приложение диаграммы и панели мониторинга. Дополнительные сведения об этих параметрах см. в разделе "Просмотр и настройка накопительной схемы потока".

Пример показан на следующем рисунке, где показано количество пользовательских историй с течением времени в состояниях "Исследование", "Зафиксировано", "Выполняется" и "Просмотр". Наведите указатель мыши на дату, чтобы получить сведения о данных для этой даты.

Снимок экрана: отчет диаграммы с областями с накоплением в power BI, столбцы, отсортированные в порядке столбцов доски.

Дополнительные сведения о совокупном потоке см. в разделе "Накопительный поток", "Время выполнения", "Руководство по времени цикла" и "Накопительный поток", "Время выполнения" и "Время цикла".

Примечание.

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

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

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

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

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

Примечание.

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

Запрос Power BI
Запрос OData

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

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/WorkItemBoardSnapshot?"
        &"$apply=filter( "
            &"Team/TeamName eq '{teamname}' "
            &"and BoardName eq 'Stories'  "
            &"and DateValue ge {startdate} "
        &") "
        &"/groupby( "
            &"(DateValue,ColumnName,LaneName,State,WorkItemType,AssignedTo/UserName,Area/AreaPath),  "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

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

https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/WorkItemBoardSnapshot?
        $apply=filter(
            Team/TeamName eq '{teamname}'
            and BoardName eq 'Stories' 
            and DateValue ge {startdate}
        )
        /groupby(
            (DateValue,ColumnName,LaneName,State,WorkItemType,AssignedTo/UserName,Area/AreaPath), 
            aggregate($count as Count)
        )

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

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

{organization} — Название организации
{project} — Имя проекта группы или полностью опустите "/{project}" для межпроектного запроса

{teamname} — Имя команды для отображения данных CF

{startdate}— Запустите отчет для элементов, завершенных или после заданной даты с форматом: YYYY-MM-DDZ Например: 2022-04-01Z представляет 2022-апрель-01. Не заключайте в кавычки.

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

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

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

Description

$apply=filter(

Предложение Start filter() .

Team/TeamName eq '{teamname}'

Возвращать элементы для определенной команды.

and BoardName eq 'Stories'

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

and DateValue ge {startdate}

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

)

Закрыть filter() предложение.

/groupby(

Предложение Start groupby() .

(DateValue, ColumnName, LaneName, State, WorkItemType,AssignedTo/UserName,Area/AreaPath),

DateValue Группировать по (используется для тренда) ColumnNameи любым другим свойствам, о которым вы хотите сообщить. Здесь мы включаем LaneName фильтрацию по плавающим дорожкам.

aggregate($count as Count)

Статистические данные по количеству рабочих элементов.

)

Закрыть groupby() предложение.

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

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

Снимок экрана: параметры меню запроса Power BI, переименование запроса.

Разверните столбцы в Редактор Power Query

В Редактор Power Query выберите запрос с данными, которые необходимо преобразовать. Для диаграммы CF необходимо развернуть AreaIterationстолбцы и AssignedTo столбцы. Чтобы узнать, как это сделать, ознакомьтесь со следующими разделами в разделе "Аналитика преобразования", чтобы создать отчеты Power BI, развернуть столбцы.

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

После развертывания столбцов может потребоваться переименовать одно или несколько полей. Например, можно переименовать столбец AreaPath Area Pathв . Сведения о том, как это сделать, см. в разделе "Переименовать поля столбцов".

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

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

Создание диаграммы с накоплением области

В следующем примере запрос был переименован в ФОРМАТЕ CF, но столбцы не были переименованы.

В Power BI выберите диаграмму с областями с накоплением в разделе "Визуализации".
Добавьте в оси, а затем щелкните правой кнопкой мыши DateValue и выберите DateValue, а не Date Hierarchy.DateValue
Добавьте Count в значения.
Добавление ColumnName в условные обозначения.
В области "Фильтры" разверните ColumnNameи выберите только значения, которые вы хотите отображать на диаграмме. Например, вы можете отменить выбор нового, предлагаемого, готового или закрытого.

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

Снимок экрана: отчет диаграммы с областями с накоплением с накоплением в Power BI, столбцы, отсортированные по алфавиту.

Сортировка столбцов в прогрессивном порядке

Чтобы отсортировать столбцы диаграммы в порядке, определенном на доске, сделайте следующее:

Создайте новый запрос в Power BI на следующие запросы. По завершении переименуйте запрос в ColumnOrder.

Запрос Power BI
Запрос OData

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/BoardLocations?"
        &"$apply=filter( "
            &"Team/TeamName eq '{teamname}'  "
            &"and BoardName eq 'Stories'  "
            &"and IsCurrent eq true "
        &") "
        &"/groupby ((ColumnName,ColumnOrder)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/V3.0-preview/BoardLocations?
        $apply=filter(
            Team/TeamName eq '{teamname}' 
            and BoardName eq 'Stories' 
            and IsCurrent eq true
        )
        /groupby ((ColumnName,ColumnOrder))

Сортировка отчета в правильном порядке

В Power BI разверните запрос ColumnOrder и выберите ColumnName.
Выберите "Инструменты столбцов", а затем "Сортировка по столбцам" и выберите команду ColumnOrder.
Выберите меню "Моделирование", а затем Управление связями. Убедитесь, CFD.ColumnName что между и ColumnOrder.ColumnName. Скорее всего, связь была автоматически обнаружена.
В отчете, созданном выше, в условных обозначениях замените условным обозначениямColumnOrder.ColumnName.CFD.ColumnName

Отчет обновляется с столбцами, отсортированных в том же порядке, что и доска.

Примечание.

Если все рабочие элементы были в столбце, который с тех пор был удален, они будут отображаться как "Пустые" в приведенном выше отчете.

Поделиться через

Пример отчета о схеме накопительного потока (CF)

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

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

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

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

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

Разверните столбцы в Редактор Power Query

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

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

Создание диаграммы с накоплением области

Сортировка столбцов в прогрессивном порядке

Сортировка отчета в правильном порядке

Обратная связь

Дополнительные ресурсы

Поделиться через

Пример отчета о схеме накопительного потока (CF)

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

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

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

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

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

Разверните столбцы в Редактор Power Query

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

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

Создание диаграммы с накоплением области

Сортировка столбцов в прогрессивном порядке

Сортировка отчета в правильном порядке

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

Обратная связь

Дополнительные ресурсы