Как в 1С записать объект без проверок

При записи объектов в 1С платформа и конфигурация выполняют множество проверок: контроль заполнения обязательных реквизитов, обработчики «ПередЗаписью» и «ПриЗаписи», подписки на события, проверки прав и бизнес-логика. Иногда это мешает — например, при загрузке данных из внешних источников, исправлении ошибок обмена или массовом переносе, когда часть реквизитов ещё не заполнена, а записать объект нужно.

Штатный способ отключить проверки — установить свойство ОбменДанными.Загрузка = Истина у объекта перед вызовом метода Записать(). Этот режим сигнализирует платформе и конфигурации, что идёт загрузка данных, и большинство стандартных проверок пропускается. При этом важно понимать, что именно отключается, а что продолжает работать, чтобы не получить «мусор» в базе или нарушенные ссылки.

Способ применим к справочникам, документам, планам счетов, планам видов характеристик и другим объектам, у которых есть объектное представление. Для записей регистров подход похожий: свойство устанавливается у набора записей. Ниже разобраны синтаксис, сценарии применения, ограничения и типичные ошибки.

Что именно отключает режим ОбменДанными.Загрузка

Свойство ОбменДанными.Загрузка доступно у любого объекта, полученного через менеджер (например, Справочники.Номенклатура.СоздатьЭлемент()) или методом ПолучитьОбъект() у ссылки. Когда оно установлено в Истина, платформа пропускает автоматический контроль заполнения реквизитов, для которых в конфигураторе задано свойство «Проверка заполнения — Выдавать ошибку».

Кроме того, большинство типовых конфигураций в обработчиках «ПередЗаписью», «ПриЗаписи» и подписках на события содержат проверку вида Если Объект.ОбменДанными.Загрузка Тогда Возврат; КонецЕсли;. Поэтому в режиме загрузки не срабатывает и прикладная логика: пересчёты, заполнение служебных реквизитов, регистрация изменений для обмена, проверки дублей и т.п.

Важно понимать границы: режим не отключает проверки уровня СУБД и платформенной структуры данных. Уникальность кода в пределах серии (если включён контроль уникальности), обязательность ссылки на владельца у подчинённого справочника, типы реквизитов — всё это продолжает контролироваться, и нарушение приведёт к ошибке записи.

Как записать объект без проверок: базовый код

Минимальный пример для справочника выглядит так:

НовыйЭлемент = Справочники.Номенклатура.СоздатьЭлемент();
НовыйЭлемент.Наименование = "Тестовая позиция";
НовыйЭлемент.ОбменДанными.Загрузка = Истина;
НовыйЭлемент.Записать();

Для существующего объекта сначала получают объект по ссылке, изменяют реквизиты и записывают в том же режиме:

Объект = СсылкаНаЭлемент.ПолучитьОбъект();
Объект.Комментарий = "Исправлено загрузкой";
Объект.ОбменДанными.Загрузка = Истина;
Объект.Записать();

Для документа, который нужно провести, режим загрузки комбинируется с режимом проведения: ДокОбъект.Записать(РежимЗаписиДокумента.Проведение, РежимПроведенияДокумента.Неоперативный). Учтите, что при проведении в режиме загрузки обработчики проведения и контроль остатков в типовых конфигурациях обычно тоже пропускаются — это частая причина расхождения остатков.

Объект.ОбменДанными.Загрузка = Истина;
Объект.Записать(); // запись без контроля заполнения и обработчиков

Запись наборов записей регистров без проверок

Для регистров сведений, накопления и бухгалтерии свойство устанавливается у набора записей. Это востребовано при прямой корректировке движений документа или при загрузке остатков:

НаборЗаписей = РегистрыСведений.КурсыВалют.СоздатьНаборЗаписей();
НаборЗаписей.Отбор.Период.Установить(ДатаКурса);
НаборЗаписей.Отбор.Валюта.Установить(ВалютаСсылка);
НоваяЗапись = НаборЗаписей.Добавить();
НоваяЗапись.Период = ДатаКурса;
НоваяЗапись.Валюта = ВалютаСсылка;
НоваяЗапись.Курс = 90.5;
НаборЗаписей.ОбменДанными.Загрузка = Истина;
НаборЗаписей.Записать();

Здесь особенно важен параметр Замещение метода Записать(): по умолчанию он равен Истина, и набор полностью замещает существующие записи по установленному отбору. Если нужно добавить записи без замещения, вызывайте НаборЗаписей.Записать(Ложь) — иначе можно незаметно удалить чужие данные.

Когда режим загрузки оправдан, а когда опасен

Уместные сценарии: загрузка данных из внешних систем и файлов, начальное заполнение базы, исправление ошибок обмена, массовое заполнение служебных реквизитов, перенос данных между информационными базами. Во всех этих случаях вы заранее знаете структуру данных и берёте ответственность за их корректность на себя.

Опасные сценарии: запись документов, участвующих в учёте остатков и взаиморасчётов, обход проверок ради «ускорения» прикладного кода, запись объектов, на которые завязаны механизмы обмена данными. В типовых конфигурациях режим загрузки отключает и регистрацию изменений в планах обмена — объект, записанный таким образом, не уедет в другие узлы, что приводит к рассинхронизации баз.

Если цель — просто отключить контроль заполнения у конкретного объекта, но сохранить прикладную логику, рассмотрите альтернативы: временное заполнение обязательных реквизитов техническими значениями, изменение свойства проверки заполнения в конфигураторе (для собственных разработок) или использование ДополнительныеСвойства для передачи признака, который обработают ваши подписки.

Типичные ошибки при записи без проверок

Самая распространённая ошибка — забыть, что режим загрузки отключает регистрацию изменений для обменов. Данные записаны в центральной базе, а в периферийных их нет. Если база участвует в обменах, после массовой загрузки нужно отдельно зарегистрировать изменения через ПланыОбмена.ЗарегистрироватьИзменения() или выполнить начальную выгрузку.

Вторая частая проблема — «битые» и пустые ссылки. Раз контроль заполнения отключён, ничто не мешает записать документ без контрагента или элемент справочника без владельца. Позже это вылезает ошибками в отчётах и обработках. После загрузки стоит выполнить проверочный запрос по ключевым реквизитам.

Третья группа ошибок связана с транзакциями: при массовой записи в цикле без транзакции сбой на середине оставляет базу в частично загруженном состоянии. Оборачивайте пакетную запись в НачатьТранзакцию() / ЗафиксироватьТранзакцию() с обработкой исключений и откатом.

Как проверить результат после записи

После записи в режиме загрузки полезно убедиться, что объект действительно сохранён и данные консистентны. Минимальный набор проверок: ссылка получена (Объект.Ссылка.Пустая() возвращает Ложь), ключевые реквизиты читаются запросом, связанные объекты существуют.

Для массовых операций сформируйте контрольный запрос: количество загруженных элементов, количество записей с пустыми критичными реквизитами, количество дублей по естественному ключу (например, по наименованию и ИНН). Расхождение с ожиданиями — повод откатить транзакцию и разобраться с исходными данными.

Если база участвует в обменах, дополнительно проверьте состав регистрации изменений в планах обмена и при необходимости зарегистрируйте загруженные объекты вручную, чтобы они ушли в подчинённые узлы.

FAQ