Использование приложения Azure Boards с Slack для управления рабочими элементами

  • Статья

Azure DevOps Services

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

Приложение Azure Boards для Slack позволяет пользователям настраивать и администрировать подписки в канале Slack. Они могут управлять подписками для создания, обновления и других событий рабочих элементов. Пользователи также могут получать уведомления об этих событиях в своем канале Slack. Беседы в канале Slack можно использовать для создания рабочих элементов. Возможность предварительного просмотра URL-адресов рабочих элементов помогает пользователям начать обсуждение работы.

Рис. Уведомление

Прочитайте эту статью, чтобы узнать, как:

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

Примечание

  • интеграция Azure Boards и Slack поддерживается только для Azure DevOps Services.
  • Уведомления в настоящее время не поддерживаются в прямых сообщениях.

Предварительные требования

Добавление приложения Azure Boards в рабочую область Slack

  1. Чтобы установить приложение Azure Boards в рабочую область Slack, откройте веб-браузер, войдите в Slack и откройте приложение Azure Boards.

  2. После добавления вы увидите приветственное сообщение из приложения, как показано на следующем рисунке.

    Рис. Приветственное сообщение

  3. Используйте дескриптор /azboards Slack для взаимодействия с приложением. Список команд приведен далее в этой статье Справочник по командам.

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

  1. После установки приложения в рабочей области Slack подключитесь и выполните проверку подлинности для Azure Boards.

    Снимок экрана: вход

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

     /azboards link [project url]

    Например:

     /azboards link https://dev.azure.com/myorg/myproject

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

Настройка подписок для мониторинга рабочих элементов

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

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

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

    Если путь к области вашей команды не отображается в раскрывающемся меню Путь к области, следуйте инструкциям, приведенным в следующем разделе Добавление путей к областям. Пути к областям, добавленные с помощью /azboards addAreapath команды и пути к областям, для которых создаются подписки в канале Slack, всегда отображаются в раскрывающемся списке Путь к области вместе с недавно использовавшащимися путями к области.

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

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

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

      /azboards addAreapath [area path]

    Например:

      /azboards addAreapath myproject\fabrikam

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

  • Если в качестве пути к области выбрано имя проекта, вы получите уведомления обо всех путях к областям в проекте. Это логически эквивалентно выбору пути к области "Любой".

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

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

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

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

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

     /azboards create [work item type] [work item title]

    Например:

     /azboards create 'user story' Push cloud monitoring alerts to mobile devices

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

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

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

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

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

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

     /azboards subscriptions

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

[! ПРИМЕЧАНИЕ. Администраторы команд не могут удалять или изменять подписки, созданные администраторами проекта.

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

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

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

Рис. Распаковка URL-адреса

Чтобы эта функция работала, пользователи должны войти в систему. После входа эта функция работает для всех каналов в рабочей области.

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

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

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

В следующей таблице перечислены все команды, /azboards которые можно использовать в канале Slack.

Команда косой черты Функциональность
/azboards link [URL-адрес проекта] Связывание проекта с этим каналом для создания рабочих элементов и получения уведомлений
/azboards subscriptions Добавление и удаление подписок для этого канала
/azboards create или /azboards create [тип рабочего элемента] [название] Создать рабочий элемент
/azboards addAreapath [путь к области] Добавление пути к области из проекта в этот канал
/azboards signin Войдите в Azure Boards организацию
/azboards signout Выход из Azure Boards организации
/azboards unlink Удаление связи проекта с этим каналом
Обратная связь /azboards Сообщить о проблеме или предложить функцию

Управление работой в частных каналах

Приложение Azure Boards для Slack может помочь вам создавать рабочие элементы и отслеживать активность рабочих элементов в частных каналах. Чтобы пригласить бота в частный канал, введите /invite @azboards. После публикации вы можете создавать рабочие элементы и управлять уведомлениями так же, как для общедоступного канала.

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

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

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

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

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

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

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

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

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

В том же браузере запустите новую вкладку, перейдите на страницу https://slack.comи войдите в рабочее пространство (используйте веб-клиент). Выполните команду , /azboards signout за которой следует /azboards signin команда .

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

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

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