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

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

В этой статье приведены примеры для наиболее популярных отчетов:


Azure Boards

Azure Test Plans



Конвейер

Конвейер и тестирование




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

  • Примеры запросов — запрос Power BI и необработанный запрос OData, используемый для извлечения данных в Power BI вместе с другими примерами запросов.
  • Преобразование данных в Power BI . Шаги по преобразованию данных в отчетный формат
  • Создайте отчет. Действия по созданию простого отчета из данных.

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

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

Запрос Power BI

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

  1. Выберите " Получить данные" и " Пустой запрос".

    Снимок экрана: Power BI, пустой запрос.

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

    Снимок экрана: Power BI, выбор Расширенный редактор.

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

    Снимок экрана: Power BI, Расширенный редактор.

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

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

  5. Примеры запросов имеют строки, которые должны быть заменены вашими значениями, такими как {organization} и {project}.

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

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

    • {areapath} — Путь к области. Формат: Project\Level1\Level2
    • {iterationpath} — Путь итерации. Формат: Project\Level1\Level2
    • {startdate} — Дата начала отчета о тренде. Формат: ГГГГ-ММ-ДДЗ. Пример: 2019-04-01Z представляет 2019-апрель-01. Не заключайте в кавычки.

    Снимок экрана: Power BI, Расширенный редактор, Замена строк в запросе.

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

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

Необработанный запрос OData

Большинство примеров отчетов предоставляют запрос OData в случае необходимости изменять и тестировать запрос OData отдельно перед его использованием в Power BI. Этот метод обеспечивает большую гибкость, но включает другие действия перед использованием запроса OData в Power BI, как описано в Подключение с помощью запросов Power BI и OData

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