К статье
Практический материал

Другое · 7 мин

Удаление строки табличного документа в 1С: порядок действий

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

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

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

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

Когда удаление строки применимо

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

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

Порядок действий
  1. 1
    Определите номер или область строки для удаления
  2. 2
    Убедитесь, что табличный документ доступен для редактирования
  3. 3
    Выполните удаление строки или пересоберите таблицу без этой строки
  4. 4
    Проверьте количество строк и значения итоговых полей

Удаление строки программно

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

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

Удаление в цикле и особенности индексов

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

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

Контрольные точки

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

Количество строк после удаления
Норма

Уменьшилось на одну и соответствует ожидаемому

Тревожный признак

Не изменилось или уменьшилось больше, чем нужно

Значения итоговых полей
Норма

Пересчитаны без удалённой строки

Тревожный признак

Содержат удалённые значения

Проверка результата и возможность отката

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

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

Ограничения и риски

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

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

Типичные ошибки
01
Удаление строки по неверному индексу приводит к удалению другой строки
02
Удаление в цикле от начала к концу смещает индексы и пропускает строки
03
Попытка удалить строку в защищённом или уже выведенном документе вызывает ошибку

Альтернативы прямому удалению

Вместо удаления строки можно скрыть её, исключить из отбора или пометить как неактуальную. Это полезно, когда строка может понадобиться позже или когда удаление запрещено правами доступа. Скрытие не меняет данные, но убирает строку из видимого вывода.

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

Итог

Что важно запомнить

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

Часто задаваемые вопросы

Можно ли удалить строку в уже напечатанном документе?

Если документ уже распечатан или отправлен получателю, прямое удаление строки из печатной формы не рекомендуется. Лучше сформировать корректный вариант или корректирующий документ, чтобы не создавать расхождение между выданным экземпляром и данными в базе.

Что делать, если номер строки неизвестен?

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

Влияет ли удаление строки табличного документа на остатки и проводки?

Табличный документ чаще является способом отображения, а не источником регистровых записей. Само по себе удаление строки из таблицы не создаёт и не отменяет проводки, но может изменить итоги в печатной форме. Исправление данных должно выполняться в исходном документе или регистре.

Можно ли отменить удаление строки?

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