Настройка соответствия атрибутов

Описание действия

В рамках соответствия типов необходимо настроить соответствие атрибутов объекта SMP атрибутам в Jira. Соответствие атрибутов привязано к конкретному соответствию типов объектов.

В системе существует три вида соответствия атрибутов:

  • Соответствие простых атрибутов — преобразует простые атрибуты (строки, числа, текстовые атрибуты), а также служит для отправки файлов или комментариев. Значение передается из атрибута в атрибут "как есть".

    Особенности для некоторых атрибутов:

    • Текст RTF — при отправке в Jira стираются html теги (Jira использует свой язык разметки).

    • Даты:

      • при отправке в Jira выполняется преобразование format("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'");
      • при получении из Jira — parse('yyyy-MM-dd', *).
    • Комментарий — отправляется только текст без форматирования.
    • Файл — в Jira есть только один файловый атрибут, поэтому не рекомендуется использовать более одного правила соответствия на файловые атрибуты.

  • Соответствие ссылочных атрибутов — используется для преобразования атрибутов типа "Ссылка на бизнес-объект" или "Набор ссылок на бизнес-объект" ("Элемент справочника" или "Набор элементов справочника"), для которых есть общий идентификатор в обеих системах.

    Некоторые значения идентификатора:

    • для сотрудников — логин/accountId;
    • для справочных атрибутов — значение атрибута (value).

  • Табличное соответствие атрибутов — используется для преобразования атрибутов типа "Ссылка на бизнес-объект" или "Набор ссылок на бизнес-объект" ("Элемент справочника" или "Набор элементов справочника"), значение идентификатора которых можно преобразовать по таблице. Указываются те же параметры, что и для ссылочных атрибутов, далее идентификатор будет преобразован по указанной таблице соответствий.

    Табличное соответствие используется для передачи статусов при условии, что их идентификаторы совпадают.

Место выполнения действия

Карточка соответствия типов объектов, вкладка "Соответствия атрибутов".

Выполнение действия

На вкладке "Соответствия атрибутов" нажмите иконку "Добавить", заполните поля формы и нажмите Сохранить.

Сначала выберите тип соответствия.

Параметры соответствия простых атрибутов:

  • Атрибут из Naumen.
  • Атрибут в Jira.

Параметры соответствия ссылочных атрибутов:

  • Атрибут в Naumen — ссылочный атрибут объекта, который будет использоваться в интеграции. Атрибут ссылается на объект другого класса. Например, атрибут "Автор" объекта класса "Запрос" (serviceCall) ссылается на объект класса "Сотрудник" (employee).
  • Атрибут ссылочного объекта Naumen — атрибут объекта другого класса. Например, атрибут класса "Сотрудник" (employee).

  • Атрибут в Jira — атрибут заявки в Jira, который ссылается на другую сущность. Например, на проект или на сотрудника.

  • Атрибут ссылочного объекта Jira — атрибут другой сущности (проекта/сотрудника) из Jira.

    Возможные значения:

    • id — внутренний идентификатор в Jira, присущий любому объекту.
    • email — email пользователя. По этому атрибуту нельзя передать пользователя в Jira.
    • ФИО — ФИО пользователя. По этому атрибуту нельзя передать пользователя в Jira.
    • Код проекта/тикета (key).
    • Значение справочника (value).
    • Название/логин (name).
    • Только для Jira Cloud! account ID — accountId сотрудника в Jira.

Параметры табличного соответствия атрибутов:

  • Атрибут в Naumen — ссылочный атрибут объекта, который будет использоваться в интеграции. Атрибут ссылается на объект другого класса. Например, атрибут "Автор" объекта класса "Запрос" (serviceCall) ссылается на объект класса "Сотрудник" (employee).
  • Атрибут объекта из Naumen — атрибут объекта другого класса. Например, атрибут класса "Сотрудник" (employee).
  • Таблица соответствия — ссылка на таблицу, по которой будет выполняться преобразование.

  • Атрибут в Jira — атрибут заявки в Jira, который ссылается на другую сущность. Например, на проект или на сотрудника.

  • Атрибут ссылочного объекта Jira — атрибут другой сущности (проекта/сотрудника) из Jira.

    Возможные значения:

    • id — внутренний идентификатор в Jira, присущий любому объекту.
    • email — email пользователя. По этому атрибуту нельзя передать пользователя в Jira.
    • ФИО — ФИО пользователя. По этому атрибуту нельзя передать пользователя в Jira.
    • Код проекта/тикета (key).
    • Значение справочника (value).
    • Название/логин (name).
    • Только для Jira Cloud! account ID — accountId сотрудника в Jira.

Результат действия

На карточке соответствия типов отобразятся настроенные соответствия атрибутов.

Примеры настройки