Использование приложения Azure Boards в Microsoft Teams

  • Статья

Azure DevOps Services

Если вы работаете с Microsoft Teams, вы можете создавать рабочие элементы и отслеживать активность рабочих элементов в проекте Azure Boards из канала Teams. Это можно сделать, добавив приложение Azure Boards для Microsoft Teams в канал Teams.

Приложение Azure Boards для Microsoft Teams позволяет пользователям выполнять следующие задачи:

  • Настройка и администрирование подписок для создания и обновления рабочих элементов.
  • Управление событиями других рабочих элементов.
  • Получение уведомлений о событиях рабочих элементов и управление ими в канале Teams.
  • Создание рабочих элементов из бесед в канале.
  • Поиск рабочих элементов и предоставление к ним общего доступа для других участников в канале с использованием расширения для обмена сообщениями.
  • Вы можете выполнять предварительный просмотр рабочих элементов по их URL-адресам, чтобы начинать обсуждения и поддерживать контекст в беседах.

Рисунок: уведомление

Ознакомьтесь с этой статьей, чтобы узнать, как:

  • Добавление приложения Azure Boards в команду в Microsoft Teams
  • Связывание и отмена связи проекта Azure Boards с приложением Azure Boards
  • Настройка подписок на события, связанные с рабочим элементом в канале Teams
  • Создание рабочих элементов из канала Teams
  • Мониторинг действий рабочих элементов в канале Teams

Примечание.

Интеграция Azure Boards и Microsoft Teams поддерживается только для Azure DevOps Services.

Кроме того, интеграция Azure Boards и Microsoft Teams не поддерживается, если вы являетесь клиентом сообщества сообщества O365 для государственных организаций (GCC), использующим коммерческую подписку Azure вместе с клиентом GCC.

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

  • Чтобы создать рабочий элемент, необходимо быть участник в проект Azure Boards. Если у вас еще нет проекта, вы можете зарегистрироваться и создать проект. Дополнительные сведения см. в статье "Начало работы с Azure Boards".
  • Чтобы создать подписки в канале Teams для событий рабочих элементов, необходимо быть членом группы проектов Azure Boards Администратор istrator или добавить в роль администратора команды для команды. Сведения о добавлении см. в разделе "Изменение разрешений на уровне проекта" или "Добавление администратора команды".
  • Чтобы получать уведомления, необходимо включить доступ к сторонним приложениям с помощью параметра OAuth для организации Azure DevOps. См. статью "Изменение политик доступа к приложениям" для вашей организации.

Примечание.

  • Приложение Azure Boards для Microsoft Teams можно связать только с проектом, размещенным в Azure DevOps Services в настоящее время.
  • Уведомления в настоящее время не поддерживаются в прямых сообщениях.
  • Поддерживаются только общедоступные каналы.

Добавление приложения Azure Boards в Microsoft Teams

Приложение добавляется в канал Teams в Microsoft Teams.

  1. Посетите магазин приложений в Microsoft Teams и найдите приложение Azure Boards. При установке приветственное сообщение из приложения отображается, как показано на следующем рисунке.

    Фото: приветственное сообщение

  2. Используйте дескриптор @azure boards для взаимодействия с приложением. Список команд см . в справочнике по командам, приведенным далее в этой статье.

Чтобы использовать приложение, необходимо сначала связать проект Azure Boards с каналом Teams.

  1. После установки приложения в команде подключитесь к Azure Boards и выполните проверку подлинности. Используйте вход с другой электронной почтой , если ваши Microsoft Teams и Azure Boards находятся в разных клиентах.

    Подключение и пройти проверку подлинности в Azure Boards.

    Подключение и пройти проверку подлинности в Azure Boards, шаг 2.

  2. После входа используйте следующую команду в канале Teams, чтобы связаться с проектом Azure Boards, указанным с URL-адресом:

     @azure boards link [project url]

    Например:

     @azure boards link https://dev.azure.com/myorg/myproject

После связывания проекта можно создать рабочие элементы с помощью @azure boards create команды или использовать действия сообщения.

Настройка подписок

Вы можете создавать подписки для мониторинга рабочих элементов в любое время с помощью @azure boards subscriptions команды.

  1. Выберите нужный путь к области и событие, которое вам нужно. Используйте связанные фильтры, чтобы настроить уведомления в канале Teams. Чтобы упростить настройку подписок, в раскрывающемся списке пути к области отображаются недавно доступные пути к области.

    Настройка подписок.

Если нужный путь к области не отображается в раскрывающемся меню "Путь к области", следуйте инструкциям, упоминание приведенным в следующем разделе, добавьте пути к области. Пути к областям, добавленные с помощью @azure boards addAreapath путей команд и областей, для которых подписки создаются в канале, всегда отображаются в раскрывающемся списке "Область" вместе с недавно доступными путями к области.

Добавление путей к области

Вы можете добавить области, над которыми работает ваша команда, чтобы они всегда были доступны для создания рабочих элементов и подписок. Эта функция полезна для команд с более чем 100 путями области в своем проекте.

  • Используйте следующую команду, чтобы добавить пути к областям из проекта в канал Teams.

      @azure boards addAreapath [area path]

    Например:

      @azure boards addAreapath myproject\fabrikam

    Добавление сообщения об успешном выполнении areapath

  • Если вы выберете имя проекта в качестве пути к области, вы получите уведомления обо всех путях области в проекте.

Создание рабочего элемента с помощью команды

С помощью приложения Azure Boards вы можете создавать рабочие элементы из канала. Приложение также поддерживает пользовательские рабочие элементы.

  • Чтобы создать рабочий элемент, используйте @azure boards create.

    Создание рабочего элемента с помощью команды

Создание рабочего элемента из действий сообщения

Часто обсуждения в канале требуют создания рабочих элементов. Действия сообщения можно использовать для создания рабочего элемента. Выбранное сообщение предварительно заполнено в разделе описания рабочего элемента. В разделе "Обсуждение" добавленного рабочего элемента сохраняется ссылка обратно на беседу в канале.

  • Создание рабочих элементов с помощью действий сообщения

    Создание рабочего элемента с помощью действия сообщения

    Создайте рабочий элемент с помощью действия сообщения, шага 2.

Управление подписками Azure Boards

  1. Чтобы просмотреть, добавить и удалить подписки для канала, используйте @azure boards subscriptions команду:

     @azure boards subscriptions

Эта команда содержит список всех текущих подписок для канала и позволяет добавлять новые подписки и удалять существующие. В рамках добавления подписок вы также можете настроить уведомления с помощью различных фильтров.

Просмотр подписок

Примечание.

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

Поиск и предоставление общего доступа к рабочим элементам с помощью расширения compose

Чтобы помочь пользователям выполнять поиск и совместное использование рабочих элементов, приложение Azure Boards для Microsoft Teams поддерживает расширение создания. Вы можете искать рабочие элементы по идентификатору рабочего элемента, названию или поддерживаемой функциональной команде. Список команд см. в разделе "Поиск функциональных рабочих элементов". Чтобы использовать расширение создания, пользователи должны войти в приложение Azure Boards либо путем выполнения @azure boards signin команды, либо путем входа в расширение создания напрямую.

Вход в расширение создания.

URL-адреса рабочих элементов предварительной версии

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

Отмена перенаправки URL-адреса рабочего элемента.

Для работы этой функции пользователям необходимо войти в систему. После входа эта функция работает для всех каналов в команде в Microsoft Teams.

Канал Teams может ссылаться только на один проект Azure Boards за раз. Чтобы связаться с другим проектом, необходимо сначала отменить связь текущего проекта с помощью @azure boards unlink команды.

Отмена связывания проекта удаляет все подписки вместе с добавленными путями к области из канала. Если у канала нет подписок, любой пользователь может отменить связь с проектом. Однако если у канала есть подписки, только администраторы проектов могут отменить связь проекта с канала.

Потоки каналов Teams позволяют логически связывать и уменьшать связанные уведомления в канале. Все уведомления, связанные с определенным рабочим элементом, связаны вместе.

Компактное представление потоковых уведомлений

Компактный поток

Расширенное представление потоковых уведомлений

Развернутый поток

Справочник по командам Azure Boards

В следующей таблице перечислены все @azure boards команды, которые можно использовать в канале Microsoft Teams.

Команда Функция
ссылка на @azure доски [url-адрес проекта] Связывание проекта с этим каналом для создания рабочих элементов и получения уведомлений
подписки @azure доски Добавление или удаление подписок для этого канала
создание досок @azure Создание рабочего элемента
@azure доски addAreapath [путь к области] Добавление пути к области из проекта в этот канал
вход @azure доски Вход в организацию Azure Boards
@azure доски выйдите Выход из организации Azure Boards
@azure доски отмены связи Отмена связи проекта из этого канала
отзывы о @azure досках Сообщите о проблеме или предложите функцию

Настройка вкладок Azure DevOps Services в Microsoft Teams

  1. Чтобы перенести доску Kanban или панель мониторинга в Microsoft Teams, нажмите кнопку "+" (добавить новую вкладку) на верхней панели навигации канала команды.

    Откроется диалоговое окно "Добавление вкладки ". Значки обычно упорядочены в соответствии с последним доступом. Вы можете выбрать A-Z для алфавитного списка.

    Снимок экрана: добавление новой вкладки в канал Teams.

  2. Выберите значок Azure DevOps и проверьте подлинность удостоверения. При необходимости можно выбрать значок веб-сайта и добавить URL-адрес панели Kanban или панели мониторинга в канал.

  3. Выберите организацию, чей совет или панель мониторинга, которую вы хотите добавить.

  4. Заполните представленную форму. Например, здесь мы добавим панель мониторинга для команды Azure DevOps для проекта TechnicalContent.

    Диалоговое окно для добавления панели мониторинга группы в канал Teams.

  5. Выбранная доска Kanban или панель мониторинга.

Поддержка мультитенантного режима

В вашей организации, если вы используете другую электронную почту или клиент для Microsoft Teams и Azure DevOps, выполните следующие действия, чтобы войти и подключиться в зависимости от вашего варианта использования.

Вариант

Идентификатор электронной почты и клиент в Microsoft Teams

Идентификатор электронной почты и клиент в Azure DevOps

Шаги для выполнения

1

email1@abc.com
(клиент 1)

email1@abc.com
(клиент 1)

Войдите с помощью кнопки входа .

2

email1@abc.com
(клиент 1)

email1@abc.com
(клиент 2)

  • Вход в учетную запись Azure DevOps
  • В том же браузере начните новую вкладку, перейдите к разделу https://teams.microsoft.com
  • signin Выполните команду и нажмите кнопку входа.

3

email1@abc.com
(клиент 1)

email2@pqr.com
(клиент 2)

Войдите с помощью входа с другим адресом электронной почты, в средстве выбора идентификатора электронной почты используйте электронную почту 2 для входа в Azure DevOps.

4

email1@abc.com
(клиент 1)

email2@pqr.com
(клиент 3 не по умолчанию)

Этот сценарий сегодня не поддерживается

Устранение неполадок

Если при использовании приложения Azure Boards для Microsoft Teams возникают следующие ошибки, выполните действия, описанные в этом разделе.

Произошла ошибка. Повторите попытку.

Приложение Azure Boards использует протокол проверки подлинности OAuth и требует доступа к сторонним приложениям через OAuth для включения организации . Чтобы включить этот параметр, перейдите к политикам>безопасности>параметров организации и задайте доступ к сторонним приложениям через OAuth для параметра организации включено.

Включение доступа к сторонним приложениям через OAuth для параметра организации

Сбой конфигурации. Убедитесь, что организация "{название организации}" существует и у вас есть достаточные разрешения.

Выйдите из Azure DevOps, перейдя в https://aka.ms/VsSignout браузер.

Откройте окно браузера In private или incognito и перейдите к https://aex.dev.azure.com/me ней и войдите. В раскрывающемся списке под значком профиля слева выберите каталог, содержащий организацию, содержащую проект, который требуется связать.

Выберите каталог, содержащий организацию, содержащую проект.

В том же браузере запустите новую вкладку, перейдите к разделу https://teams.microsoft.com/. @azure boards signout Выполните команду, а затем выполните @azure boards signin команду в канале, где установлено приложение Azure Boards для Microsoft Teams.

Sign in Нажмите кнопку, и вы будете перенаправлены на страницу согласия, например в следующем примере. Убедитесь, что каталог, отображаемый рядом с сообщением электронной почты, совпадает с выбранным на предыдущем шаге. Примите и завершите процесс входа.

Согласие на запрошенные разрешения приложения

Если эти действия не устраняют проблему с проверкой подлинности, обратитесь к нам по адресу Сообщество разработчиков.