Добавить

Добавляет в базу данных запись указанного объекта.

Синтаксис

Добавить( Объект )

Параметры

Объект
(объект) – объект, запись которого будет добавлена в базу данных. Эта запись обязательно должна быть вновь созданной (например, функциями «Объект(ИмяТаблицы)» или «Выборка») или проинициализирована функцией «Очистить». Если запись, переданная функции, была извлечена из базы данных, то ничего делаться не будет.

Возвращает

1 – запись успешно добавлена.

0 – запись указанного объекта не была добавлена.

Примеры

Так можно программно добавить в базу данных запись об организации:

оОрг = Выборка( ”Организации” );

оОрг.Название = ”Чудо”;

оОрг.Наименование = ”ЗАО Чудо”;

оОрг.ИНН = ”7714123412”;

Корень( оОрг );

Добавить( оОрг ); # добавляем запись об организации

Как уже говорилось,  добавляемая запись обязательно должна быть вновь созданной. То есть, если в правиле операции написать:

Добавить( Документ );

то новый документ не будет добавлен.

Добавить строку в некоторый текстовый лог-файл:

объект оЛог = Объект( ”C:\\sbis\\sbis_log.txt” );

оЛог.Строка = ТекДат+” ”+ТекВремя+” Запущен расчет…”;

Добавить( оЛог );

Обратите внимание, что если нужно добавить подряд несколько записей, то каждый раз перед добавлением новой записи необходимо проинициализировать добавляемый объект функцией «Очистить». А уже после этого можно установить значения полей и вызвать «Добавить». Например, добавить две строки в лог-файл:

объект оЛог = Объект( ”C:\\sbis\\sbis_log.txt” );

оЛог.Строка = ТекДат+” ”+ТекВремя;

Добавить( оЛог );

Очистить( оЛог ); # без этой строки работать не будет!

оЛог.Строка = ”Запущен расчет…”;

Добавить( оЛог );


Похожие статьи