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

Добавление Markdown на панель мониторинга

  • Статья

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

Мини-приложение Markdown — это универсальное средство, которое позволяет поддерживать вашу команду и заинтересованных лиц, добавляя ценные сведения непосредственно на панель мониторинга. Его можно использовать для отображения следующих элементов:

  • Цели команды
  • Ссылки на невыполненные работы группы или доски
  • Ссылки на метрики
  • Ссылки на другие элементы, расположенные в сетевой папке, такие как OneNote, сайт SharePoint или вики-страницы
  • Важные даты или целевые сроки

Используя мини-приложение Markdown, вы можете убедиться, что важная информация легко доступна и видна вашей команде и заинтересованным лицам. В следующем примере показаны сведения о команде и ссылки: снимок экрана примера мини-приложения Markdown.

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

Категория Требования
Уровни доступа - член проекта.
— По крайней мере Базовый доступ или конкретные разрешения панели мониторинга.
Права доступа Для добавления, изменения или управления командной панелью: требуется быть как членом команды, так и членом группы администраторов проекта.
Категория Требования
Уровни доступа - член проекта.
— По крайней мере Базовый доступ или конкретные разрешения панели мониторинга.
Права доступа Для добавления, изменения или управления командной панелью: требуется быть как членом команды, так и членом группы администраторов проекта.
Инструменты Для мини-приложений Аналитики для работы с панелью мониторинга: включеноаналитики.
Категория Требования
Уровни доступа - член проекта.
— По крайней мере Базовый доступ или конкретные разрешения панели мониторинга.
Права доступа Чтобы добавить, редактировать или управлять панелью управления команды: быть членом команды и группы администраторов проектов или назначенным на роль администратора команды .
Инструменты Расширение - Analytics Marketplace. Мини-приложения аналитики недоступны, если аналитика не установлена, включена или запущена.
— Чтобы виджеты аналитики работали с вашей панелью мониторинга: Включена аналитика.

Примечание.

Данные, отображаемые на диаграмме или мини-приложении, подлежат разрешениям, предоставленным пользователю, вошедшего в систему. Например, если у пользователя нет разрешений на просмотр рабочих элементов в определенном пути к области, эти элементы не отображаются в мини-приложении результатов запроса на панели мониторинга. Дополнительные сведения см. в часто задаваемых вопросы об использовании панелей мониторинга.

Поддерживаемый синтаксис Markdown

Мини-приложение Markdown поддерживает стандартные функции CommonMark, такие как:

  • Заголовки
  • Абзацы и разрывы строк
  • Блок цитирования
  • Горизонтальная линия
  • Выделение (полужирный, курсив, зачеркнутый)
  • Таблицы
  • Списки, упорядоченные и неупорядоченные
  • Ссылки.
  • Изображения
  • Экранирование символов

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

По соображениям производительности мини-приложение Markdown не добавляет поддержку для многих расширенных функций, многие из которых поддерживаются в вики-сайте. Расширенные возможности препятствуют времени загрузки мини-приложений. Например, следующие расширенные функции Markdown не поддерживаются в мини-приложении Markdown:

  • Встроенный синтаксис HTML
  • Выделение кода (вики-сайт или другие поддерживают код с поддержкой синтаксиса языка, commonMark просто отображает код как обычный предварительно подготовленный текст)
  • Контрольные списки
  • Символы эмодзи
  • Вложения
  • Математические формулы

Добавление мини-приложения Markdown

Выполните следующие действия, чтобы добавить мини-приложение Markdown. Сведения о добавлении панели мониторинга см. в разделе Добавление, переименование и удаление панелей мониторинга.

  1. Войдите в проект (https://dev.azure.com/{Your_Organization/Your_Project}).

  2. Выберите панели мониторинга.

  3. Выберите Изменить. Каталог мини-приложений автоматически открывается.

  4. Добавьте или перетащите мини-приложение Markdown на панель мониторинга, где она расположена.

    скриншот показывает виджет Markdown.

  5. Выберите "Готовое редактирование", чтобы выйти из панели мониторинга редактирования. Это действие удаляет каталог мини-приложений. Затем можно настроить мини-приложение Markdown по мере необходимости.

  6. Выберите дополнительные действия >значок шестеренкиНастроить.

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

  7. (Необязательно) Измените размер мини-приложения по мере необходимости, чтобы соответствовать содержимому Markdown. Самый большой размер — 10 плиток, широких на 10 плиток. Вы всегда можете изменить размер позже.

  8. Введите текст и синтаксис Markdown в диалоговое окно конфигурации. Поддерживаемый синтаксис см . в руководстве по синтаксису для файлов Markdown, мини-приложений, вики-сайтов и комментариев запроса на вытягивание.

    скриншот показывает окно диалога настроек виджета Markdown.

    Примечание.

    • Ссылки на документы в общих папках с помощью file:// не поддерживаются. Это ограничение реализуется в целях безопасности.
    • Чтобы связаться со вики-страницей, используйте следующий синтаксис:
      /ProjectName/_wiki/wikis/WikiRepositoryName?pagePath=/FileName
    • Чтобы создать ссылку на файл репозитория, страницу или изображение в проекте, выберите markdown файл, выберите ваш Репозиторий, Ветвьи Путь в выпадающих меню.

  9. Сохранить изменения.