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


Создание мини-приложения Analytics для Azure DevOps

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

Вы можете создать собственное мини-приложение Аналитики для отображения на панели мониторинга в Azure DevOps. Пример мини-приложения на github демонстрирует:

  • Отображение строк тренда, связанных с состояниями рабочего элемента
  • Как выполнять запросы к набору данных, когда пользователь будет настраивать его через представление конфигурации виджета
  • Создание и публикация мини-приложения в Azure DevOps Marketplace

С помощью этих сведений вы сможете создать собственное мини-приложение Аналитики.

Просмотр конфигурации с предпросмотром виджета

Примечание.

Служба Аналитики автоматически включается и поддерживается в рабочей среде для всех Служб 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".

Предпосылки

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

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

  1. Создание расширения мини-приложения Azure DevOps, ссылка на пример расширений мини-приложений
  2. Отобразить элемент управления диаграммой в Azure DevOps, см. Добавить диаграмму
  3. Запрос OData из Analytics

Предоставление представления конфигурации

  1. Выполнение простых запросов аналитики, необходимых элементам управления пользовательского интерфейса, используемым для настройки представления.
  2. Управление состоянием пользовательского интерфейса конфигурации с обновлениями на основе действий пользователей и новыми данными из запросов Аналитики.
  3. Рендеринг конфигурационного интерфейса с использованием Typescript и React.

Визуализация данных в мини-приложении

  1. Запуск настраиваемого пользователем запроса в качестве запроса POST
  2. Интерпретация данных из аналитики для отрисовки диаграммы

Дальнейшие действия

Чтобы избежать чрезмерной сложности в образце, мы исключили определенные технологии и методики, которые, безусловно, следует включить в производственное приложение. Пример ui-fabric-react на GitHub демонстрирует процесс сборки, который использует эти детали.

  1. Объединение и минификация содержимого JavaScript — набор небольших, свободных файлов скриптов в примере может загружаться гораздо быстрее при объединении в один файл и минифицироваться.
  2. Элементы управления пользовательского интерфейса Fabric — элементы управления пользовательского интерфейса Fabric предоставляют широкий набор компонентов пользовательского интерфейса конфигурации для React.