DB.Save - Revision history

Admin: 1 revision imported

2022-11-18T09:36:27Z

1 revision imported

1>Admin at 14:58, 4 October 2022

2022-10-04T14:58:30Z

Admin: 1 revision imported

2021-11-20T17:03:54Z

1 revision imported

1>Admin at 07:10, 7 August 2021

2021-08-07T07:10:09Z

Admin: 1 revision imported

2021-02-07T06:43:21Z

1 revision imported

Admin at 11:21, 30 October 2020

2020-10-30T11:21:22Z

New page

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

== Синтаксис ==
<code>
{{Grey|DB.}}'''Save'''({{Optional|<Режим сохранения периодических реквизитов (INT)>,<Заблокировать объект после сохранения (INT)>{{Default|{{Eq}}0}}}})
</code>

==== Аргументы ====
* <code>''<Режим сохранения периодических реквизитов (INT)>''</code> - {{Optional}} Режим определяет, будут ли загруженные периодические реквизиты сохранены при сохранении самого объекта. Если объект является визуальным объектом открытым в режиме изменения, этот параметр всегда будет равен 1, иначе по умолчанию этот параметр равен 0.
* <code>''<Заблокировать объект после сохранения (INT)>''</code> - {{Optional}} Параметр определяет будет ли сохранена временная блокировка объекта после удачной записи. Если объект был заблокирован до записи, при любом значении этого аргумента, блокировка не будет снята. Так как в момент записи, объект, если он не был заблокирован, блокируется временной блокировкой, сохранение блокировки после записи имеет гарантированный успех. Параметр удобно использовать для блокировки новых объектов после записи, чтобы продолжать работать с ними, так как новый несохраненный объект еще не имеет внутренного кода базы данных и поэтому не может быть заблокирован.

== Примеры ==
<pre>
//Пример производит блокировку и изменение документа аДок
аПольз:="";аМаш:="";аВремя:="";
If аДок.Lock(аПольз,аМаш,аВремя)=0 Then
Message("Невозможно заблокировать документ "+аДок+", так как в данный момент с ним работает пользователь "+аПольз+" на "+аМаш+" в "+аВремя+"!","!");
Exit;
EndIf;
Try
//Перечитать аДок из базы данных, чтобы убедиться, что мы работаем со свежими данными и наше изменение не запишет устаревшие данные в базу данных
аДок.Reload();
//Изменим реквизит и сохраним объект
аДок.Реквизит:=1;
аДок.Save();
Finally
аДок.Unlock();
EndTry;
</pre>

← Older revision	Revision as of 09:36, 18 November 2022
(No difference)

@@ Line 28: / Line 28: @@
 == Синтаксис ==
 <code>
-{{Grey|DB.}}'''Save'''({{Optional|<Режим сохранения периодических реквизитов (INT)>,<Заблокировать объект после сохранения (INT)>{{Default|{{Eq}}0}}}})
+{{Grey|DB.}}'''Save'''({{Optional|<Режим сохранения периодических реквизитов (INT)>,<Заблокировать объект после сохранения (INT)>{{Default|{{Eq}}0}},<Элемент для изменения триггера или значение триггера (DB,INT)>}})
 </code>
@@ Line 34: / Line 34: @@
 * <code>''<Режим сохранения периодических реквизитов (INT)>''</code> - {{Optional}} Режим определяет, будут ли загруженные периодические реквизиты сохранены при сохранении самого объекта. Если объект является визуальным объектом открытым в режиме изменения, этот параметр всегда будет равен 1, иначе по умолчанию этот параметр равен 0.
 * <code>''<Заблокировать объект после сохранения (INT)>''</code> - {{Optional}} Параметр определяет будет ли сохранена временная блокировка объекта после удачной записи. Если объект был заблокирован до записи, при любом значении этого аргумента, блокировка не будет снята. Так как в момент записи, объект, если он не был заблокирован, блокируется временной блокировкой, сохранение блокировки после записи имеет гарантированный успех. Параметр удобно использовать для блокировки новых объектов после записи, чтобы продолжать работать с ними, так как новый несохраненный объект еще не имеет внутренного кода базы данных и поэтому не может быть заблокирован.
 == Примеры ==

← Older revision	Revision as of 17:03, 20 November 2021
(No difference)

@@ Line 23: / Line 23: @@
 * Если предусмотрено установками, создается соответствующая запись в таблице журнала регистрации событий.
 * Если объект был заблокирован до записи, блокировка сохраняется. Если новый объект открыт для визуального редактирования или новый или существовавший объект имеет опцию ''заблокировать объект после сохранения'', блокировка сохраняется. В иных случаях, временная блокировка снимается.
-* Сервер возвращает клиенту информацию по внутреннему коду объекта (для новых объектов) и номерам незаполненных реквизитов-нумераторов, эта информация принимается клиентом, которой обновляет ей содержимое реквизитов и строчных частей объекта, если объект открыт для визуального редактирования, также обновляются визуальные поля реквизитов-нумераторов.
+* Сервер возвращает клиенту информацию по внутреннему коду объекта (для новых объектов) и номерам незаполненных реквизитов-нумераторов, эта информация принимается клиентом, который обновляет ей содержимое реквизитов и строчных частей объекта, если объект открыт для визуального редактирования, также обновляются визуальные поля реквизитов-нумераторов.
 * С объекта снимается признак ''изменен'' и, если он был открыт для редактирования в визуальной форме, с последней также снимается признак ''были изменения''.

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