Особенности и примеры использования различных типов URL параметров

Во всех случаях значения подставляемых в итоговый URL параметров берутся из таблицы, подаваемой на входной порт Источник данных запроса узла REST-запрос, использующего данное подключение. Для каждой строки этой таблицы формируется отдельный запрос к REST-сервису. Если входная таблица содержит несколько строк, то узел REST-запрос выполнит несколько запросов — по одному запросу для каждой строки.

Использование типа URL параметров Строка запроса

В данном случае параметры добавляются в строку запроса URL — часть адреса после символа ?, в которой значения передаются в виде пар имя=значение, разделённых символом &.

Пример:

Настройка узла:

• URL сервиса: http://example.com
• Тип URL параметров: Строка запроса
• Таблица параметров:

Пример сформированного URL: http://example.com?department=value1&employee_id=value2&request_date=value3

Таблица, подаваемая на входной порт Источник данных запроса узла REST-запрос:

Итоговые URL запросов, формируемых узлом REST-запрос:

• http://example.com?department=sales&employee_id=17&request_date=2026-03-10
• http://example.com?department=support&employee_id=25&request_date=2026-04-21
• http://example.com?department=hr&employee_id=31&request_date=2026-05-05

Использование типа URL параметров Добавление сегментов

В данном случае значения параметров добавляются в Путь URL в виде отдельных сегментов — частей адреса, разделённых символом /, например: http://example.com/sales/17/2026-03-10, где sales, 17 и 2026-03-10 — отдельные сегменты Пути.

Пример:

Настройка узла:

• URL сервиса: http://example.com
• Тип URL параметров: Добавление сегментов
• Таблица параметров:

Пример сформированного URL: http://example.com/value1/value2/value3

Таблица, подаваемая на входной порт Источник данных запроса узла REST-запрос:

Итоговые URL запросов, формируемых узлом REST-запрос:

• http://example.com/sales/17/2026-03-10
• http://example.com/support/25/2026-04-21
• http://example.com/hr/31/2026-05-05

Использование типа URL параметров Замена

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

Для корректного выделения параметров из строки URL сервиса они должны быть указаны в ней с учетом следующих правил:

• использование специального синтаксиса :<имя_параметра> (символ двоеточия : перед именем параметра);
• в именах параметров могут быть использованы символы латинского алфавита, цифры (кроме первого символа) и знак подчеркивания.

Примечание: Процесс выделения параметра из строки URL сервиса считается законченным, как только встречается символ, не удовлетворяющий этим правилам.

В заполненной Таблице параметров запроса можно задать/изменить Тип данных параметров.

Примечание: Путь в URL-адресе — это часть URL после имени хоста и до символа ?, а Строка запроса — часть URL после символа ?, в которой значения передаются в виде пар имя=значение, разделённых символом &. Например, для адреса http://example.com/orders/125?department=sales&request_date=2026-03-10:

• Путь — /orders/125;
• Строка запроса — department=sales&request_date=2026-03-10.

Параметры могут быть добавлены в Путь и Строку запроса. Например:

• http://example.com/path/:department/subpath/:employee_id/...
• http://example.com?dep=:department&id=:employee_id
• http://example.com?:department=:employee_id

Параметры также могут находиться в одном и том же сегменте Пути или аргументе Строки запроса. Например:

• http://example.com/:department:employee_id:request_date/...
• http://example.com?:department:employee_id=:request_date

Если в строке URL несколько параметров с одинаковым именем, то в Таблицу параметров будет добавлен только один параметр. При выполнении узла REST-запрос все такие вхождения будут заменены одинаковым значением.

На странице мастера настройки REST-сервиса поле URL сервиса может быть задано управляющей переменной. В режиме Замена параметры берутся из строки URL сервиса и помещаются в Таблицу ниже при выполнеии действия (нажатии кнопки) Получить URL параметры запроса. Если значение управляющей переменной изменится, новые параметры автоматически в Таблицу не добавляются. Для повторного получения параметров необходимо снова выполнить действие Получить URL параметры запроса.

Пример:

Настройка узла:

• URL сервиса: http://example.com/:department/:employee_id?date=:request_date
• Тип URL параметров: Замена
• Таблица параметров: выбрано Получить URL параметры запроса и заданы соответствующие типы данных.

Пример сформированного URL: http://example.com/value1/value2?date=value3

Таблица, подаваемая на входной порт Источник данных запроса узла REST-запрос:

Итоговые URL запросов, формируемых узлом REST-запрос:

• http://example.com/sales/17?date=2026-03-10
• http://example.com/support/25?date=2026-04-21
• http://example.com/hr/31?date=2026-05-05