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


Обзор примеров отчетов с помощью запросов OData

сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Запросы Open Data Protocol (OData) можно использовать для создания Power BI отчетов. Для различных служб в Azure DevOps примеры запросов доступны для создания многочисленных популярных отчетов. В этой статье представлен обзор примеров отчетов и показано, как приступить к работе с ними.

Примеры отчетов

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

Azure Boards

Azure Test Plans



Azure Pipelines

тесты Azure Pipelines



Все примеры статей отчета содержат следующие разделы и сведения:

  • Примеры запросов — запрос Power BI и необработанный запрос OData, используемые для извлечения данных в Power BI, а также другие примеры запросов.
  • Раздел о преобразовании данных в Power BI. Шаги по преобразованию данных в отчетный формат путем расширения столбцов или изменения типов данных столбцов.
  • Создайте отчет . Действия по созданию базового отчета из данных.
Категория Требования
Уровни доступа - Участник проекта.
— По крайней мере базовый доступ уровня .
Права доступа По умолчанию члены проекта имеют разрешение выполнять запросы к аналитике и создавать представления. Дополнительные сведения о других предварительных требованиях для включения служб и функций и общих действий отслеживания данных см. в разделе "Разрешения и предварительные требования для доступа к аналитике".

Выполнение запроса Power BI

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

  1. В Power BI выберите Получить данные, а затем выберите Пустой запрос.

    Снимок экрана пустого отчета в Power BI Desktop. На ленте развернут пункт "Получить данные". Пункты "Получить данные" и "Пустой запрос" выделены.

  2. В Power BI Редактор Power Query выберите Расширенный редактор.

    Скриншот редактора Power Query в Power BI. На ленте в группе запросов выделен Расширенный редактор.

    Откроется окно Расширенный редактор.

    Скриншот окна Расширенный редактор в Power BI. Слабо заполненное поле, которое можно использовать для редактирования запроса.

  3. Замените содержимое примером запроса. Примеры запросов см. в связанных статьях, перечисленных ранее в этой статье.

    Снимок экрана окна

  4. Замените все строки заполнителя в запросе вашими значениями.

    • {organization} — Имя вашей организации.
    • {project} — Имя проекта группы. Для запроса, охватывающего несколько проектов, опустим /{project} полностью.

    Некоторые примеры запросов содержат другие заполнители, которые также необходимо заменить, например следующие строки:

    • {areapath} — путь к области в следующем формате: Project\Level1\Level2.
    • {iterationpath} — путь итерации в следующем формате: Project\Level1\Level2.
    • {startdate}— Дата начала отчета о тренде в следующем формате: YYYY-MM-DDZ Например, 2025-04-01Z представляет 1 апреля 2025 г. Не заключайте дату в кавычки.

    Скриншот окна Расширенного редактора. Организация, проект, путь к области и дата начала содержат реальные значения и выделены.

  5. Чтобы запустить запрос, нажмите кнопку "Готово".

    При первом подключении к учетной записи Power BI требуется пройти проверку подлинности. Подробные сведения см. в разделе Ввод учетных данных клиента в Power BI или Excel.

Выполнение необработанного запроса OData

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

Дополнительные сведения о написании запросов OData к данным аналитики см. в примерах отчетов и кратком эталонном индексе.