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

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

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

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

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

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

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

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

<data eof="1"/>

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

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