Руководство разработчика

Метод АНАЛИТ_ОБЪЕКТ. ДОБАВИТЬ_ПАРАМ

Метод ДОБАВИТЬ_ПАРАМ производит добавление объекта в план аналитики и передает параметры модификации серверным алгоритмам добавления объекта. Путь относительно типообразующего объекта берется из поля _код. При добавлении объекта можно не только перекрывать значения родительских свойств, но и добавлять новые свойства. Если задать значения в индексном поле _свойства, а затем вызвать метод ДОБАВИТЬ_ПАРАМ – свойства будут добавлены (в отличие от метода ЗАПИСАТЬ_ПАРАМ, который поддерживает только изменение значений существующих свойств). В поле _свойства можно добавлять только свойства стандартных типов и типа ССЫЛКА.

ФУНКЦИЯ ЛОГИКА: ДОБАВИТЬ_ПАРАМ(ПЕРЕМ МОДИФ_ПАРАМ: парам; 
                    ПРАВА_ДОСТУПА: права_доступа = ПРАВА_ДОСТУПА[])

Параметры

парам
Параметры модификации.
права_доступа
Права доступа к создаваемому объекту. Если метод вызывается без параметров – права доступа к новому объекту устанавливаются по умолчанию: текущему пользователю, добавившему объект, разрешаются все действия, членам группы, в которую входит пользователь – чтение и редактирование, всем остальным – только чтение.

Возвращаемое значение

ДА – в случае успешного добавления, НЕТ – в случае ошибки. Ошибка возникает, в частности, если объект с указанным кодом существует (для перезаписи существующего объекта следует использовать метод ЗАПИСАТЬ_ПАРАМ).


См. также: