Использование специальных функций

В REST API интегрируемой системы данные могут быть представлены таким образом, что их невозможно напрямую поставить в соответствие данным REST API Devprom ALM. Например, в интегрируемой системе значение может находиться в списке, а для Devprom ALM требуется скалярное значение. В этом случае можно использовать специальные функции.

Отфильтровать элементы коллекции
"ChangeRequest": {
      "ExternalId": "relations:(rel=System\\.LinkTypes\\.Hierarchy-Reverse).url"
}

В этом примере, в атрибут ExternalId у сущности ChangeRequest будет записано значение из поля url для объекта из коллекции relations, у которого значение атрибута rel равно "System.LinkTypes.Hierarchy-Reverse".

Взять конкретный элемент коллекции
"ChangeRequest": {
      "ExternalId": "relations:first.url"
}

В этом примере, в атрибут ExternalId у сущности ChangeRequest будет записано значение из поля url для первого объекта из коллекции relations. Вместо ключевого слова first можно использовать число, явно указывающее на позицию элемента в коллекции.

Преобразовать коллекцию в строку
"GitlabLabels": "join(labels)"

В этом примере, в атрибут GitlabLabels будет записана строка, в которой через запятую перечислены метрки задачи в Gitlab.