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

Добавление служебных сотрудников

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

Сотрудник добавляется с помощью метода utils.create.

При добавлении сотрудника задаются следующие значения атрибутов:

  • employeeForIntegration — "true" с помощью метода utils.edit.
  • Только для Jira Cloud! accountId — значение accountId служебного сотрудника из Jira.

Настройка выполняется в консоли, см. Выполнение скрипта в консоли.

Пример скрипта (при создании сотрудника заполняются все обязательные атрибуты):

def createEmployee = {
utils.create('employee$employee', ['title' : 'Сотрудник для интеграции', 'accountId' : 'ABCDE12345', 
'employeeForIntegration' : 'true', 'license' : 'named', 'lastName' : 'Служебный', 'parent' : 'ou$4801', 
'login' : 'integration'])
}
api.tx.call(createEmployee)

Служебный сотрудник также может быть добавлен в интерфейсе оператора SMP.

Служебному сотруднику должны быть выданы права на добавление/редактирование объектов тех классов, которые будут участвовать в интеграции.

Создание ключа доступа для сотрудника

Для доступа служебного сотрудника к интеграции необходимо создать ключ доступа (AccessKey).

Ключ доступа для служебного сотрудника создается с помощью метода api.auth.getAccessKey.

Настройка выполняется в консоли, см. Выполнение скрипта в консоли.

Пример скрипта:

api.auth.getAccessKey('integration').uuid

Скрипт из примера позволяет сгенерировать ключ доступа на неделю. Чтобы продлить время жизни ключа, используйте метод api.auth.getAccessKey.setDeadlineDays.

Пример скрипта:

api.auth.getAccessKey('username').setDeadlineDays(days).uuid

Добавление кнопки запуска интеграции

Запуск интеграции выполняется с помощью элемента управления на карточке объекта.

В классе, объекты которого будут использоваться в интеграции, добавьте на карточку объекта пользовательский элемент управления с параметрами:

  • Название: "Отправить в Jira".
  • Внешний вид: "Кнопка с подписью".
  • Применяется к: "текущему объекту".
  • Действие: "Добавление заявки в Jira".
  • Отображать в системной панели массовых операций: флажок установлен.

Создание пользовательского элемента управления выполняется по общим правилам: