Jira

Назначение

Интеграция предназначена для настройки обмена данными об объектах между SMP и Jira, через интерфейс оператора SMP​.

Минимальная поддерживаемая версия Jira — 8.17.1.

Интеграция и условия ее получения предоставляется по запросу в клиентский сервис ITSM 365.

Объекты интеграции

Основная SMP — инсталляция SMP, в которой работает организация.

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

Приложение бывает двух видов:

• Jira Cloud — данные расположены в облачном хранилище;
• Jira Server — данные расположены на локальном сервере.

Некоторые настройки интеграции различаются для Jira Cloud и Jira Server, различия выделены в документации. В общем случае для Jira Cloud и Jira Server используется обозначение "Jira".

Описание интеграции

Настройка интеграции позволяет реализовать следующие варианты взаимодействия:

• Регистрация запроса в SMP из JIRA.
• Создание заявки в JIRA из SMP.
• Двухсторонняя синхронизация атрибутов запроса/заявки.
• Двухсторонняя передача комментариев и файлов, прикрепленных к запросу/заявке.

Особенности работы с запросами/заявками, комментариями и файлами:

• Запросы, комментарии и файлы, добавленные в SMP суперпользователем, не передаются в Jira.
• Заявки, комментарии и файлы, добавленные в Jira пользователем, accountId (логин) которого используется для служебного сотрудника в SMP, не обрабатываются в SMP.
• Заявки и комментарии, добавленные в Jira пользователем, которого нет в SMP, добавляются в SMP от лица суперпользователя.

Особенности поведения атрибутов:

• Соответствие для атрибутов типа "Гиперссылка", "Логический" не поддерживается.
• Значение атрибута типа "Текст в формате RTF" передается в Jira без форматирования и без картинок.
• Картинка, добавленная в описании заявки в Jira, отображается в описании запроса в SMP в виде текста, например: !пр2.png|width=799,height=586!. Сама картинка добавляется в список файлов запроса.

• Форматирование текста из Jira (ADF/Markdown) не поддерживается в SMP.

  Например, текст, выделенный в Jira жирным и красным, будет отображаться в атрибуте типа "Текст в формате RTF" SMP в виде строки: {color:#ff5630}*_жирный красный текст_* {color}.

• Использование в интеграции меток из Jira не поддерживается.

Лист изменений модуля интеграции

• Лист изменений

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

Настройка интеграции в веб-интерфейсе SMP:

• В интерфейсе администратора:

  • загружаются модули интеграции (метаинформация), включая объектную модель интеграции:

    • Загрузка метаинформации для интеграции с Jira

  • выполняется настройка объектной модели интеграции:

    • Объектная модель интеграции с Jira

  • выполняется настройка интеграции на стороне SMP:

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

• В интерфейсе оператора выполняется настройка соответствия объектов SMP и Jira, участвующих в интеграции:

  • Настройка интеграции с Jira в интерфейсе оператора

Так же необходима предварительная настройка интеграции на стороне Jira.

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