1С: как удалить строку из табличной части по условию

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

Главная сложность заключается в том, что нельзя удалять строки прямо в цикле «Для Каждого»: коллекция изменяется во время обхода, индексы сдвигаются, и часть строк пропускается либо возникает ошибка. Ниже разобраны три рабочих способа, которые безопасно решают эту задачу на управляемых и обычных формах.

Все примеры применимы к типовым и самописным конфигурациям на платформе 1С:Предприятие 8.3, как в серверном, так и в клиентском контексте — с учётом ограничений, которые описаны отдельно.

Способ 1. НайтиСтроки и последующее удаление

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

Отбор = Новый Структура("Количество", 0);
НайденныеСтроки = Объект.Товары.НайтиСтроки(Отбор);

Для Каждого СтрокаТовара Из НайденныеСтроки Цикл
Объект.Товары.Удалить(СтрокаТовара);
КонецЦикла;

Этот способ удобен, когда условие простое и выражается равенством значений колонок: конкретная номенклатура, нулевое количество, заданный склад. Если условие сложнее (например, «сумма меньше 100» или сравнение дат), НайтиСтроки не подойдёт — структура отбора поддерживает только сравнение на равенство.

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

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

Способ 2. Обход коллекции с конца по индексу

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

КоличествоСтрок = Объект.Товары.Количество();

Для Индекс = 1 По КоличествоСтрок Цикл
ТекущаяСтрока = Объект.Товары[КоличествоСтрок - Индекс];
Если ТекущаяСтрока.Сумма < 100 Тогда
Объект.Товары.Удалить(ТекущаяСтрока);
КонецЕсли;
КонецЦикла;

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

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

Способ 3. Цикл «Пока» с ручным управлением индексом

Альтернатива обходу с конца — идти с начала, но увеличивать индекс только тогда, когда строка не была удалена. Если строка удалена, следующая «подтягивается» на её место, и индекс увеличивать нельзя.

Индекс = 0;
Пока Индекс < Объект.Товары.Количество() Цикл
СтрокаТовара = Объект.Товары[Индекс];
Если СтрокаТовара.Отменено Тогда
Объект.Товары.Удалить(Индекс);
Иначе
Индекс = Индекс + 1;
КонецЕсли;
КонецЦикла;

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

Удаление на форме и модифицированность объекта

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

&НаКлиенте
Процедура УдалитьНулевыеСтроки(Команда)
УдалитьНулевыеСтрокиНаСервере();
Модифицированность = Истина;
КонецПроцедуры

Если обработка выполняется массово для многих документов (внешняя обработка, регламентное задание), работайте с объектом через ПолучитьОбъект() и завершайте запись методом Записать(). Без записи изменения в базе не сохранятся.

Проведённый документ и права доступа

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

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

Типичные ошибки при удалении строк

Самая частая ошибка — удаление внутри цикла Для Каждого по самой коллекции. Платформа при этом либо пропускает строки, либо поведение становится непредсказуемым, потому что внутренний итератор сбивается при изменении коллекции. Такой код иногда «работает» на маленьких табличных частях и ломается на больших, что затрудняет поиск причины.

Вторая распространённая проблема — забытая запись объекта после удаления в серверной обработке: код отрабатывает без ошибок, но в базе ничего не меняется. Третья — сравнение ссылочных полей со строковым представлением вместо ссылки: отбор по НайтиСтроки в этом случае ничего не находит.

Проверка результата после удаления

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

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

FAQ