Глобальный контекст.ЗаблокироватьДанныеДляРедактирования (Global context.LockDataForEdit)

Глобальный контекст (Global context)

ЗаблокироватьДанныеДляРедактирования (LockDataForEdit)

Доступен, начиная с версии 8.2.

Синтаксис:

ЗаблокироватьДанныеДляРедактирования(<Ключ>, <ВерсияДанных>, <ИдентификаторФормы>)

Параметры:

<Ключ> (обязательный)

Тип: Любая ссылка на объект информационной базы, РегистрСведенийКлючЗаписи.<Имя регистра сведений>, ВнешнийИсточникДанныхТаблицаСсылка.<Имя внешнего источника>, ВнешнийИсточникДанныхТаблицаКлючЗаписи.<Имя внешнего источника>.
Ссылка на объект, который должен быть заблокирован, или ключ записи независимого регистра сведений, которая должна быть заблокирована.

<ВерсияДанных> (необязательный)

Тип: Строка.
Версия блокируемого объекта в формате Base64. Используется, если параметр <Ключ> имеет тип Любая ссылка на объект информационной базы.
Если указан, то при блокировке объекта проверяется версия объекта базы данных. При несовпадении версии или отсутствии объекта в базе данных генерируется исключение.

<ИдентификаторФормы> (необязательный)

Тип: УникальныйИдентификатор.
Уникальный идентификатор формы. Если параметр указан, то блокировка устанавливается на все время жизни формы, в которой установлена блокировка. Важно, что если за время отображения формы не были установлены другие блокировки от имени этой формы (при интерактивном редактировании или методом ЗаблокироватьДанныеФормыДляРедактирования), то при закрытии формы блокировка может быть отменена не сразу, а через некоторое время. Блокировка может быть снята:

автоматически при закрытии формы или завершении сеанса;
с помощью метода глобального контекста РазблокироватьДанныеДляРедактирования с указанием того же идентификатора формы, который указывался для установки блокировки. В этом случае блокировка снимается сразу.

Если параметр не указан, то блокировка устанавливается на ограниченное время и может быть снята:

с помощью метода РазблокироватьДанныеДляРедактирования без указания идентификатора формы;
при окончании транзакции, если блокировка установлена в транзакции;
при окончании работы встроенного языка (для режимов запуска "Тонкий клиент" и "Веб-клиент"; при возврате управления с сервера);
при завершении сеанса.

Описание:

Заблокировать данные для редактирования в форме клиентского приложения.
Вызывает исключение, если объект уже заблокирован, в том числе и методом Заблокировать.

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.

См. также:

Глобальный контекст, метод РазблокироватьДанныеДляРедактирования

Использование в версии:

Доступен, начиная с версии 8.2.

Методическая информация