Интеграция с Azure Boards
Интеграция с Azure DevOps Boards позволяет экспортировать дефекты из Vampy в work items Azure DevOps, синхронизировать статусы и комментарии в обе стороны.
Для интеграции с репозиториями Azure Repos (VCS) см. отдельную статью.
Personal Access Token (PAT)
Создайте PAT в Azure DevOps: User settings → Personal access tokens → New Token.
Минимально необходимые права:
- Member Entitlement Management — Read
- Work Items — Read & write
Скриншоты настройки Scopes в PAT
Документация Microsoft: Use personal access tokens.
Настройка интеграции в Vampy
Настройка выполняется в мастере по шагам.
- Войдите в платформу как администратор.
- Перейдите в Администратор → Интеграции и откройте Azure Boards (карточка на странице интеграций или пункт в меню слева).
- Нажмите + Подключить (или откройте существующую интеграцию для редактирования).
Шаг 1 — подключение
Укажите:
- Имя подключения — произвольное имя интеграции
- URL — адрес организации Azure DevOps, например
https://dev.azure.com/my_organization - Токен — Personal Access Token (PAT), см. раздел выше
При необходимости в Дополнительных опциях задайте CA-сертификаты или включите игнорирование проверки SSL-сертификата.
Нажмите Далее.
Шаг 2 — проект и тип work item
Выберите:
- Проект — проект Azure DevOps, куда будут создаваться задачи
- Тип задачи — тип work item (например, Issue, Bug)
Для обратной синхронизации включите:
- Синхронизация статусов — изменения статуса work item в Azure DevOps отражаются в Vampy
- Синхронизация комментариев — комментарии синхронизируются в обе стороны
Чтобы обратная синхронизация работала, администратор Azure DevOps должен настроить Service Hooks (см. раздел Service Hooks ниже). Без вебхука Vampy сможет создавать work items, но не получать обновления из ADO.
Нажмите Далее.
Шаг 3 — сопоставление статусов
Сопоставьте статусы Azure Boards со статусами Vampy. Для обратной синхронизации нужно сопоставить хотя бы один статус.
Нажмите Далее.
Шаг 4 — значения полей по умолчанию
Заполняйте поля только если нужны предзаполненные значения для экспорта (State, Priority, Assigned To, Tags и т.д.) — и обязательные, и необязательные в настройке можно оставить пустыми. При отправке каждой задачи из Vampy те же поля задаются или меняются в форме перед созданием work item в Azure Boards.
Нажмите Сохранить.
Интеграция появится в списке Интеграции Azure Boards. Нажмите Copy webhook, чтобы скопировать URL вебхука Vampy — он понадобится при настройке Service Hooks в Azure DevOps.
Service Hooks (вебхуки) для обратной синхронизации
Чтобы Vampy получал изменения статусов и комментариев по уже экспортированным work items, настройте Service Hook в настройках проекта Azure DevOps: Project Settings → Service hooks → Create subscription.
Шаг 1. Trigger — событие Work item updated.
Шаг 2. В блоке Filters для поля Field выберите [Any] (не указывайте конкретное поле).
Так одной подпиской перехватываются и смена статуса, и добавление комментариев.
Остальные фильтры (Area path, Work item type, Tag) при необходимости тоже можно оставить [Any].
Шаг 3. Action — Post via HTTP. В поле URL вставьте webhook URL, скопированный из Vampy (Copy webhook в списке интеграций Azure Boards):
Шаг 4. Сохраните подписку. При необходимости используйте Test, чтобы проверить доставку на Vampy.
Документация Microsoft: Webhooks with Azure DevOps (настройка подписки Service Hooks → Web Hooks: Trigger, фильтры, URL). Список событий и полей payload — в Service hook events.
Экспорт дефектов в Azure Boards
После настройки интеграции дефекты можно отправить в Azure DevOps:
- Перейдите на страницу дефектов репозитория или продукта.
- Выберите один или несколько дефектов.
- В меню действий выберите Отправить в таск-трекер и укажите подключение Azure Boards.
Подробнее о форме экспорта и дополнительных действиях — в Отправка issue в таск-трекер.
Дефекты можно отправить:
- По одному — для каждого дефекта будет создан отдельный work item;
- Объединённо — несколько дефектов будут объединены в один work item.