6.8 KiB
6.8 KiB
title, slug
| title | slug |
|---|---|
| Проверить на запрет | 1с-1-общие-даты-запрета-изменения/проверить-на-запрет |
// Проверяет, запрещено ли изменение данных при интерактивном редактировании пользователем
// или при программной загрузке данных из узла плана обмена УзелПроверкиЗапретаЗагрузки.
//
// Параметры:
// ДанныеИлиПолноеИмя - СправочникОбъект
// - ДокументОбъект
// - ПланВидовХарактеристикОбъект
// - ПланСчетовОбъект
// - ПланВидовРасчетаОбъект
// - БизнесПроцессОбъект
// - ЗадачаОбъект
// - ПланОбменаОбъект - проверяемый объект данных.
// - РегистрСведенийНаборЗаписей
// - РегистрНакопленияНаборЗаписей
// - РегистрБухгалтерииНаборЗаписей
// - РегистрРасчетаНаборЗаписей - проверяемый набор записей с необязательным
// свойством Замещение (Булево, РежимЗамещения) в структуре ДополнительныеСвойства,
// если свойство Замещение не указано, тогда оно будет вставлено со значением Истина.
// - Строка - полное имя объекта метаданных, данные которого следует проверить в базе данных.
// Например: "Документ.ПриходнаяНакладная".
// В этом случае следует указать в параметре ИдентификаторДанных,
// какие именно данные требуется прочитать из базы и проверить.
//
// ИдентификаторДанных - СправочникСсылка
// - ДокументСсылка
// - ПланВидовХарактеристикСсылка
// - ПланСчетовСсылка
// - ПланВидовРасчетаСсылка
// - БизнесПроцессСсылка
// - ЗадачаСсылка
// - ПланОбменаСсылка
// - Отбор - ссылка на элемент данных или отбор набора записей, который нужно проверить.
// При этом значение для проверки будет получено из базы данных.
// - РегистрСведенийНаборЗаписей
// - РегистрНакопленияНаборЗаписей
// - РегистрБухгалтерииНаборЗаписей
// - РегистрРасчетаНаборЗаписей - набор записей со свойством Замещение (Булево, РежимЗамещения)
// в структуре ДополнительныеСвойства и настроенным свойством Отбор в варианте замены записей,
// как в обработчике ПередЗаписью, для получения заменяемых записей из базы данных.
// - Неопределено - если не требуется получать значение для проверки из базы данных,
// а нужно проверить только данные самого объекта в ДанныеИлиПолноеИмя.
//
// ОписаниеОшибки - Null - значение по умолчанию. Сведения о запретах не требуются.
// - Строка - возвращаемое значение. Вернуть текстовое описание найденных запретов.
// - Структура - возвращаемое значение. вернуть структурное описание найденных запретов,
// подробнее см. функцию ДатыЗапретаИзменения.НайденЗапретИзмененияДанных.
//
// УзелПроверкиЗапретаЗагрузки - Неопределено
// - ПланОбменаСсылка - если Неопределено, то проверить запрет
// изменения данных; иначе - загрузку данных из указанного узла плана обмена.
//
// Возвращаемое значение:
// Булево - Истина, если изменение данных запрещено.
//
// Варианты вызова:
// ИзменениеЗапрещено(СправочникОбъект...) - проверить данные в переданном объекте (наборе записей).
// ИзменениеЗапрещено(Строка, СправочникСсылка...) - проверить данные, полученные из базы данных
// по полному имени объекта метаданных и ссылке (отбору набора записей).
// ИзменениеЗапрещено(СправочникОбъект..., СправочникСсылка...) - проверить одновременно
// данные в переданном объекте и данные в базе (т.е. "до" и "после" записи в базу, если проверка выполняется
// перед записью объекта).
//
Результат = ДатыЗапретаИзменения.ИзменениеЗапрещено(ДанныеИлиПолноеИмя, ИдентификаторДанных, ОписаниеОшибки, УзелПроверкиЗапретаЗагрузки);