Интегрируйте AirFocus с Jira.

Преимущества

Обеспечьте бесшовную синхронизацию данных между airfocus и Jira, связав рабочие процессы управления продуктами, системы приоритезации и планы развития с повседневной разработкой. Интеграция совместима с Jira Cloud, Jira Server и Jira Data Center.

• Импортируйте задачи Jira (как объект) в airfocus.
• Переместите объект airfocus в Jira (как задачу любого типа).
• Двусторонняя синхронизация и гибкая фильтрация (пользовательские JQL-запросы).
• Гибкое сопоставление полей.
• Отображайте в Jira оценки приоритетов airfocus для понимания бизнес-ценности и приоритетов.
• Возможность непосредственно наблюдать за взаимоотношениями родителей и детей в режиме AirFocus.

требования

• В AirFocus: Пользователь должен иметь полные права доступа к рабочей области, для которой он хочет настроить интеграцию с Jira.
• В Jira: для установления связи между вашим экземпляром Jira и командой airfocus требуются права администратора.
• Если связь между экземпляром Jira и командой airfocus уже установлена, любой пользователь Jira, имеющий как минимум разрешение "Create_Issue" для проекта, может создать новые интеграции для этого экземпляра.
• Наша интеграция с Jira совместима с Jira Cloud, Jira Server и Jira Data Center. Мы поддерживаем все версии Jira Server, указанные в Политике прекращения поддержки Atlassian. Более ранние версии, чем указанные здесь, достигли конца жизненного цикла (EOL) и могут функционировать, но не поддерживаются.

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

1. Зарегистрируйтесь в airfocus или войдите в свою существующую учетную запись. 
2. Создайте новое рабочее пространство в AirFocus или выберите то, с которым хотите интегрировать Jira.
   • Для авторизации каждой команды AirFocus необходимо выполнить авторизацию экземпляра Jira только один раз.
   • В заданное рабочее пространство можно добавить несколько интеграций Jira (например, из разных проектов Jira или примеров).
3. Нажмите «Расширения» в правом верхнем углу рабочего пространства.
4. Выберите «Управление интеграциями».
5. Нажмите кнопку «Подключить » на плитке «Jira».
6. Выберите пункт «Подключить новый экземпляр Jira» из появившегося раскрывающегося списка.
7. Введите базовый URL-адрес вашего экземпляра Jira (например) https://airfocustest.atlassian.net/ или https://jira.mycompany.com).
8. Нажмите «Продолжить».
9. Скопируйте «URL-адрес приложения». Это понадобится вам для следующих шагов в Jira.
10. Чтобы открыть Центр ссылок приложений Jira , нажмите на соответствующую кнопку.
    • Для доступа к этой странице вам необходимы права администратора в Jira. 

Дальнейшие шаги различаются для Jira Cloud и Jira Server/Data Center. Для продолжения работы с вашим экземпляром проекта ознакомьтесь с разделом ниже.

Создайте ссылку на приложение в Jira Cloud.

1. В Jira Cloud нажмите значок «Настройки» в правом верхнем углу.
2. Выберите приложения Jira. 
3. В разделе «Интеграция» слева нажмите «Ссылки на приложения » .
4. Нажмите кнопку «Создать» в правом верхнем углу страницы.
5. Выберите вариант «Прямая ссылка на приложение».
6. Вставьте URL-адрес вашего приложения AirFocus в поле «URL приложения».
7. Нажмите «Далее».
8. Введите название для приложения и убедитесь, что для типа приложения установлено значение «Универсальное приложение».
9. Используя информацию, предоставленную в airfocus, скопируйте и вставьте в Jira имя поставщика услуг, ключ потребителя, общий секрет, URL-адрес запроса токена, URL-адрес доступа к токену и URL-адрес авторизации.
10. Поставьте галочку рядом с пунктом «Создать входящую ссылку».
11. Нажмите «Продолжить».
12. Используя информацию, предоставленную в airfocus, скопируйте и вставьте ключ потребителя (Consumer Key), имя потребителя (Consumer Name) и открытый ключ (Public Key) в Jira.
13. Нажмите «Продолжить».
14. Вернитесь в AirFocus и нажмите «Завершить настройку».

Мы перенаправим вас на этап авторизации oAuth, который позволит airfocus использовать вашего пользователя Jira для синхронизации объектов между двумя системами. Нажмите «Разрешить» , чтобы разрешить airfocus синхронизироваться с вашей учетной записью.

Создайте связь приложения в Jira Server или Jira Data Center.

1. Нажмите на ссылку «Создать» в правом верхнем углу.
2. Выберите продукт Atlassian.
3. Вставьте URL-адрес вашего приложения AirFocus в поле «URL приложения».
4. Нажмите «Продолжить» для подтверждения.
   
5. Введите значения, предоставленные в интерфейсе airfocus.
6. Нажмите «Продолжить».
7. Скопируйте значения из шага 3. 
8. Нажмите «Продолжить». 
   • Теперь в Jira должно отобразиться подтверждение.
9. Вернитесь в AirFocus и нажмите «Завершить настройку».

Мы перенаправим вас на этап авторизации oAuth, который позволит airfocus использовать вашего пользователя Jira для синхронизации объектов между двумя системами. Нажмите «Разрешить» , чтобы разрешить airfocus синхронизироваться с вашей учетной записью.

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

1. Выберите проект, который хотите синхронизировать. Вы можете ввести текст, чтобы отфильтровать список проектов.
   • Проекты, которые вы видите, но для которых у вас нет прав CREATE_ISSUES, помечены соответствующим образом (доступно только для Jira Cloud).
   • Название вашего модуля создается автоматически на основе проекта. Вы также можете изменить это позже.
2. Выберите тип задачи, которую хотите синхронизировать. 
   • Поскольку поля могут различаться в зависимости от типа задачи (в зависимости от версии Jira и типа проекта, например, управляемого командой или компанией), это позволяет отфильтровать поля, которые можно сопоставить с теми, которые фактически доступны для выбранного типа задачи.
   • Если вы хотите синхронизировать несколько типов задач, мы рекомендуем настроить отдельный интеграционный модуль для каждого типа, либо в одном рабочем пространстве, либо в нескольких рабочих пространствах. Вы можете подключить интеграцию из других рабочих пространств (например, для эпиков или подзадач) через иерархию AirFocus.
   • Вы также можете дополнительно отфильтровать синхронизированные задачи, указав JQL-запрос в фильтре задач (подробнее о JQL можно прочитать здесь).

Сопоставьте поля AirFocus и Jira.

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

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

Также существует множество дополнительных возможностей для сопоставления различных пользовательских и системных полей Jira с полями AirFocus.

Если вы посмотрите на параметры сопоставления полей, то увидите, что по умолчанию всегда сопоставляются два поля: имена объектов и описания объектов.

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

С помощью кнопки «Задать направление» можно одновременно задать направление сопоставления для всех полей (насколько это технически возможно).

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

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

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

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

Обзор всех типов полей, которые можно сопоставить.

Сопоставляемые поля системы Jira:

⚠️ Предупреждение относительно двусторонней синхронизации поля описания: процесс двусторонней синхронизации может привести к незначительным изменениям в содержимом и форматировании описаний в Jira. Это связано с тем, что не все стили Jira пока поддерживаются AirFocus изначально.

⚠️ Предупреждения относительно сопоставления полей с именами пользователей: логика сопоставления основана на отображаемых именах. Поэтому имя "Kirsten" в Jira НЕ соответствует имени "Kirst" в airfocus, хотя в обеих учетных записях используется один и тот же адрес электронной почты.

⚠️ Предупреждение относительно двусторонней синхронизации для полей с расширенным текстом: airfocus не полностью поддерживает все параметры оформления Jira, поэтому двусторонняя синхронизация может привести к незначительным изменениям содержимого или форматирования ваших описаний Jira и полей с расширенным текстом.

В случае, когда Jira допускает только одно значение в поле "Контакты" (например, у него может быть только один ответственный), синхронизация с AirFocus отдает предпочтение первому значению в сопоставленном поле "Контакты" AirFocus. Например, задача в Jira, назначенная "Джулиану", перезапишет объект в airfocus, назначенный "Джулиану и Никите". Никита будет отстранен, и в должности останется только Джулиан.

Настраиваемые поля Jira, допускающие сопоставление:

Совместимость форматирования Jira и airfocus:
Приведённый ниже список не является исчерпывающим, но охватывает большинство элементов панели инструментов форматированного текста и меню командной строки Jira.

Устранение неполадок: Найдите поле с диапазоном дат

⚠️ Предупреждение относительно двусторонней синхронизации полей с расширенным текстом: процесс двусторонней синхронизации может привести к незначительным изменениям в содержимом и форматировании описаний в Jira и полей с расширенным текстом. Это связано с тем, что не все стили Jira изначально поддерживаются в airfocus. Нам необходимо как минимум два поля с датами (помимо версий исправлений), чтобы иметь возможность сопоставить их с полем диапазона дат airfocus.

Наша интеграция может обнаруживать поля с датами только в том случае, если они видны на синхронизированном типе задачи (экране). Необходимо убедиться, что в Jira для типа задачи (экрана) присутствует как минимум два поля с датами, а в рабочей области AirFocus — как минимум одно поле с диапазоном дат для сопоставления.

Вот как это выглядит в Jira:

• Для командного управления задачами в Jira Cloud перейдите в настройки проекта > типы задач и перетащите поле из правой боковой панели в список полей посередине.
• Для Jira Cloud с управлением компанией (и Jira Server) перейдите в настройки проекта > задачи > экраны и отредактируйте экран типа задачи, которую вы синхронизируете. Внизу можно добавить дополнительные поля для ввода даты.

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

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

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

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

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

Как сопоставить показатель фокусировки с Jira

Благодаря интеграции airfocus с Jira, вы можете использовать airfocus для определения приоритетов и составления дорожных карт, в то время как разработчики (и другие) будут использовать Jira для повседневного планирования разработки.

По умолчанию в Jira уже отображаются данные AirFocus, такие как оценки приоритетов, полосы и временные шкалы. В этой справочной статье описывается, как сопоставить показатель фокусировки AirFocus с пользовательским полем Jira (которое также можно фильтровать в Jira).

Сопоставив показатель эффективности airfocus с вашим проектом Jira, вы сможете отображать ваш главный приоритетный показатель прямо там, где работают люди — на каждой синхронизированной карточке задачи Jira и на обложке карточки задачи. Таким образом, вы сможете согласовать действия всей команды и сосредоточить ее на действительно важных задачах.

Для отображения показателя фокусировки airfocus в Jira необходимо сопоставить его с пользовательским полем Jira. Пользовательское поле должно иметь тип "Числовое поле". Настройка занимает около 3 минут.

Вот как это сделать:

1. В Jira нажмите на значок шестеренки в правом верхнем углу, чтобы открыть настройки.
2. Проблемы, требующие клика.
3. Выберите «Пользовательские поля» в меню навигации слева.
4. Нажмите «Создать пользовательское поле» в правом верхнем углу.
5. Выберите тип поля «Число ».
6. Введите название и описание (необязательно).
7. Нажмите «Создать».
8. Свяжите новое пользовательское поле с экранами (вашего синхронизированного проекта).
   
9. Вернитесь к настройкам интеграции Jira в AirFocus и выберите из выпадающего списка только что созданное пользовательское поле.
   

Теперь оценка эффективности AirFocus будет отображаться для ваших задач в Jira.
 

Если вы также хотите отображать показатель концентрации на обложках ваших карт, выполните следующие шаги:

1. Нажмите на значок с тремя точками в правом верхнем углу вашей доски.
2. Выберите настройки платы.
3. В меню навигации слева выберите пункт «Макет карточек» .
4. Выберите из выпадающего списка пользовательское поле для оценки концентрации внимания.
5. Нажмите «Добавить».
6. Теперь на доске также отображается показатель концентрации внимания.
   

Настройте дополнительные параметры

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

Типы ссылок на объекты карты

Вы можете синхронизировать типы ссылок на объекты — такие как «Блоки», «Дубликаты» и «Связанные с» — между Jira и airfocus, используя как двустороннюю, так и одностороннюю синхронизацию. При настройке двусторонней синхронизации для определенного типа связи любое обновление на одной платформе автоматически отражается на другой, что позволяет визуализировать зависимости в графиках и планах развития без ручного дублирования. Для более специфических рабочих процессов вы можете настроить одностороннюю синхронизацию или объединить данные, сопоставив несколько типов ссылок Jira с одним типом ссылки airfocus.

Для сопоставления типов связей объектов выполните следующие шаги:

1. Нажмите «Расширения» в правом верхнем углу любой страницы airfocus.
2. Выберите «Управление интеграциями».
3. В разделе «Активные интеграции» выберите Jira.
4. В разделе «Сопоставление типов ссылок объектов» нажмите « + Добавить сопоставление типов ссылок ».
5. С помощью выпадающих списков выберите тип ссылки для Jira слева и тип ссылки для AirFocus справа.
6. Нажмите на значок стрелки под надписью «Направление», чтобы изменить режим синхронизации: двусторонний или односторонний.
7. При желании нажмите кнопку « + Добавить тип ссылки» , чтобы добавить дополнительный тип ссылки Jira, который будет сопоставлен с одним типом ссылки airfocus.
   • Если вы добавите дополнительный тип ссылки, то при синхронизации AirFocus с Jira синхронизация будет происходить только с основным типом ссылки.
8. В нижней части страницы нажмите кнопку «Обновить и синхронизировать» .

Теперь взаимосвязи и зависимости между объектами будут синхронизироваться между Jira и AirFocus в соответствии с заданными вами настройками.
 

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

Функция синхронизации иерархии в Jira позволяет автоматически синхронизировать отношения «родитель-потомок» из вашего проекта Jira в airfocus. Это позволяет вам выполнять работу по управлению продуктом в airfocus, имея при этом под рукой актуальную иерархию Jira, без необходимости переключаться между airfocus и Jira.

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

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

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

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

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

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

При включении синхронизации иерархий в Jira обратите внимание на следующее:

• Интеграция только добавляет отношения между синхронизированными объектами, а не дополнительными объектами. Это означает, что объекты должны быть синхронизированы соответствующими интеграциями еще до того, как будут синхронизированы связи в иерархии.
• API Jira не отображает дочерние элементы эпика, что не позволяет AirFocus определить, есть ли у эпика Jira дочерние задачи. Для того чтобы в AirFocus отображались дочерние связи, эпик должен быть уже синхронизирован с AirFocus при синхронизации задач дочернего уровня, чтобы все связи корректно отображались в AirFocus.

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

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

Примечание относительно синхронизации иерархии для пользователей Jira Data Center/локальной версии:

• Иерархия airfocus не синхронизируется с инициативами Jira в локальной среде. Только былины, истории, задачи и подзадачи.
• Иерархия airfocus синхронизируется со всеми уровнями Jira Cloud, включая инициативы, эпики, истории, задачи и подзадачи.

Дополнительная информация

Подключить несколько проектов Jira

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

Статические IP-адреса для добавления в белый список для интеграции с Jira Server.

Если вы интегрируетесь с локальной системой развертывания, такой как Jira Server, вашей ИТ-команде может потребоваться разрешить Airfocus в настройках брандмауэра, чтобы Airfocus мог устанавливать соединения с вашим сервером для создания записей. Подключение можно осуществить через порт 443.

Команды на сайтах 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

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

• Убедитесь, что права доступа пользователя, пытающегося подключить AirFocus к Jira, соответствуют требованиям.
• Проверьте раздел сопоставления полей на наличие предупреждений или отсутствующих полей.
• Нажмите кнопку «Отладка» внизу настроек интеграции. В процессе синхронизации вызывается несколько конечных точек API. Если один из них выйдет из строя, трудно сказать, какой именно. Диалоговое окно отладки отображает все вызовы и их результаты, что упрощает поиск ошибок конфигурации.
• Удалить и заново установить интеграцию. Подсказка: Настройка связи приложения для подключения AirFocus к Jira остается неизменной.
• Обратитесь за дополнительной помощью к нашей замечательной команде поддержки клиентов.

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