Добавление среза команды в отчет Power BI

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

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

Внимание

Фильтр группы требует, чтобы поле "AreaSK" было включено в запрос, используемый отчетом, который требуется фильтровать. Все запросы, предоставленные в примерах отчетов, уже включают "AreaSK". Если вы создали собственный запрос, убедитесь, что он возвращает значение AreaSK в предложениях $select или groupby().

Примечание.

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

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

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

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

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

Запрос Power BI

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

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v1.0/Areas?"
        &"$filter=startswith(AreaPath,'{areapath}') "
            &"&$select=AreaSK,AreaPath "
            &"&$expand=Teams($select=TeamName) "
    ,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/v1.0/Areas?
        $filter=startswith(AreaPath,'{areapath}')
            &$select=AreaSK,AreaPath
            &$expand=Teams($select=TeamName)

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

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

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

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

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

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

Description

---

$filter=startswith(AreaPath, '{areapath}')

Возвращает все команды, сопоставленные с путьом к области или под указанным{areapath}. Чтобы включить все команды в проект, опустим эту инструкцию.

&$select=AreaSK, AreaPath

Поля пути к области возврата, используемые для сопоставления.

&$expand=Teams($select=TeamName)

Верните команду, связанную с путем области.

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

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

Разверните столбец Teams

1. Нажмите кнопку "Развернуть".

   

2. Выберите поля для выравнивания.

   

3. Теперь таблица будет содержать поля сущностей.

   

Создание связи с помощью "AreaSK"

Выбрав "Закрыть" и "Применить" и вернувшись в Power BI, выполните следующие действия:

1. В меню моделирования выберите Управление связями.

2. Создайте связь между запросом отчета и запросом Teams. Скорее всего, Power BI автоматически создаст для вас связь. Ниже приведен пример связи между запросом в отчете "Открытые ошибки" и запросом Teams:

   

Добавление фильтра группы в существующий отчет

1. На странице, к которой нужно добавить фильтр группы, убедитесь, что диаграммы не выбраны, а затем выберите срез в области "Визуализации ".

   

2. Добавление Team.TeamName в поле.

Дополнительные сведения о работе с срезами см. в разделе "Срезы" в Power BI.

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

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