Мельница данных  (12.12.2025)
Принципы передачи параметров функциям RESTful-service

При вызове функций RESTful-service стандартного обмена применяются следующие принципы передачи и связывания параметров:

  1. Параметры связываются по их именам. Порядок указания параметров при вызове функции не существенен.
  2. Если вызываемый метод или отчет не является "методом класса" (является "методом объекта"), то дополнительно должен быть передан неявный параметр "ID" со значением идентификатора объекта, для которого вызывается метод или отчет.
  3. Если параметр имеет clob-доменподтипов "btHTML" (HTML-документ), "btXHTML" (XHTML-документ), то содержимое такого документа будет "обезврежено" (будут удалены ссылки, скрипты и т.п.)
  4. Если вызываемый метод имеет параметр blob-домена, но при его вызове в xml-документе не найден узел с таким именем, то будет выполнен поиск параметра с тем же именем среди параметров сессии. Если такой параметр сессии будет найден, то его значение будет передано в качестве blob-значения одноименного параметра вызываемого метода. При этом в случае, если параметр имеет blob-домен подтипа "btNamedFile" (Именованный файл), то содержимое файла будет взято из одноименного параметра сессии (например, "param1"), а имя файла будет взято из параметра сессии с именем, дополненным постфиксом ".filename" (например, "param1.filename").
  5. Если вызываемый метод имеет параметр blob-домена с подтипа "btImage" (Изображение), то для переданного значения будет предпринята попытка его преобразования в формат, заданный свойством "Расширение" домена.
  6. В других случаях переданное или найденное в параметрах сессии blob/clob значение будет передано "как есть" в качестве значения параметра при вызове метода.
  7. Если для параметра было использовано значение параметра сессии, то такой параметр удаляется из сессии после вызова функции (повторное использование параметра сессии невозможно).