Admin: 1 revision imported

2021-02-07T06:51:46Z

1 revision imported

Admin at 19:52, 22 November 2020

2020-11-22T19:52:45Z

New page

{{infobox function
|name=LockStorage
|object=[[Функции общего назначения]]
|caption=Блокировка накопителей
|type=1
|status=2
|db=1
|exception=Невозможно превратить в строку, неверный накопитель, ошибка блокировки
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция производит блокировку указанного накопителя для всех пользователей сервера. Если накопитель был заблокирован другим пользователем, функция вызовет исключение. Функция вызывается автоматически при обработке документов с включенным режимом автоматической транзакции (AutoTransactionMode). Время между блокировкой и разблокировкой необходимо минимизировать, чтобы улучшить производительность базы данных. При ошибке, функция не предлагает имени пользователя, заблокировавшего накопитель, если такая информация необходима, разработчик может использовать функцию [[LockDBPath]] вместо текущей. Обычно функция используется вне модуля обработки документа. В отличие от функции [[UnlockStorage]], функция может использоваться как внутри транзакции, так и вне оной, обычно транзакцию можно начать позже, до начала записи изменений в накопители. (см. [[:Template:Транзакции|транзакции]]). Использовать эту функцию можно в случаях, когда в накопители происходит запись информации вне модуля документа. В этом случае, работа может быть построена следующим способом:
# Блокировка требуемого накопителя (или нескольких) с помощью функции [[LockStorage]]. Часто информация, попадающая в накопители, непосредственно связана с текущей информацией в них. К примеру, при списывании остатков товара на складе, перед списанием необходимо убедиться, что сальдо по остатку не станет отрицательным, и, если это такой случай, отказать в записи в накопитель. Однако, если не заблокировать накопитель до момента проверки текущего сальдо, может получиться ситуация, когда проверка покажет определенное значение, а сразу после нее, другой пользователь осуществит списание некоторого количества этого товара, программа, руководствуясь устаревшими данными, разрешит списание и на складе может остаться отрицательное количество товара, что изначально предполагалось не допустить. Блокировка до начала проверки остатков не позволяет другим пользователям производить изменения в накопителе до его разблокирования, тем самым устраняя вероятность такой ситуации. Также можно использовать функцию [[DB.ClearStorages|ClearStorages]] вместо ''LockStorage'', последняя не только производит блокировку накопителя(ей), но и очищает их движения для выбранного документа, что, возможно, предпочтительнее для выполнения проверки. Функцию ''ClearStorages'' необходимо всегда выполнять внутри транзакции.
# Выполнение требуемых проверок по корректности записываемой информации.
# Создание и заполнение таблицы для записи в накопитель ([[DB.InitStorageTab|InitStorageTab]] и пр.)
# Инициирование режима транзакции [[BeginTransaction]]
# Сохранение информации в накопитель ([[DB.SaveStorage|SaveStorage]]). Данная функция производит автоматическое блокирование накопителя, если в данный момент работает режим транзакции, однако, по соображениям, данным выше, блокировку правильнее производить заранее.
# Фиксирование транзакции с помощью функции [[CommitTransaction]]. Данная функция произведет автоматическую разблокировку накопителей, поэтому, нет необходимости вызывать [[UnlockStorage]].

Ниже дата информация по разным типам блокировки системы:

{{Типы блокировок системы}}

== Синтаксис ==
<code>
'''LockStorage'''(''<Наименование накопителя (STRING)>'')
</code>
==== Аргументы ====
* <code>''<Наименование накопителя (STRING)>''</code> - Наименование накопителя, который необходимо заблокировать

== Примеры ==
<pre>
//Фрагмент иллюстрирует описанную выше последовательность действий по записи в накопитель
//аДок -- текущий документ, в накопитель которого необходимо выполнить запись
LockStorage("Остатки");
ФлБлокировка:=1;
ФлТранзакция:=0;
Try
флПроверкаУдачна:=1;
//Далее следуют проверки, изеняющие флПроверкаУдачна
...
If not флПроверкаУдачна Then
Exit;
EndIf;

aTab:=аДок.InitStorageTab("Остатки");
//Заполнение таблицы aTab
...

//Сохранение изменений
BeginTransaction();
ФлТранзакция:=1;
аДок.SaveStorage("Остатки",aTab,аДок.DocDate);

//Фиксирование транзакции
ФлТранзакция:=0;
CommitTransaction();
ФлБлокировка:=0;

Finally
If ФлТранзакция Then
RollbackTransaction();
ElseIf ФлБлокировка Then
UnlockStorage("Остатки");
EndIf;
EndTry
</pre>

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

LockStorage - Revision history

Admin: 1 revision imported

Admin at 19:52, 22 November 2020