Jira

Интеграция c Jira – работа с задачами Jira напрямую из Юздеска (создание и актуализация задач, отслеживание последних изменений, привязка задач к определенной карточке запроса и др.).

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

1. Создайте дополнительное поле с типом текст. Откройте раздел «Настройки» «Дополнительные поля», нажмите «Создать».

2. Создайте динамический блок. Откройте раздел «Настройки» «Блоки», нажмите «Добавить динамический блок»:

  • Имя – название системы;
  • Заголовок – название блока, которое будет отображаться в карточке запроса;
  • URL – заполните поле значением https://jira.integrations.usedesk.ru/api/jira/issue;
  • Включен – установите флажок для активации блока;
  • Добавить параметр – POST параметры (см.п.3)

3. Добавьте параметры (POST):

  • jira_domain – домен Jira. Писать с https:// (обязательный параметр);
  • jira_username – имя пользователя в Jira (email для облака). Создавать динамический блок необходимо с данными администратора в Jira (обязательный параметр);
  • jira_secret – для коробочной версии: пароль от аккаунта, имя пользователя которого вы указали в поле jira_username (обязательный параметр). Для облачной версии: токен;
  • usedesk_field_id – ID дополнительного поля из п.1 (обязательный параметр). В поле будут отображаться номера задач, привязанные к карточке запроса;
  • usedesk_token – API токен из любого API канала (обязательный параметр). Создайте канал API в Юздеске или воспользуйтесь существующим, скопируйте значение из поля "Секретный ключ";
  • new_comments_amount – количество последних комментариев в задаче из Jira, которая привязана к карточке запроса;
  • last_changes_amount – количество последних изменений в задаче из Jira, которая привязана к карточке запроса;
  • block_height – высота блока;
  • usedesk_url – адрес API Юздеска, необходимо только для коробочной версии. Значение можно уточнить в поддержке.

После внесения всех изменений нажмите «Сохранить».

Принцип интеграции

В карточке запроса дополнительный блок расположен в правой части страницы под карточкой клиента и другими дополнительными блоками (при наличии), высоту которого вы можете регулировать с помощью дополнительного параметра block_height.

Дополнительно поле, которое вы использовали для настройки, можете скрыть, без возможности редактирования (настройка в дополнительном пол) – рекомендуем!


Прикрепление задачи в карточку запроса

К карточке запроса вы можете привязать одну и более задач Jira. Связь будет отображаться в дополнительном поле из п.1. Привязать – видеть информацию по конкретной задаче (задачам) в карточке запроса. Для этого, нажмите "Связать" и заполните поле "Номер", вписав ключ задачи Jira. Например: USEDESK-3358.


Информация в дополнительном блоке карточки запроса

Информация в дополнительном блоке карточки запроса включает в себя следующую информацию и функции:

1. Кнопка "Связать", "Отвязать" – кнопки для прикрепления/удаления задачи в карточке запроса.

  • Если вы привязали одну задачу к карточке запроса, то в блоке будет отображаться карточка привязанной задачи. Чтобы отвязать задачу – нажмите кнопку "Отвязать".
  • Если вы привязали несколько задач к карточке запроса, то в блоке будет отображаться список задач. Ключ задачи в общем списке – ссылка для перехода из Юздеска в Jira (в примере – USEDESK-7726). Для перехода в карточку конкретной задачи, кликните на название. Чтобы отвязать задачу – перейдите в карточку задачи и нажмите кнопку "Отвязать";

В журнале карточки запроса пишется соответствующий лог

2. Кнопка "Назад, к списку тикетов" – для возврата в общий список задач Jira, привязанных к карточке запроса (отображается, если привязано более 1 задачи);

3. Номер и название задачи – ссылка для перехода из Юздеска в Jira, открывается в новом окне;

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

Важно! Некоторые поля могут выводится некорректно для отображения. Мы над этим работаем.

5. Последние изменения – последние изменения в задаче. Количество вы можете настроить с помощью параметра "last_changes_amount" в динамическом блоке (см. Настройка интеграции п.3);

6. Последние комментарии – последние комментарии в задаче. Количество вы можете настроить с помощью параметра "new_comments_amount" в динамическом блоке (см. Настройка интеграции п.3);

7. Кнопка "Написать комментарий" – функция, с помощью которой вы можете оставить комментарий в задаче, не переходя при этом в Jira.

В журнале карточки запроса запишется соответствующий лог.

Была ли статья полезна?

Да Нет