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

Интеграция HelpDeskEddy с Jira позволит IT-команде и службе поддержки работать вместе для быстрого решения запросов пользователей.

 



 

 

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

 

Для интеграции Jira с HelpDeskEddy перейдите в меню "Настройки интеграции Jira" из Управления: 

 

 


 

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

 


 

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

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

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

 

 

Далее в HelpDeskEddy необходимо в интерфейсе добавления интеграция укажите:

 

  • Домен системы. Например: https://hdejiratest.atlassian.net;
  • Логин + API токен (который сгенерировали на предыдущем шаге) или пароль;
  • Синхронизация полей. Позволяет записывать изменения с выбранными полями Jira (Приоритет, Статус, Исполнитель, Решение) в комментарии заявки HelpDeskEddy:

 

eba14a2588f7fcdde7ef7acf767e923f46f73dc1

 

 

При успешном соединении вы увидите уведомление, а также ниже отобразится список доступных настроек для работы с проектами и заявками 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:

 

 


Как HelpDeskEddy определяет, какие задачи из Jira связаны с текущей заявкой:

1. Когда в HelpDeskEddy в существующей заявке в комментарии по кнопке создается задача в Jira - HDE создает Jira задачу и связывает её с заявкой.
2. Когда в Jira создается новая задача в подключенном к интеграции проекте - Jira в HelpDeskEddy создает новую заявку и связывает их.
3. Когда в Jira создается задача, в теме которой есть [#unique_id] (уникальный айди) заявки HelpDeskEddy - она находит существующую заявку в HDE и привязывает задачу к ней, вместо создания новой.


 

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

 

 

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