Admin: 1 revision imported

2021-02-07T06:43:20Z

1 revision imported

Admin: Created page with "{{infobox function |name=New |object=Объект базы данных |caption=Создание нового несохраненного объекта |type=1 |status=..."

2019-09-25T11:29:23Z

Created page with "{{infobox function |name=New |object=Объект базы данных |caption=Создание нового несохраненного объекта |type=1 |status=..."

New page

{{infobox function
|name=New
|object=[[Объект базы данных]]
|caption=Создание нового несохраненного объекта
|type=1
|status=2
|db=2
|exception=Невозможно превратить в число, не объект БД, неверный объект БД, ошибка сервера
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Объект базы данных]]}}
Функция создает новый элемент справочника или документ, для которых можно указать основание, новый объект может быть скопирован из существующего. Функция последовательно выполняет следующие действия:
* Объект очищается от всех существующих реквизитов и строчных частей, создаются пустые реквизиты и пустые строчные части.
* При наличии заданных для объекта реквизитов-нумераторов, заполняемых при создании объекта, на сервер отсылается запрос о создании временных значений нумераторов
* Сервер создает временные уникальные значения нумераторов, помещает их в таблицу временных нумераторов для хранения (нумераторы, принадлежащие объекту, удаляются из таблицы при успешном сохранении объекта (фиксировании этих нумераторов в базе данных), либо удалении объекта до его сохранения). Сервер возвращает значения этих нумераторов, клиент обновляет реквизиты объекта этими значениями.
* При наличии аргумента ''объект, для копирования реквизитов'', система производит заполнение реквизитов и строчных частей текущего объекта из указанного объекта, пропуская или включая реквизиты-нумераторы (в зависимости от значения третьего аргумента).

== Синтаксис ==
<code>
{{Grey|DB.}}'''New'''({{Optional|<Новая папка (INT)>{{Default|{{Eq}}0}},<Объект, для копирования реквизитов (DB)>,<Также копировать нумераторы (INT)>{{Default|{{Eq}}0}},<Объект-основание (DB)>}})
</code>

==== Аргументы ====
* <code>''<Новая папка (INT)>''</code> - {{Optional}} Для элементов справочника, будет создана новая папка (1) или новый элемент (0, по умолчанию). Для документов этот аргумент не используется.
* <code>''<Объект, для копирования реквизитов (DB)>''</code> - {{Optional}} Параметр задает объект реквизиты и строчные части которого будут скопированы в текущий объект при создании. По умолчанию, новый объект создается с пустыми реквизитами и строчными частями.
* <code>''<Также копировать нумераторы (INT)>''</code> - {{Optional}} Задает режим копирования реквизитов из ''объекта, для копирования реквизитов'', когда в список копируемых реквизитов включаются также нумераторы (1), либо не включаются нумераторы (0, по умолчанию). Включение нумераторов не рекомендуется, так как можно получить объект, который невозможно будет сохранить из-за нарушения уникальности значений реквизитов-нумераторов, имеющих проверку уникальности.
* <code>''<Объект-основание (DB)>''</code> - {{Optional}} Параметр задает объект-основание текущего объекта. Это произвольный объект, который будет доступен посредством функции [[DB.FounderObject|FounderObject]]. В момент визуального открытия нового объекта для редактирования, подразумевается, что программа обработки события ''OnOpen'' или ''OnNew'' будет использовать эту функцию для заполнения реквизитов нового объекта, зависящих от объекта-основания.

== Примеры ==
<pre>
//Пример создает новый несохраненный объект аЭл, заполняет его реквизиты и сохраняет его в базе данных
аЭл:=Ref.Улицы;
//Создаем папку или элемент, в зависимости от флага флПапка
аЭл.New(флПапка);
//аГород -- объект-владелец текущего
аЭл.Parent(аГород);
//аПапка -- папка, в которую помещается новая папка
If аПапка<>0 Then
аЭл.Folder(аПапка);
EndIf;

//Заполняем реквизиты
аЭл.Name:=аНаменование;
аЭл.ВнешнийКод:=аВнешнийКод;

//Сохраняем новый объект
аЭл.Save();
</pre>

← Older revision	Revision as of 06:43, 7 February 2021
(No difference)

DB.New - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=New |object=Объект базы данных |caption=Создание нового несохраненного объекта |type=1 |status=..."