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

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

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

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

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

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

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

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

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

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

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. Не заключайте в кавычки.

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

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

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

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

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

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

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

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

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

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

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

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

1. В Power BI выберите диаграмму с областями с накоплением в разделе "Визуализации".

   

2. Добавьте в оси, а затем щелкните правой кнопкой мыши DateValue и выберите DateValue, а не Date Hierarchy.DateValue

3. Добавьте Count в значения.

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

5. В области "Фильтры" разверните ColumnNameи выберите только значения, которые вы хотите отображать на диаграмме. Например, вы можете отменить выбор нового, предлагаемого, готового или закрытого.

   

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

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

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

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

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

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

1. В Power BI разверните запрос ColumnOrder и выберите ColumnName.

2. Выберите "Инструменты столбцов", а затем "Сортировка по столбцам" и выберите команду ColumnOrder.

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

   

4. В отчете, созданном выше, в условных обозначениях замените условным обозначениямColumnOrder.ColumnName.CFD.ColumnName

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

   

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

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