Как очистить объект в 1С: инструкция для разработчика и администратора

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

Программная очистка выполняется встроенными методами языка 1С: Очистить(), присваиванием пустых значений, обходом коллекций. Удаление данных из базы делается через метод Удалить() объектов, установку пометки удаления и штатную обработку «Удаление помеченных объектов». Важно различать эти уровни: очистка в памяти не затрагивает базу, пока объект не записан, а удаление из базы требует контроля ссылочной целостности.

Материал охватывает оба сценария: программную очистку реквизитов и коллекций в коде и безопасное удаление объектов из базы. Примеры приведены для управляемых форм и типового синтаксиса платформы 8.3.

Очистка табличной части и таблицы значений методом Очистить()

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

Объект.Товары.Очистить();
// После этого можно заполнять табличную часть заново
Для Каждого СтрокаОтбора Из РезультатЗапроса Цикл
НоваяСтрока = Объект.Товары.Добавить();
НоваяСтрока.Номенклатура = СтрокаОтбора.Номенклатура;
НоваяСтрока.Количество = СтрокаОтбора.Количество;
КонецЦикла;

Тот же метод работает для таблиц значений, деревьев значений и динамических списков, заполняемых программно. Если таблица значений больше не нужна вовсе, можно присвоить переменной Неопределено — сборщик освободит память при выходе из области видимости.

Важный нюанс: Очистить() изменяет данные только в памяти. Если это объект, существующий в базе (например, открытый документ), изменения попадут в базу только после вызова Объект.Записать(). Если запись не выполнить, при повторном чтении объекта табличная часть вернётся в исходное состояние.

Объект.Товары.Очистить();
Объект.Записать(РежимЗаписиДокумента.Запись);

Очистка реквизитов объекта

Для очистки отдельного реквизита ему присваивают пустое значение соответствующего типа: пустую строку, ноль, пустую дату, пустую ссылку или Неопределено. Универсальный способ для ссылочных реквизитов — присвоить пустую ссылку нужного типа.

Объект.Контрагент = Справочники.Контрагенты.ПустаяСсылка();
Объект.Комментарий = "";
Объект.СуммаДокумента = 0;

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

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

Очистка регистров сведений и накопления

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

НаборЗаписей = РегистрыСведений.ЦеныНоменклатуры.СоздатьНаборЗаписей();
НаборЗаписей.Отбор.Номенклатура.Установить(НужнаяНоменклатура);
НаборЗаписей.Записать(); // записи по отбору удалены

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

Удалять записи регистров напрямую запросом УДАЛИТЬ на уровне СУБД категорически не рекомендуется: это нарушает логику платформы, может привести к рассогласованию итогов и ошибкам при проведении документов.

Удаление объекта из базы: пометка и непосредственное удаление

Штатный путь удаления объекта из информационной базы двухэтапный. Сначала объект помечается на удаление — интерактивно по клавише Delete или программно методом УстановитьПометкуУдаления(Истина). Помеченный объект остаётся в базе, но исключается из большинства выборок и отчётов.

Затем выполняется удаление помеченных объектов: в режиме «Предприятие» через раздел «Администрирование» → «Удаление помеченных объектов». Платформа проверяет ссылочную целостность: если на объект есть ссылки из других документов или справочников, удаление будет заблокировано, и система покажет список мест использования.

Метод Удалить() у объектов выполняет непосредственное удаление без контроля ссылок. Его применяют только в сервисных обработках, когда гарантировано отсутствие ссылок, — иначе в базе появятся «битые ссылки» вида «Объект не найден», которые ломают отчёты и проведение документов.

Проверка результата и границы безопасной работы

После программной очистки проверьте результат прямым чтением: количество строк табличной части должно быть равно нулю (Объект.Товары.Количество() = 0), реквизиты — не заполнены (НЕ ЗначениеЗаполнено(Объект.Контрагент)). Для регистров — запросом убедитесь, что записи по нужному отбору отсутствуют.

После удаления помеченных объектов полезно запустить тестирование и исправление информационной базы с проверкой ссылочной целостности, если удалялся большой массив данных. Это выявит оставшиеся битые ссылки до того, как на них наткнутся пользователи.

Граница самостоятельной работы проходит там, где начинаются массовые операции над рабочей базой: очистка регистров за длительный период, удаление тысяч объектов, изменение данных напрямую в обход бизнес-логики. Такие задачи выполняют в копии базы, с резервной копией и, при наличии сложных связей данных, с привлечением специалиста по 1С.

Частые вопросы