Jira

Jira — программа для планирования и контроля проектов. Благодаря интеграции работать с задачами Jira можно напрямую из Юздеска: создавать их прямо из карточки запроса, отслеживать последние изменения, привязывать к запросам уже существующие задачи.


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

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


Укажите заголовок поля «Jira», снимите галочки с чекбоксов «Присваивать тег» и «Создать как фильтр» и поставьте галочку в чекбоксе «Нельзя редактировать». Затем нажмите «Сохранить».


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

  • Имя – Jira;
  • Заголовок – Jira;
  • Содержание блока — оставьте поле пустым;
  • URL – заполните поле значением https://jiranew-integrations.usedesk.ru/api;
  • Включен – выберите чекбокс для активации блока;
  • Параметры (POST) – нажмите «Добавить параметр» и переходите к п. 3.


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

Если у вас коробочная версия:

  • jira_username – логин суперадмина в Jira (рекомендуем сделать отдельного суперадмина с логином «UsedeskBot»);
  • jira_secret – пароль аккаунта Jira, имя пользователя которого вы указали в поле jira_username (обязательный параметр);
  • usedesk_token – API токен. Как создать API канал и найти его токен написали тут;
  • jira_domain – домен Jira. Писать с https:// (обязательный параметр);
  • usedesk_field_id – ID дополнительного поля из п. 1 (обязательный параметр);
  • project — если указать key проектов, задачи можно будет создавать только в них. Например: «MAIN», «SALES», «SUPP» Если параметр не используется, задачи можно будет создать в любом проекте.


Если у вас облачная версия:

  • jira_username – e-mail суперадмина в Jira (рекомендуем сделать отдельного суперадмина с логином «UsedeskBot»);
  • jira_secret – токен Jira. О том, как его получить, читайте здесь;
  • usedesk_token – API токен. Как создать API канал и найти его токен написали тут;
  • jira_domain – домен Jira. Писать с https:// (обязательный параметр);
  • usedesk_field_id – ID дополнительного поля из п. 1 (обязательный параметр);
  • project — если указать key проектов, задачи можно будет создавать только в них. Например: «MAIN», «SALES», «SUPP» Если параметр не используется, задачи можно будет создать в любом проекте.


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


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

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



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

Создавать задачи Jira можно напрямую из карточки запроса. Для этого нажмите кнопку «Создать», заполните появившиеся поля и снова нажмите на «Создать».

Важные нюансы:

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


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

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


Блок Jira в карточке запроса: общая информация

Дополнительный блок карточки запроса Jira включает в себя следующее:

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

Если вы привязали одну задачу к карточке запроса, в блоке будет отображаться карточка привязанной задачи.


Если вы привязали несколько задач к карточке запроса, в блоке будет отображаться список задач. Ключ задачи в общем списке – ссылка для перехода из Юздеска в Jira (в примере – DEMO-125). Для перехода в карточку конкретной задачи кликните на её название (в примере — 211212). Чтобы отвязать задачу – перейдите в карточку задачи и нажмите кнопку «Отвязать».


Все логи по созданию, прикреплению и удалению задач Jira отображаются в карточке запроса в виде внутренних комментариев:


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


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


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


5. Изменения – история изменений в задаче. Для удобства можно использовать сортировку: отображать сначала либо последние, либо старые изменения.


6. Раздел «Комментарии» отображает все комментарии к задаче. Для удобства комментарии можно сортировать по дате создания: отображать первыми либо старые, либо новые.


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


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

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

Да Нет