Мельница данных  (17.11.2025)
Функция setpropvalue

Функция setpropvalue позволяет изменять значения свойств объектов, доступные для изменения через обработчик сервера приложений.

Допустимое расширение: .xml.

В значении параметра с именем "query" необходимо передать xml-документ, содержащий один элемент setpropvalue с атрибутами, позволяющими идентифицировать объект и принадлежащее ему свойство, значение которого требуется изменить. Значение, которое должно быть установлено для свойства, передается как текст элемента setpropvalue Этот параметр можно передавать, обращаясь к url как методом GET, так и методом POST. Значение параметра должно быть закодировано по правилам представления url.

Атрибуты элемента setpropvalue:

  • ID (обязательный) - идентификатор объекта, свойство которого должно быть изменено
  • class (обязательный, если не указан атрибут "propid") - имя класса, свойство которого должно быть изменено
  • propname (обязательный, если не указан атрибут "propid") - имя свойства, принадлежащего классу, переданному значением атрибута "class", значение которого должно быть изменено
  • propid (обязательный, если не указаны атрибуты "class" и "propname") - идентификатор свойства, значение которого должно быть изменено
  • noanalyze

Для передачи информации о свойстве, значение которого должно быть изменено, можно использовать атрибут "propid" или пару атрибутов "class" и "propname".

Пример
1<setpropvalue ID="4912468" class="TPerson" propname="MiddleName">
2  Алексеевич
3</setpropvalue>
Установить значение "Алексеевич" для свойства класса "TPerson" с именем "MiddleName" для объекта с идентификатором "4912468".

При успешном выполнении функция возвращает xml-документ с пустым набором данных:

<data eof="1"/>

При неуспешном выполнении функция возвращает xml-документ с текстом сообщения об ошибке, например:

1<error>
2  <message>Property not found.</message>
3  <className>Exception</className>
4</error>