Добавление Markdown на панель мониторинга
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Мини-приложение Markdown — это универсальное средство, которое позволяет поддерживать вашу команду и заинтересованных лиц, добавляя ценные сведения непосредственно на панель мониторинга. Его можно использовать для отображения следующих элементов:
- Цели команды
- Ссылки на невыполненные работы группы или доски
- Ссылки на метрики
- Ссылки на другие элементы, расположенные в сетевой папке, такие как OneNote, сайт SharePoint или вики-страницы
- Важные даты или целевые сроки
Используя мини-приложение Markdown, вы можете убедиться, что важная информация легко доступна и видна вашей команде и заинтересованным лицам.
В следующем примере показаны сведения о команде и ссылки: 
Необходимые компоненты
-
Доступ.
- Любой пользователь с доступом к проекту, включая участников проекта, может просматривать дашборды.
- По крайней мере базовый доступ или определенные разрешения панели мониторинга.
-
Разрешения:
-
Панели мониторинга группы. Чтобы добавить, изменить или управлять панелью мониторинга группы, выполните следующие требования:
- Быть членом команды.
- Быть членом группы "Администраторы проектов".
-
Панели мониторинга группы. Чтобы добавить, изменить или управлять панелью мониторинга группы, выполните следующие требования:
-
Доступ.
- Любой пользователь с доступом к проекту, включая заинтересованных лиц, может просматривать панели мониторинга.
- По крайней мере доступ к базовым или определенным разрешениям панели мониторинга.md), предоставленным вам или членом группы "Администраторы проектов".
- Средства. Включить аналитику для мини-приложений Аналитики для работы с панелью мониторинга.
-
Доступ.
- Любой пользователь с доступом к проекту, включая заинтересованных лиц, может просматривать панели мониторинга.
- Будьте членом проекта и имеют базовый доступ, имеют определенные разрешения панели мониторинга, предоставленные для выбранной панели мониторинга, быть членом группы "Администраторы проектов" или быть назначены роли администратора команды.
-
Средства:
- Установите или включите расширение Analytics Marketplace. Мини-приложения аналитики недоступны, если аналитика не установлена, включена или запущена.
- Включить аналитику для мини-приложений Аналитики для работы с панелью мониторинга.
Примечание.
Данные, отображаемые на диаграмме или мини-приложении, подлежат разрешениям, предоставленным пользователю, вошедшего в систему. Например, если у пользователя нет разрешений на просмотр рабочих элементов в определенном пути к области, эти элементы не отображаются в мини-приложении результатов запроса на панели мониторинга. Дополнительные сведения см. в часто задаваемых вопросы об использовании панелей мониторинга.
Поддерживаемый синтаксис Markdown
Мини-приложение Markdown поддерживает стандартные функции CommonMark, такие как:
- Заголовки
- Абзацы и разрывы строк
- Блок цитирования
- Горизонтальная линия
- Выделение (полужирный, курсив, зачеркнутый)
- Таблицы
- Списки, упорядоченные и неупорядоченные
- Ссылки.
- Изображения
- Экранирование символов
Дополнительные сведения см. в руководстве по синтаксису для основного использования Markdown.
По соображениям производительности мини-приложение Markdown не добавляет поддержку для многих расширенных функций, многие из которых поддерживаются в вики-сайте. Расширенные возможности препятствуют времени загрузки мини-приложений. Например, следующие расширенные функции Markdown не поддерживаются в мини-приложении Markdown:
- Встроенный синтаксис HTML
- Выделение кода (вики-сайт или другие поддерживают код с поддержкой синтаксиса языка, commonMark просто отображает код как обычный предварительно подготовленный текст)
- Контрольные списки
- Символы эмодзи
- Вложения
- Математические формулы
Добавление мини-приложения Markdown
Выполните следующие действия, чтобы добавить мини-приложение Markdown. Сведения о добавлении панели мониторинга см. в разделе Добавление, переименование и удаление панелей мониторинга.
Войдите в проект (
https://dev.azure.com/{Your_Organization/Your_Project}).Выберите панели мониторинга.
Выберите
Изменить. Каталог мини-приложений автоматически открывается.Добавьте или перетащите мини-приложение Markdown на панель мониторинга, где она расположена.
Выберите "Готовое редактирование", чтобы выйти из панели мониторинга редактирования. Это действие удаляет каталог мини-приложений. Затем можно настроить мини-приложение Markdown по мере необходимости.
Выберите
дополнительные действия >
Настроить.
(Необязательно) Измените размер мини-приложения по мере необходимости, чтобы соответствовать содержимому Markdown. Самый большой размер — 10 плиток, широких на 10 плиток. Вы всегда можете изменить размер позже.
Введите текст и синтаксис Markdown в диалоговое окно конфигурации. Поддерживаемый синтаксис см . в руководстве по синтаксису для файлов Markdown, мини-приложений, вики-сайтов и комментариев запроса на вытягивание.
Примечание.
- Ссылки на документы в общих папках с помощью
file://не поддерживаются. Это ограничение реализуется в целях безопасности. - Чтобы связаться со вики-страницей, используйте следующий синтаксис:
/ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName - Чтобы создать ссылку на файл репозитория, страницу или изображение в проекте, выберите markdown файл, выберите ваш Репозиторий, Ветвьи Путь в выпадающих меню.
- Ссылки на документы в общих папках с помощью
Сохранить изменения.