Интегрируйте airfocus с Microsoft Azure DevOps

Преимущества использования интеграции Microsoft Azure DevOps

• Импортируйте рабочий объект Microsoft Azure DevOps в airfocus.
• Вставьте объект airfocus в Microsoft Azure DevOps (как и любой тип рабочего объекта).
• Гибкая фильтрация (через поиск проблем Microsoft Azure DevOps).
• Гибкое сопоставление системных и пользовательских полей с настраиваемыми направлениями синхронизации для каждого поля.
• Напрямую сопоставьте описания Microsoft Azure DevOps с описаниями airfocus.
• Отображайте свои итерации (спринты) в AirFocus для понимания контекста, важного для бизнеса и приоритетов.

Настроить интеграцию

Интеграции в airfocus всегда подключаются к одному конкретному рабочему пространству airfocus. В заданную рабочую область можно добавить несколько интеграций Microsoft Azure DevOps (например, из разных проектов Microsoft Azure DevOps или для разных типов рабочих объектов).

Чтобы настроить интеграцию Microsoft Azure DevOps, выполните следующие действия:

1. Зарегистрируйтесь в airfocus или войдите в свою существующую учетную запись. 
2. Создайте новое рабочее пространство в AirFocus или выберите то, с которым вы хотите интегрировать Microsoft Azure DevOps.
3. Нажмите «Расширения» в правом верхнем углу страницы.
4. Выберите «Управление интеграциями».
   
5. Нажмите кнопку «Подключиться» на плитке « Microsoft Azure DevOps».

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

Подключитесь к своей учетной записи Microsoft Azure DevOps Cloud.

Чтобы продолжить настройку интеграции для учетной записи Microsoft Azure DevOps Cloud, выполните следующие действия:

1. В селекторе типа изделия выберите облакоMicrosoft Azure .
2. Нажмите «Продолжить».

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

Убедитесь, что в настройках политик организации в Microsoft Azure DevOps включен параметр «Доступ к сторонним приложениям через OAuth», чтобы обеспечить успешную интеграцию.

Подключитесь к своей учетной записи Microsoft Azure DevOps Server (локальная версия).

Чтобы продолжить настройку интеграции для учетной записи Microsoft Azure DevOps Cloud, выполните следующие действия:

1. В селекторе типа варианта выберите Microsoft Azure On-Premise .
2. Нажмите «Продолжить».
3. Введите данные для подключения к вашему экземпляру Microsoft Azure DevOps Server.
   • Базовый URL: Введите первую часть URL-адреса вашего сервера Microsoft Azure DevOps (все, что находится до конца вашего домена/IP-адреса и до первой обратной косой черты). Например: https://198.254.533.325. URL-адрес должен быть доступен для наших серверов, поэтому вы не можете использовать здесь URL-адреса, размещенные локально.
   • Персональный токен доступа: Получите свой персональный токен доступа, перейдя в раздел «Персональные токены доступа» в настройках безопасности пользователей Microsoft Azure DevOps. Более подробную информацию см. в разделе «Получение персонального токена доступа» ниже.
   • Название организации: Введите точное название организации Microsoft Azure DevOps, которую вы хотите синхронизировать с airfocus.
4. Нажмите «Продолжить» , чтобы подключить вашу команду airfocus к вашей организации Microsoft Azure DevOps.

Получите персональный токен доступа.

Чтобы получить персональный токен доступа в Microsoft Azure DevOps, выполните следующие действия:

1. Откройте настройки безопасности ADO.
2. Выберите «Персональные токены доступа» в навигационном меню в левой части страницы.
3. Нажмите кнопку «+ Новый токен» в верхней части страницы.
4. Создайте новый токен с как минимум следующими правами доступа:
   • Рабочий объект (чтение и запись)
   • Проект и команда (читать)
   • Срок действия персональных токенов доступа может быть установлен максимум на 1 год. Не забывайте своевременно обновлять срок действия вашего токена, чтобы обеспечить бесперебойную работу интеграции AirFocus.
5. Нажмите «Создать».
6. Скопируйте токен и вставьте его в настройки вашего интерференц-интерфейса в AirFocus.

Настройте фильтры интеграции

Чтобы настроить фильтры интеграции:

1. Выберите проект Microsoft Azure DevOps, с которым вы хотите интегрироваться. Добавьте следующую информацию, чтобы AirFocus знал, куда отправлять данные:
   • Организация
   • Проект
   • Область
2. При желании можно включить рабочие объекты всех подобластей выбранной области, установив флажки рядом с пунктом «Включить рабочие объекты всех подобластей выбранной области».

В настройках интеграции вы можете дополнительно указать, какой рабочий объект вы хотите синхронизировать, используя поле поиска задач Microsoft Azure DevOps. Он обеспечивает быстрый и гибкий поиск по всем рабочим объектам во всех ваших проектах (например, t:epic AND s:new).

Общие фильтры

• Для фильтрации по типу рабочего объекта Microsoft Azure DevOps:
  • т:эпик
  • t:feature
  • t:история
  • t:задача

Чтобы добавить объект с определенным тегом Microsoft Azure DevOps

• теги:тег abc

Для загрузки объекта, соответствующего определенной итерации Microsoft Azure DevOps.

• итерация:итерация abc

Подробнее о расширенном поиске читайте здесь.

Настройте сопоставление полей.

Используйте функцию сопоставления, чтобы определить, как информация в Microsoft Azure DevOps должна сопоставляться с airfocus (и наоборот). Имена объектов (обязательно) и описания объектов (необязательно) всегда сопоставляются по умолчанию при настройке нового интеграции.

Как задать направление движения на карте

Для каждого поля укажите, хотите ли вы одностороннюю или двустороннюю синхронизацию между полем в Microsoft Azure DevOps и airfocus.

Задайте направление сопоставления для всех полей одновременно с помощью раскрывающегося списка «Задать направление».

По умолчанию направление сопоставления задано только для Microsoft Azure DevOps и airfocus, но пользователь может изменить его на любое доступное для сопоставления направление.

Как добавить новое сопоставление полей

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

После выбора двух полей, которые вы хотите сопоставить, вы можете выбрать параметры полей и способ их сопоставления:

Автоматическое сопоставление полей

При сопоставлении полей с множеством параметров включите параметр "Автоматическое сопоставление параметров поля", чтобы сэкономить время. Это позволяет автоматически сопоставлять поля с одинаковыми значениями как в AirFocus, так и в Microsoft Azure DevOps.

Автоматическое создание значений полей

Включите параметр "Автоматическое создание полей", чтобы новые поля, созданные в Microsoft Azure DevOps, автоматически добавлялись в airfocus при их добавлении к объекту. 

Примечание: генератор полей с автоматическим созданием не чувствителен к регистру.

Обзор всех доступных в настоящее время вариантов картирования полей.

Примечания

1. ⚠️ Если синхронизация описания происходит в обоих направлениях, это может привести к тому, что AirFocus внесет незначительные изменения в содержимое и форматирование описаний Microsoft Azure DevOps. Это связано с тем, что не все стили Microsoft Azure DevOps пока поддерживаются в airfocus нативно.
2. Сопоставление в этом направлении не может быть поддержано, если целевое поле в ADO настроено как поле только для чтения.
3. Сюда входят только пользовательские числовые поля из ADO. При этом любые числовые поля системы (например, приоритет или трудозатраты) необходимо реализовывать отдельно. Таким образом, если числовое поле системы явно не указано в этой таблице, это означает, что оно пока не поддерживается.
4. Списки выбора с разрешенными пользовательскими значениями не подходят для сопоставления с полями выбора AirFocus, поскольку количество вариантов выбора в этом случае является динамическим и может часто меняться со временем, что потребует перенастройки сопоставления интеграции каждый раз, когда в списке выбора появляется новое значение. Именно поэтому мы сопоставляем такие списки выбора с обычными текстовыми или числовыми полями в AirFocus, чтобы любые новые значения на стороне ADO всегда автоматически синхронизировались со стороной AirFocus.
5. Сюда входят пользовательские поля даты и времени, а также системные поля «Дата начала», «Целевая дата», «Срок выполнения», «Дата решения» и «Дата изменения состояния».
6. ⚠️ В настоящий момент airfocus не поддерживает поля типа дата-время (с указанием времени), а только поля типа дата. Таким образом, сопоставление полей даты и времени ADO с полями даты AirFocus в обоих направлениях приводит к потере временной части на стороне ADO — AirFocus обновит время до 00:00:00.
7. В настоящее время ADO не имеет встроенных полей для указания диапазона дат. Однако можно сопоставить пару любых поддерживаемых полей даты и времени ADO с полем airfocus, определяющим диапазон дат.
8. Сопоставление поля Stack Rank из airfocus с Microsoft Azure DevOps может привести к неожиданному поведению. В документации Microsoft не рекомендуется обновлять это поле вручную, поскольку Microsoft Azure DevOps динамически рассчитывает рейтинг задач в фоновом режиме для поддержания приоритетов в бэклоге. Наилучшим образом его можно использовать в качестве односторонней синхронизации между ADO и airfocus.

Синхронизация иерархии

Синхронизация иерархии для Microsoft Azure DevOps позволяет автоматически синхронизировать отношения «родитель-потомок» из вашего проекта Microsoft Azure DevOps в AirFocus (пока что это односторонняя синхронизация). Это позволяет вам заниматься управлением продуктами в airfocus, имея при этом под рукой самую актуальную иерархию Microsoft Azure DevOps, без необходимости переключаться между airfocus и Microsoft Azure DevOps.

Для настройки/включения синхронизации иерархий в Microsoft Azure DevOps вам потребуется:

• Два или более рабочих пространства с включенной иерархией AirFocus между ними ИЛИ рабочее пространство, допускающее иерархические связи внутри одного и того же рабочего пространства.
• Два или более типов рабочих объектов Microsoft Azure DevOps синхронизированы с airfocus.
• Если у вас два компонента в двух рабочих областях, синхронизируйте один тип объекта для каждой рабочей области.
• Если в одном рабочем пространстве находятся два компонента, синхронизируйте один тип объекта для каждого из компонентов в этом рабочем пространстве.

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

Для настройки синхронизации иерархии выполните следующие действия:

1. В настройках рабочей области в AirFocus убедитесь, что иерархия продуктов AirFocus включена как в рамках другой рабочей области, так и в рамках текущей рабочей области.
   
2. В нижней части страницы настроек интеграции Microsoft Azure DevOps включите виджет «Автоматическое связывание объектов».
   
3. Для обеспечения сохранения иерархии убедитесь, что рабочие пространства соответствуют следующим требованиям:
   • Другая рабочая область интегрирована в ту же организацию Microsoft Azure DevOps.
   • Пользователь имеет полный доступ к другому рабочему пространству.
   • Другое рабочее место находится в той же команде airfocus.

После включения синхронизации иерархии вы сможете видеть отношения «родитель-потомок» непосредственно в AirFocus.

Обратите внимание на следующие моменты при включении синхронизации иерархии для Microsoft Azure DevOps:

• Интеграция только добавляет отношения между синхронизированным объектом, а не дополнительным объектом. Это означает, что объекты должны быть синхронизированы соответствующими интеграциями еще до синхронизации связей в иерархии.
• Синхронизацию иерархии для Microsoft Azure DevOps также можно настроить в рамках одной рабочей области, если несколько типов рабочих объектов Microsoft Azure DevOps синхронизированы с одной и той же рабочей областью airfocus (либо посредством одной, либо нескольких интеграций) и включена опция «Разрешить иерархические связи в этой рабочей области» на вкладке «Иерархия» в настройках рабочей области.

Для включения синхронизации иерархии в Microsoft Microsoft Azure Microsoft Azure DevOps.

Дополнительные настройки

• Если включена опция "Архивировать неизвестные задачи", ранее импортированные объекты архивируются в AirFocus, если они больше не присутствуют в Microsoft Azure DevOps или больше не соответствуют фильтрам, установленным для интеграции.
• Если включена функция "Автоматическая синхронизация", ваша интеграция будет автоматически синхронизироваться каждые 10 минут и каждый раз при доступе к рабочему пространству.
• Нажмите «Просмотреть журналы» , чтобы просмотреть журналы проверки интеграции Microsoft Azure DevOps и узнать, какие изменения были внесены до последней синхронизации.
  

Чтобы сохранить настройки и импортировать объект в AirFocus, нажмите «Обновить и синхронизировать».

Статические IP-адреса для добавления в белый список в вашей интеграции Microsoft Azure DevOps

Команды доступны по адресу https://app.airfocus.com или https://app.us.airfocus.com  Используйте следующие IP-адреса:

• 46.101.71.101
• 46.101.69.142

Команды на https://airfocus.app, Используйте следующие IP-адреса:

• 100.24.176.163
• 34.204.246.112
• 54.227.154.184
• 35.156.253.227
• 18.159.159.136
• 18.199.183.125

Важная информация

• Для создания/аутентификации нового интеграции с Microsoft Azure DevOps, используемая учетная запись Microsoft Azure DevOps должна иметь права администратора.
• Для изменения существующего интеграции в AirFocus пользователю достаточно иметь полные права доступа к рабочей области.
• Даже если у пользователя airfocus нет доступа к учетной записи Microsoft Azure DevOps, использованной для первоначальной настройки, учетная запись Microsoft Azure DevOps должна сохранять те же права доступа, чтобы гарантировать бесперебойную работу интеграции.
• Если ранее была активирована двусторонняя синхронизация, она будет применена ко всем возможным сопоставлениям. В противном случае соединение будет установлено как одностороннее, от Microsoft Azure DevOps к airfocus.
• Если включена опция "Показать описание Microsoft Azure DevOps", синхронизация описания с этим специальным полем (только для чтения) будет производиться только до 31 марта 2023 года. Пользователям необходимо вручную перенести данные в новую конфигурацию поля описания в разделе сопоставления полей своей интеграции. С 1 апреля 2023 года специальное поле описания (и его переключатель) больше не будет доступно.

Оставьте отзыв об этой статье