Динамические шаблоны пути в интеграциях: как передавать пользовательские данные в URL через DATAREON Platform

Вот важная новость с фронта ИИ: IlyaVyaznikov 1 минуту назад Динамические шаблоны пути в интеграциях: как передавать пользовательские данные в URL через DATAREON Platform Средний 3 мин 1 Блог компании SOFROS C# * Кейс Привет, Хабр! С вами снова Илья Вязников, инженер сопровождения СОФРОС. Продолжаю делится практическими приёмами и полезными настройками платформы.

При интеграции с REST API часто возникает ситуация, когда идентификатор объекта нужно передавать не в теле запроса и не в query-параметрах, а непосредственно в URL. Например:PATCH /users/12345илиPUT /documents/987/statusТакой подход используется во многих CRM, ECM-системах, банковских и государственных API. Сегодня, разберём, как реализовать подобную интеграцию в DATAREON Platform с помощью шаблона пути и параметров обработчика.

Технические детали

Когда это может понадобитьсяНесколько типичных сценариев:Обновление контакта во внешней CRM по адресу /api/contacts/{id};Изменение статуса документа по адресу /documents/{docId}/status;Интеграция с внешними REST API, структура которых строго определена поставщиком. Во всех этих случаях путь запроса должен формироваться динамически на основе данных сообщения. Как это работает в DATAREON PlatformРассмотрим реальный пример: обработчик, который отправляет обновления пользователя во внешнюю систему.

Шаблон путиСоздадим обработчик типа «Веб-клиент». В настройках обработчика (вкладка Основные) в поле Шаблон пути указываем:/endpoint/v1/users/{id}Здесь {id} — параметр, значение которого будет подставлено при выполнении обработчика. Название параметра должно совпадать с именем параметра обработчика.

Регистр символов также имеет значение. (можно использовать userId, externalId, documentNumber и т. Объявление параметраПереходим на вкладку Параметры обработчика и добавляем параметр:Наименование: idТип: int (или string, в зависимости от внешней системы)Если параметр используется в шаблоне пути веб-обработчика расширенного REST API, необходимо пометить его как обязательный.

Отраслевые последствия

При отсутствии значения платформа не сможет корректно сформировать URL и вернет ошибку. После этого параметр станет доступен в коде обработчика и при вызове из бизнес-процесса. Присвоение значения параметруЗдесь есть два удобных варианта.

Вариант А - из типа данных. Если идентификатор уже присутствует в сообщении, можно присвоить его в коде обработчика: На вкладке Код обработчика пишем простое присвоение:id = Ваш_Тип_Данных. id; // или externalId, userId и т.

В результате при выполнении обработчика значение будет подставлено в URL. Вариант Б - напрямую из бизнес-процессаЕсли нужного поля нет в типе данных или значение формируется динамически на этапе процесса, его можно передать в локальную переменную обработчика при вызове шага отправки из бизнес-процесса. Для примера покажу передачу id из InitMessage:В блоке Отправка указываем обработчик, в котором создана переменная id.

Событие, по словам экспертов, усилит конкуренцию в сфере ИИ.