Метод АНАЛИТИКА.ДОБАВИТЬ
Метод ДОБАВИТЬ производит добавление объекта в план аналитики. Путь относительно типообразующего объекта берется из поля _код. При добавлении объекта можно не только перекрывать значения родительских свойств, но и добавлять новые свойства. Если задать значения в индексном поле _свойства, а затем вызвать метод ДОБАВИТЬ – свойства будут добавлены (в отличие от метода ЗАПИСАТЬ, который поддерживает только изменение значений существующих свойств). В поле _свойства можно добавлять только свойства стандартных типов и типа ССЫЛКА.
ФУНКЦИЯ ЛОГИКА: ДОБАВИТЬ(ПРАВА_ДОСТУПА: права_доступа = ПРАВА_ДОСТУПА[])
Параметры
- права_доступа
- Права доступа к добавляемому объекту. Если метод вызывается без параметров – права доступа к новому объекту устанавливаются по умолчанию: текущему пользователю, добавившему объект, разрешаются все действия, членам группы, в которую входит пользователь – чтение и редактирование, всем остальным – только чтение.
Возвращаемое значение
ДА – в случае успешного добавления, НЕТ – в случае ошибки. Ошибка возникает, в частности, если объект с указанным кодом существует (для перезаписи существующего объекта можно использовать метод ЗАПИСАТЬ).