http://sfsys.ru/index.php?action=history&feed=atom&title=DB.LockDB.Lock - Revision history2026-04-04T16:52:26ZRevision history for this page on the wikiMediaWiki 1.31.1http://sfsys.ru/index.php?title=DB.Lock&diff=442&oldid=prevAdmin: 1 revision imported2021-02-07T06:43:20Z<p>1 revision imported</p>
<table class="diff diff-contentalign-left" data-mw="interface">
<tr class="diff-title" lang="en">
<td colspan="1" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="1" style="background-color: #fff; color: #222; text-align: center;">Revision as of 06:43, 7 February 2021</td>
</tr><tr><td colspan="2" class="diff-notice" lang="en"><div class="mw-diff-empty">(No difference)</div>
</td></tr></table>Adminhttp://sfsys.ru/index.php?title=DB.Lock&diff=441&oldid=prevAdmin at 17:17, 22 September 20192019-09-22T17:17:31Z<p></p>
<p><b>New page</b></p><div>{{infobox function<br />
|name=Lock<br />
|object=[[Объект базы данных]]<br />
|caption=Блокировка объекта базы данных<br />
|type=1<br />
|status=2<br />
|db=1<br />
|exception=Неподходящий объект<br />
|visual=0}}<br />
{{HeadLinks|<br />
* [[Main_Page|Начальная страница]]<br />
* [[Общее_описание_языка|Общее описание]]<br />
* [[Объекты]]<br />
* [[Объект базы данных]]}}<br />
Функция производит попытку блокировки текущего выбранного объекта, объект не может быть новым несохраненным объектом БД. Если попытка неудачна, функция возвратит, если необходимо, имя пользователя, заблокировавшего объект, время его блокировки и машину, на которой он был заблокирован. Функцию удобно использовать перед изменением и сохранением объекта. В случае, когда требуется, чтобы новый несохраненный объект был заблокирован непосредственно после первого сохранения, необходимо использовать возможности функции [[DB.Save|Save]]. Функция может применяться для блокировки только элементов справочников и документов. К примеру, невозможно произвести блокировку строки строчной части объекта, так как строка не является самостоятельным объектом. Блокировка объектов журналов также не допускается, вместо такой блокировки необходимо использовать блокировку объекта, на который ссылается объект журнала, иначе получилась бы ситуация, что заблокированный объект журнала при сохранении должен обновить оригинальный объект, однако, последний заблокирован другим пользователем. Блокировка автоматически снимается с объекта, когда происходит его позиционирование (к примеру, другой объект выбирается с помощью функции [[DB.Find|Find]] или [[DB.Select|Select]]), либо его удалением из системы. При визуальной работе пользователя система автоматически использует такой же механизм блокировки, поэтому, визуально открытый для редактирования объект невозможно заблокировать второй раз. При сохранении объекта или обработке документа, его не происходит его разблокировки. Функция [[DB.Reload|Reload]] также не снимает блокировки с объекта. При блокировке объекта в совокупности с транзакцией нужно понимать, что отмена транзакции не возвратит автоматически блокировку объекта, если он был разблокирован внутри транзакции. Ниже дана таблица, перечисляющая разнообразные типы блокировок системы:<br />
{{Типы блокировок системы}}<br />
<br />
== Синтаксис ==<br />
<code><br />
{{Grey|DB.}}'''Lock'''({{OptionalByRef|<Заблокировано пользователем (STRING)>,<Заблокировано на машине (STRING)>,<Время блокировки (DATE)>}}):''<Успешная блокировка (INT)>''<br />
</code><br />
<br />
==== Аргументы ====<br />
* <code>''<Заблокировано пользователем (STRING)>''</code> - {{Optional}}{{ByRef}} Аргумент-переменная, содержимое которой заполняется именем пользователя, который заблокировал данный объект, в случае, если блокировку невозможно произвести по причине того, что объект был заблокирован ранее. Если аргумент опущен, информация по блокировке не будет получена.<br />
* <code>''<Заблокировано на машине (STRING)>''</code> - {{Optional}}{{ByRef}} Аргумент-переменная, содержимое которой заполняется наименованием компьютера, на которым произошла блокировка данного объекта, в случае, если блокировку невозможно произвести по причине того, что объект был заблокирован ранее. Если аргумент опущен, информация по блокировке не будет получена.<br />
* <code>''<Время блокировки (DATE)>''</code> - {{Optional}}{{ByRef}} Аргумент-переменная, содержимое которой заполняется датой и временем, когда был заблокирован данный объект, в случае, если блокировку невозможно произвести по причине того, что объект был заблокирован ранее. Если аргумент опущен, информация по блокировке не будет получена.<br />
<br />
==== Возвращаемое значение ====<br />
Функция возвращает единицу, если блокировка произведена успешно, 0 в ином случае.<br />
<br />
== Примеры ==<br />
<pre><br />
//Пример производит блокировку и изменение документа аДок<br />
аПольз:="";аМаш:="";аВремя:="";<br />
If аДок.Lock(аПольз,аМаш,аВремя)=0 Then<br />
Message("Невозможно заблокировать документ "+аДок+", так как в данный момент с ним работает пользователь "+аПольз+" на "+аМаш+" в "+аВремя+"!","!");<br />
Exit;<br />
EndIf;<br />
Try<br />
//Перечитать аДок из базы данных, чтобы убедиться, что мы работаем со свежими данными и наше изменение не запишет устаревшие данные в базу данных<br />
аДок.Reload();<br />
//Изменим реквизит и сохраним объект<br />
аДок.Реквизит:=1;<br />
аДок.Save();<br />
Finally<br />
аДок.Unlock();<br />
EndTry;<br />
</pre></div>Admin