Доступ к данным через Excel
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Вы можете получить доступ к данным через Excel, создать отчеты, а затем опубликовать диаграммы в Power BI или использовать файл Excel в качестве основы для отчетов Power BI. В настоящее время вам нужны альтернативные учетные данные для доступа к аналитике данных через Excel.
Предпосылки
Категория | Требования |
---|---|
Уровни доступа |
-
член проекта. — По крайней мере базовый доступ уровня . |
Разрешения | По умолчанию члены проекта имеют разрешение выполнять запросы к аналитике и создавать представления. Дополнительные сведения о других предварительных требованиях для включения служб и функций и общих действий отслеживания данных см. в разделе "Разрешения и предварительные требования для доступа к аналитике". |
Примечание.
Служба Аналитики автоматически включается и поддерживается в рабочей среде для всех Служб Azure DevOps Services.
Интеграция Power BI и доступ к фиду OData сервиса аналитики стали общедоступными. Мы рекомендуем вам использовать его и дать нам отзыв.
Доступные данные зависят от версий. Последняя поддерживаемая версия v2.0
, а последняя предварительная версия v4.0-preview
. Дополнительные сведения см. в разделе "Управление версиями API OData".
Примечание.
Служба Аналитики автоматически устанавливается и поддерживается в рабочей среде для всех новых коллекций проектов для Azure DevOps Server 2020 и более поздних версий. Интеграция Power BI и доступ к фиду OData сервиса аналитики стали общедоступными. Мы рекомендуем вам использовать его и дать нам отзыв. При обновлении с Azure DevOps Server 2019 можно установить службу Аналитики во время обновления.
Доступные данные зависят от версий. Последняя поддерживаемая версия v2.0
, а последняя предварительная версия v4.0-preview
. Дополнительные сведения см. в разделе "Управление версиями API OData".
Откройте Excel 2016 или более поздней версии, включая Excel для Microsoft 365.
Если вы используете более раннюю версию Excel, установите надстройку Power Query из Microsoft Power Query для Excel.
Создайте пустую рабочую книгу.
На вкладке данных выберите Новый запрос>из других источников>из потока OData.
Введите URL-адрес в следующем формате и нажмите кнопку OK:
https://analytics.dev.azure.com/{Organization_Name}/_odata/{version}/
Если Organization Name fabrikam и версииверсии 1.0, URL-адрес
https://analytics.dev.azure.com/fabrikam/_odata/v1.0/
.Примечание.
Кроме того, можно ввести URL-адрес с указанным Имени проекта, который ограничивает результаты по указанному проекту во всех сущностях, связанных с этим проектом.
https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/
https://{ServerName}:{Port}/tfs/{CollectionName}/_odata/{version}/
Если имя коллекции равно fabrikam и версия равна v1.0, то URL-адрес —
https://{ServerName}:{Port}/tfs/fabrikam/_odata/{v1.0}/
.Примечание.
В качестве альтернативы, вы можете ввести URL-адрес, указав имя проекта ProjectName, чтобы отфильтровать результаты по указанному проекту среди всех сущностей, связанных с этим проектом.
https://{ServerName}:{Port}/tfs/{CollectionName}/{ProjectName}/_odata/{version}/
Вам будет предложено пройти проверку подлинности в службе. Если вы еще не сделали этого, см. варианты проверки подлинности клиента.
Выберите одну сущность, чтобы получить данные, или отметьте Выбрать несколько элементов и выберите данные для возврата.
На этом этапе, если выбрать загрузить, Excel загружает все данные в каждой сущности в Power Query. Но это может быть больше данных, чем требуется или больше, чем Может обрабатывать Excel.
Выполните следующие действия, чтобы отфильтровать данные:
- Выберите сущность, которую вы хотите отфильтровать, и выберите изменить, чтобы открыть редактор запросов.
- Для каждого столбца, который требуется отфильтровать, выберите столбец и задайте критерии фильтра.
- После применения всех необходимых фильтров выберите Закрыть & Применить в левом верхнем углу.
Это действие загружает только отфильтрованные данные в Power Query, что делает его более управляемым и соответствующим вашим потребностям.
Это важно
Не выбрать сущность с именем моментального снимка. Эти сущности содержат состояние каждого рабочего элемента для каждого дня, так как каждый рабочий элемент был создан. Для репозиториев любого размера это приводит к десяткам или сотням миллионов рабочих элементов, которые не загружают правильно. Чтобы выполнить анализ трендов, сузьте область получения данных до определенных элементов и временных кадров и извлеките эти сведения с помощью отдельного запроса OData.
В качестве альтернативы загрузке данных в Power Query, вы можете выбрать стрелку раскрывающегося списка рядом с Загрузить и выбрать Загрузить В. Это действие предоставляет следующие параметры:
- Загрузка данных в таблицу в Power Query
- Создайте подключение без загрузки данных, отложив загрузку данных до более позднего времени.
- Загрузите данные на лист, при этом на каждом листе загружается одна сущность.
- Загрузка данных в модель, которую можно выбрать с другими параметрами, для загрузки данных в PowerPivot
Дополнительные сведения см. в документации Excel.
Обработка связей
По умолчанию при возврате базовых данных из Аналитики данные связаны, как показано на следующем рисунке:
Теги, команды и пользователи не связаны с другими данными из-за характера их отношений. Эти сущности либо связаны отношениями "многие ко многим", которые сложно обрабатывать в этих моделях, либо несколькими различными связями между сущностями. Например, пользователи и рабочие элементы связаны с помощью таких полей, как "Назначено", "Создано" и "Изменено".
Обработка нескольких связей может быть выполнена довольно просто. Например, в модели по умолчанию можно изменить запрос, выбрать столбец AssignedTo
таблицы WorkItems
и развернуть столбец, чтобы включить все данные из таблицы Users
. Повторите этот процесс для столбцов CreatedBy
и ChangedBy
. Этот подход позволяет избежать нескольких ссылок из одной таблицы в другую, что не допускается.