Подключение с помощью Power Query и функций Azure DevOps

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 г. - Azure DevOps Server 2019 г.

Соединитель данных для Azure DevOps включает Power Query функций M, которые могут использовать авторы запросов. Эти функции могут выполнять определенные требования Azure DevOps, такие как проверка подлинности. В этой статье описываются аргументы для функций и способы их использования для подключения к Аналитике.

The VSTS. Функция AccountContents заменяет функцию Power Query M Web.Contents. Предназначено для более сложных сценариев, VSTS. AccountContents возвращает содержимое, скачаемое с URL-адреса аналитики, в виде двоичного значения. Его можно использовать для вызова REST API AzureDevOps.

Важно!

  • Используйте VSTS. AccountContents только для доступа к данным, недоступным в аналитике. Она извлекает данные непосредственно из Azure DevOps и для защиты других пользователей Azure DevOps подвержена регулированию. См. раздел Поддерживаемые поддомены для VSTS. AccountContents, раздел далее в этой статье. Сведения о других подходах см. в обзоре интеграции Power BI.
  • VSTS. AccountContents поддерживает только Azure Boards данные (рабочие элементы). Соединитель данных не поддерживает другие типы данных, например конвейеры. В настоящее время мы не планируем обновлять соединитель для поддержки других типов данных.

VSTS. AccountContents

Расширенная функция, которая возвращает содержимое, скачаемое с URL-адреса аналитики, в виде двоичного значения.

Функция VSTS.AccountContents имеет те же аргументы, параметры и формат возвращаемого значения, что Web.Contentsи . Дополнительные сведения см. в статье Справочник по формуле Power Query (M) — Web.Contents.

Если вы уже используете Web.Contents для доступа к данным отслеживания работы из Аналитики (REST API или OData), вы можете заменить их VSTS.AccountContents на , чтобы использовать проверку подлинности соединителя данных. Он сообщает Power BI, что эти запросы ссылаются на один и тот же источник данных. Вы можете объединять данные, не нарушая ограничения одного источника данных в службе Power BI. VSTS.AccountContent Однако поддерживает только данные из Azure Boards и не может использоваться для поддержки запросов к конвейерам или другим службам.

"VSTS. AccountContents предоставляет подмножество аргументов и параметров, доступных в OData.Contents. Конкретные ограничения описаны в таблице ниже.

Аргументы для VSTS. Содержимое

Аргумент Описание
url URL-адрес одной из конечных точек службы Azure DevOps.
options Запись параметров для управления поведением этой функции.

Поля параметров для VSTS. Содержимое

Поле Описание
IsRetry При выборе этого логического значения значение true будет игнорироваться любой существующий ответ в кэше.
ManualStatusHandling Укажите это значение в виде списка, чтобы предотвратить встроенную обработку HTTP-запросов, ответ которых имеет один из этих кодов состояния.
MaxSize Управляет максимальным размером таблицы, интересующей клиента. Если запрос превышает это ограничение, сервер может немедленно завершить запрос. Значение по умолчанию равно нулю, что указывает серверу серверов использовать его значение по умолчанию.
Query Программное добавление параметров запроса в URL-адрес.
RelativePath Укажите это значение, так как текст добавляет его к базовому URL-адресу перед выполнением запроса.
Timeout Укажите это значение в качестве длительности, чтобы изменить время ожидания для HTTP-запроса. Значение по умолчанию — 600 секунд.
Version Версия модели данных. Этот параметр является основным для диагностика.

Поддерживаемые поддомены для VSTS. AccountContents

В настоящее VSTS.AccountContents() время метод работает только для поддоменов, перечисленных ниже. Другие службы, такие как служба выпуска, пока не поддерживаются:

  • https://dev.azure.com/
  • https://analytics.dev.azure.com/
  • https://vsrm.dev.azure.com/