Интеграция с Jira


 

Доступ к разделу "Настройки интеграции Jira"

 

Для того чтобы подключить Jira в Вашу систему необходимо выставить доступ конкретным группам пользователей к данному модулю. Для этого необходимо перейти из "Управления" в раздел "Группы, права доступа" и выбрать группу для редактирования. Во блоке "Управление" подключить и сохранить.

 

 

Подключение в систему

 

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

  • Адрес системы Jira;
  • Логин;
  • Пароль или API токен. 

 

 


 

Хотим обратить внимание, что при подключении облачной и серверной систем Jira существуют некоторые особенности. На данный момент в облачной системе  авторизацию можно произвести как по паролю, так и используя  API токен. Коробочная версия предполагает авторизацию только по паролю. В будущем для облачных решений планируется оставить только авторизацию по API токену, поэтому рекомендуем изначально использовать для авторизации данный способ.

 


 

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

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

  1.  Откройте https://id.atlassian.com и введите Ваши данные авторизации системы Jira;
  2.  После этого необходимо отрыть настройки Вашего профиля/аккаунта - https://id.atlassian.com/manage-profile/profile-and-visibility
  3. В разделе "Security" => API token нажмите на Create and manage API tokens
  4. В открывшемся окне нажмите на "Сreate API Token", введите Label (название) и скопируйте сам Токен.

 

 

Далее в системе необходимо в разделе "Настройки интеграции Jira" c помощью "Подключить Jira" ввести адрес системы (https://yourdomain.atlassian.net/), логин и токен из Jira, и нажать "Проверить соединение":

 

 

При успешном соединении, будет отображено сообщение "Соединение успешно установлено!", а также список доступных функций для работы с проектами и заявками Jira:

 

 

После подключения интеграция будет иметь вид:

 

 

Журнал ошибок Jira

 

Журнал ошибок включает в себя всю информацию по каким-либо ошибкам подключения или работы интеграции.

 

Ошибка "Домен уже используется"

Может быть в случае отсутствии прав администратора Jira или при отсутствии возможности создать/редактировать вебхук в Jira.

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

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

 


 

Пример работы интеграции Jira

 

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

  1. При создании проекта или задачи в Jira от имени пользователя по которому происходит интеграция с системой HelpDeskEddy - данные игнорируются и не интегрируются в систему HelpdeskEddy. Поэтому рекомендуем для тестирования и работы с интеграцией использовать дополнительный профиль пользователя в Jira.(не используемый для интеграции между системами).
  2.  Типизация Jira. При отсутствии хотя бы одного доступа к какому-либо из типов проекта в настройках интеграции - создать заявку в Jira - не предоставляется возможным. Потому необходим доступ хотя бы к одному из Типов проекта.

 


 

Принятие заявок из Jira

 

Создание новой задачи в проекте на стороне Jira:

 

Отображение данной задачи в системе HelpDeskEddy:

 

При добавлении ответов и внесение изменений в существующие задачи Jira, эти данные также будут синхронизированы в системе HelpDeskEddy.

Пример добавления ответа и изменения исполнителя на стороне Jira:

 

 

Пример отображения данного ответа и изменений на стороне HelpDeskEddy:

 

Создание заявок в Jira

 

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

 

После добавления комментария, в заявке отобразятся проекты и задачи в которые была добавлена данная информация:

По данным ссылкам можно перейти в проект и конкретную задачу в Jira:

 

При переходе в конкретную задачу Jira можно увидеть отправленный комментарий, а также мета-данные по заявке:

 

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