Как программно очистить движения документа в 1С

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

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

Ниже разобраны рабочие способы очистки: через распроведение документа, через очистку наборов записей вручную, через установку активности и через прямую запись пустых наборов. Отдельно рассмотрены отличия управляемых и обычных форм, права доступа и типичные ошибки, из-за которых движения «не очищаются».

Как устроены движения документа и когда их нужно очищать

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

Очистка движений требуется в нескольких типовых сценариях:

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

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

Способ 1: отмена проведения — самый безопасный вариант

Штатный и рекомендуемый способ убрать все движения документа — записать его в режиме отмены проведения. Платформа сама очистит наборы записей по всем регистрам, по которым документ является регистратором, и снимет пометку проведения.

ДокументОбъект = ДокументСсылка.ПолучитьОбъект();
ДокументОбъект.Записать(РежимЗаписиДокумента.ОтменаПроведения);

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

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

Способ 2: очистка наборов записей через коллекцию Движения

Для точечной очистки движений без изменения статуса проведения используется цикл по коллекции Движения. Метод Очистить() удаляет строки набора в памяти, а метод Записать() фиксирует пустой набор в базе, физически удаляя записи регистра по этому регистратору.

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

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

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

ДокументОбъект = ДокументСсылка.ПолучитьОбъект();
Набор = ДокументОбъект.Движения.ОстаткиТоваров;
Набор.Очистить();
Набор.Записать(Истина);

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

Способ 3: прямая работа с набором записей регистра без объекта документа

Необязательно получать объект документа целиком. Можно создать набор записей регистра напрямую, установить отбор по регистратору и записать пустой набор. Это быстрее при массовой обработке, потому что не загружаются реквизиты и табличные части документа.

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

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

Такой подход часто применяют в серверных процедурах пакетной обработки в привилегированном режиме (УстановитьПривилегированныйРежим(Истина)), когда нужно обойти даты запрета и ограничения прав на уровне записи. Использовать привилегированный режим следует осознанно: он отключает проверку прав, и ошибка в отборе затронет данные всех пользователей без возможности отката вне транзакции.

Установка активности вместо удаления записей

Альтернатива физическому удалению — установить движениям признак неактивности. Неактивные записи остаются в таблице регистра, но не участвуют в расчёте итогов. Это полезно, когда нужно временно исключить влияние документа с возможностью быстрого восстановления.

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

Здесь важен порядок: сначала Прочитать(), чтобы загрузить существующие записи, затем УстановитьАктивность(Ложь), затем запись. Если пропустить чтение, набор будет пустым и записывать активность будет нечему. Обратное включение выполняется тем же кодом с параметром Истина.

Проверка результата и работа в транзакции

После очистки убедитесь, что записи действительно удалены. Проще всего выполнить запрос к регистру с отбором по регистратору и проверить, что результат пустой:

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ ПЕРВЫЕ 1 * ИЗ РегистрНакопления.ОстаткиТоваров
|ГДЕ Регистратор = &Ссылка";
Запрос.УстановитьПараметр("Ссылка", ДокументСсылка);
Если Запрос.Выполнить().Пустой() Тогда
// движения очищены
КонецЕсли;

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

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

Типичные ошибки и ограничения

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

Ещё несколько ограничений, о которых нужно помнить:

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

FAQ