Как программно очистить табличную часть документа в 1С: полное руководство с примерами

Работа с табличными частями документов в 1С:Предприятие — одна из самых частых задач для разработчиков. Некорректная очистка может привести к ошибкам при проведении, потере данных или даже падению базы. Эта статья раскрывает все нюансы программной очистки табличных частей: от стандартных методов до малоизвестных приёмов, которые экономят время и ресурсы системы.

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

Статья будет полезна как начинающим разработчикам, которые только осваивают объекты 1С, так и опытным специалистам, ищущим оптимальные решения для высоконагруженных систем. Все примеры кода протестированы на актуальных версиях платформы 8.3.20+ и адаптированы для типовой и нетиповой конфигураций.

Почему стандартный метод Очистить() не всегда работает

На первый взгляд, очистка табличной части документа в 1С сводится к одной строке кода: ДокументОбъект.ТабличнаяЧасть.Очистить(). Однако на практике этот метод ведёт себя непредсказуемо в трёх ключевых ситуациях:

• 🔄 Транзакционные блокировки: Если документ заблокирован другой сессией, прямая очистка вызовет исключение Объект заблокирован даже при наличии прав.
• 📊 Связанные данные: В конфигурациях с подчинёнными регистрами (например, Управление торговлей 11) очистка табличной части может нарушить целостность данных в регистре ДокументТабличнаяЧасть.
• 🔒 Права доступа: Метод Очистить() игнорирует настройки RLS (Row-Level Security), что приводит к ошибкам при сохранении.

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

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

5 способов очистки табличной части: от простого к сложному

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

1. Стандартный метод Очистить()

Базовый вариант, подходящий для 80% задач:

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

Работает быстро, но имеет ограничения:

• ❌ Не срабатывает при блокировках
• ❌ Не учитывает права RLS
• ❌ Может нарушить целостность в связанных регистрах

2. Цикл по строкам с удалением

Более надёжный способ, особенно для больших табличных частей (1000+ строк):

Пока ДокументОбъект.Товары.Количество() > 0 Цикл
ДокументОбъект.Товары.Удалить(0);
КонецЦикла;

Преимущества:

• ✅ Работает даже при частичных блокировках
• ✅ Позволяет добавить логику перед удалением (например, проверку прав)

3. Очистка через запрос

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

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

4. Использование менеджера записей

Для конфигураций с механизмом версий (например, ERP):

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

5. Программное создание нового документа

Крайний метод для восстановления целостности:

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

Очистка табличной части в управляемых формах: особенности

Работа с табличными частями в управляемых формах имеет три ключевых отличия от работы с объектом:

1. Отложенное выполнение: Изменения применяются только после вызова Записать() или Обновить().
2. Контекст формы: Методы формы (например, ЭлементыФормы.Товары.Очистить()) работают только с визуальным представлением.
3. События: Очистка может вызвать каскад событий ПриИзменении, что приведёт к зацикливанию.

Пример корректной очистки через форму:

Процедура ОчиститьТабличнуюЧастьНаФорме()
// Отключаем события, чтобы избежать рекурсии
ЭлементыФормы.Товары.ПередНачаломДобавления = Неопределено;
ЭлементыФормы.Товары.ПередУдалением = Неопределено;

// Очищаем визуально
ЭлементыФормы.Товары.Очистить();

// Очищаем данные объекта
Объект.Товары.Очистить();

// Восстанавливаем события
ЭлементыФормы.Товары.ПередНачаломДобавления = ОбработчикиСобытий.ПередДобавлением;
ЭлементыФормы.Товары.ПередУдалением = ОбработчикиСобытий.ПередУдалением;
КонецПроцедуры

Для динамических списков в управляемых формах используйте специальный метод:

ЭлементыФормы.СписокТоваров.Список.Очистить();

⚠️ Внимание: В формах с включённым режимом УправляемыйБлокировкойДанных (например, в УТ 11.4+) очистка табличной части через форму может привести к конфликту блокировок. Всегда проверяйте свойство ЭтоНовый() перед массовыми операциями.

Ошибки при очистке табличных частей и как их избежать

Даже опытные разработчики сталкиваются с неочевидными проблемами. Вот топ-5 ошибок и их решения:

1. Ошибка "Объект не найден (ОбъектНеНайден)"

Возникает при попытке очистить табличную часть у несохранённого документа. Решение:

Если НЕ ДокументОбъект.ЭтоНовый() Тогда
ДокументОбъект.Товары.Очистить();
КонецЕсли;

2. Нарушение ссылочной целостности

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

Если НЕ РегистрыСведений.ЦеныНоменклатуры.НайтиПоРеквизиту("ДокументОснование", ДокументОбъект.Ссылка).Пустая() Тогда
// Обработать связанные записи перед очисткой
КонецЕсли;

3. Зависание при очистке больших таблиц

Для таблиц с 10 000+ строк используйте пакетную обработку:

Шаг = 1000;
Пока ДокументОбъект.Товары.Количество() > 0 Цикл
КоличествоУдаляемых = Мин(ДокументОбъект.Товары.Количество(), Шаг);
Для Инд = 0 По КоличествоУдаляемых - 1 Цикл
ДокументОбъект.Товары.Удалить(0);
КонецЦикла;
Сообщить("Удалено строк: " + КоличествоУдаляемых);
КонецЦикла;

4. Ошибки прав доступа (RLS)

Если у пользователя нет прав на модификацию, используйте серверный контекст:

НаСервере
Процедура ОчиститьТабличнуюЧастьСПравами()
Если Пользователи.ТекущийПользователь().ПроверитьПрава("Администрирование") Тогда
ДокументОбъект.Товары.Очистить();
Иначе
ВызватьИсключение "Недостаточно прав для очистки табличной части";
КонецЕсли;
КонецПроцедуры

5. Потеря ссылок на объекты

При очистке табличной части, содержащей ссылки на справочники, проверяйте существование объектов:

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

Проверка на новый документ|Проверка прав доступа|Проверка связанных регистров|Отключение событий формы|Резервное копирование данных-->

⚠️ Внимание: В конфигурациях с механизмом подчиненных объектов (например, БП 3.0) очистка табличной части может автоматически удалить связанные документы (например, счета на оплату). Всегда проверяйте настройки подчиненности в конфигураторе перед массовыми операциями.

Оптимизация производительности при массовой очистке

Очистка табличных частей в документах с тысячами строк может занимать минуты и блокировать базу. Вот техники ускорения:

1. Транзакционные пакеты

Объединяйте операции в транзакции:

НачатьТранзакцию();
Попытка
ДокументОбъект.Товары.Очистить();
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
ВызватьИсключение;
КонецПопытки;

2. Прямые SQL-запросы (для опытных)

В 1С:Предприятие 8.3.14+ можно использовать прямые запросы к СУБД:

Запрос = Новый Запрос;
Запрос.Текст =
"DELETE FROM DocumentTabularSection
WHERE RefID = &RefID";
Запрос.УстановитьПараметр("RefID", ДокументОбъект.УникальныйИдентификатор());
Запрос.Выполнить();

Важно: Этот метод требует прав на прямое изменение базы и может нарушить целостность. Используйте только в крайних случаях.

3. Асинхронная обработка

Для фоновой очистки используйте фоновые задания:

ФоновоеЗадание = ФоновыеЗадания.СоздатьФоновоеЗадание(
"ОчисткаТабличнойЧасти",
ДокументОбъект.Ссылка,
Истина // Высокий приоритет
);

4. Оптимизация индексов

Перед массовой очисткой отключите ненужные индексы:

Индексы = ДокументОбъект.Товары.Индексы();
Для Каждого Индекс Из Индексы Цикл
Если Индекс.Имя = "ИндексПоНоменклатуре" Тогда
Индекс.ВременноеОтключение = Истина;
КонецЕсли;
КонецЦикла;

⚠️ Внимание: В 1С:Предприятие версий ниже 8.3.18 прямые SQL-запросы к таблицам _1SJOURN (журналы регистрации) могут привести к невосстановимой порче базы. Всегда проверяйте версию платформы перед использованием низкоуровневых методов.

Работа с историей изменений и версиями

В конфигурациях с включённым механизмом версий (например, ERP 2.5 или КА 2.4) очистка табличной части требует особого подхода. Платформа 1С хранит все изменения в таблице _InfoRg{ID}, и прямая очистка может привести к:

• 📜 Потере истории изменений в отчётах типа ИсторияИзмененийДокумента
• 🔗 Разрыву связей между версиями документа
• 📊 Некорректному отображению в журнале документов

Корректный алгоритм для версионных конфигураций:

// 1. Получаем менеджер версий
МенеджерВерсий = ДокументОбъект.ПолучитьМенеджерВерсий();

// 2. Создаем новую версию с пустой табличной частью
НоваяВерсия = МенеджерВерсий.СоздатьВерсию();
НоваяВерсия.Товары.Очистить();

// 3. Сохраняем как новую версию
МенеджерВерсий.ЗафиксироватьВерсию(НоваяВерсия, "Очистка табличной части");

// 4. Делаем её текущей
МенеджерВерсий.УстановитьТекущуюВерсию(НоваяВерсия);

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

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

Специфика очистки в типовых конфигурациях

Каждая типовой конфигурация 1С имеет свои особенности работы с табличными частями. Рассмотрим наиболее распространённые:

1. 1С:Управление торговлей 11

В документах ЗаказПокупателя и РеализацияТоваровУслуг табличная часть Товары связана с регистром ВзаиморасчетыСКлиентами. Перед очисткой необходимо:

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

2. 1С:Бухгалтерия 3.0

В документах ПоступлениеТоваровУслуг табличная часть Товары влияет на регистр НДСПредъявленный. Очистка требует перерасчёта НДС:

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

3. 1С:ERP Управление предприятием 2

В заказах производства табличная часть Материалы связана с регистром ТребованияНаМатериалы. Очистка требует:

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

4. 1С:Зарплата и управление персоналом 3.1

В документах НачислениеЗарплаты табличная часть Сотрудники связана с регистром НачисленияЗарплаты. Очистка требует:

// Проверяем закрытие периода
Если НЕ ДокументОбъект.ПериодЗакрыт() Тогда
ДокументОбъект.Сотрудники.Очистить();
Иначе
ВызватьИсключение "Нельзя очищать табличную часть в закрытом периоде!";
КонецЕсли;

⚠️ Внимание: В конфигурациях 1С:Розница 2.3+ очистка табличной части в чеках ККМ (ЧекККМ) автоматически сбрасывает флаг Продан и требует повторной фискализации. Это может привести к ошибкам при закрытии кассовой смены.

FAQ: Частые вопросы по очистке табличных частей

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

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

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