Пример сводного отчета о ходе выполнения функций

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

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

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

Предпосылки

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

Запрос хода выполнения функции у WorkItems объекта позволяет узнать текущее состояние.

Просмотр прогресса функциональности в соответствии с заданным путем области

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Feature' "
            &"and State ne 'Removed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and Descendants/any()"
            &"&$select=WorkItemId,Title,Area,Iteration,AssignedTo,WorkItemType,State,AreaSK"
            &"&$expand=Descendants( "
            &"$apply=filter(WorkItemType eq 'User Story') " 
                &"/groupby((StateCategory), "
                &"aggregate(StoryPoints with sum as TotalStoryPoints)) "
            &")  "
    ,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 'Feature'
            and State ne 'Removed'
            and startswith(Area/AreaPath,'{areapath}')
            and Descendants/any()
        &$select=WorkItemId,Title,Area,Iteration,AssignedTo,WorkItemType,State,AreaSK
        &$expand=Descendants(
            $apply=filter(WorkItemType eq 'User Story')
                /groupby((StateCategory),
                aggregate(StoryPoints with sum as TotalStoryPoints))
            ) 

Строки замены и разбивка запросов

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

• {organization} — Название организации
• {project} — Имя проекта группы или полностью опустите /{project} для межпроектного запроса
• {areapath} — Ваш путь области. Пример формата: Project/Level1/Level2.

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

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

$filter=endswith(Area/AreaPath,'suffix')
&$select=WorkItemId,Title,WorkItemType,State,Area, Descendants
&$expand=Descendants($select=WorkItemId)

$filter=endswith(Area/AreaPath, 'suffix')and Descendants/any()
&$select=WorkItemId,Title,WorkItemType,State,Area, Descendants
&$expand=Descendants($select=WorkItemId)

Обзор прогресса функций для команды

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

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Feature' "
            &"and State ne 'Cut' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) "
            &"and Descendants/any() "
        &"&$select=WorkItemId,Title,WorkItemType,State,AreaSK "
        &"&$expand=Descendants( "
            &"$apply=filter(WorkItemType eq 'User Story') "
                &"/groupby((StateCategory), "
                &"aggregate(StoryPoints with sum as TotalStoryPoints)) "
            &")  "
    ,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 'Feature'
            and State ne 'Cut'
            and (Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname}) or Teams/any(x:x/TeamName eq '{teamname})
            and Descendants/any()
        &$select=WorkItemId,Title,WorkItemType,State,AreaSK
        &$expand=Descendants(
            $apply=filter(WorkItemType eq 'User Story')
                /groupby((StateCategory),
                aggregate(StoryPoints with sum as TotalStoryPoints))
            ) 

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

Запрос возвращает несколько столбцов, которые необходимо развернуть, прежде чем использовать их для создания отчета. Любая сущность, извлеченная с помощью инструкции OData $expand , возвращает запись с потенциально несколькими полями. Разверните запись, чтобы развернуть сущность в её составляющие поля.

Для отчета "Ход выполнения функции" необходимо выполнить следующие преобразования:

• Преобразуйте столбец Descendants в два столбца: Descendants.StateCategory и Descendants.TotalStoryPoints
• Применение преобразования столбца сводной таблицы к Descendants.StateCategory столбцу для разделения отдельных категорий состояний
• Замените значения NULL во всех сводных столбцах.
• Добавьте настраиваемый столбец, представляющий процент выполнения. В настраиваемом столбце отображаются ошибки, если в сводных столбцах State есть столбцы со значением NULL.

Чтобы узнать, как, см. статью Преобразование данных аналитики для создания отчетов Power BI.

Работа с вложенными данными

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

1. Определите вложенные столбцы: проверьте набор данных на наличие столбцов, которые могут содержать списки, записи или таблицы в одной ячейке.
2. Выравнивание или удаление вложенных данных: вы можете либо удалить вложенные столбцы, либо свернуть их, развернув в отдельные столбцы с помощью функции "Развернуть" в Power Query.
3. Выполнение операции сводной таблицы: После обращения к вложенным данным можно продолжить операцию сводной операции без возникновения ошибок.

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

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

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

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

   

2. Добавьте Title в ось Y.

3. Добавьте PercentComplete к оси X, щелкните правой кнопкой мыши и выберите «Сумма».

Пример отчета отображается.

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

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