Другое · 8 мин
Поиск и удаление строки в табличной части документа 1С
Разбираем, как найти нужную строку в табличной части документа 1С и удалить её вручную или программно: условия, порядок действий, проверка результата и типичные ошибки.
Табличная часть документа в 1С используется для хранения однородных строк: номенклатура, количество, сумма, статья расчёта и другие реквизиты. Часто возникает задача найти строку по определённому признаку и удалить её, чтобы исправить ошибку или очистить документ перед проведением.
Поиск и удаление можно выполнить двумя способами: интерактивно, через форму документа, и программно, с помощью встроенного языка 1С:Предприятия. Выбор способа зависит от того, нужно ли удалить одну строку вручную или обработать много документов автоматически.
Ниже рассмотрены оба подхода, условия безопасного удаления, способы проверки результата и типичные ошибки, которые стоит учитывать перед началом работы.
Как найти строку в табличной части
В форме документа найти строку можно просмотром табличной части или встроенным поиском по значению реквизита. Удобнее всего искать по уникальному полю, например коду номенклатуры или номеру строки, если такие данные заполнены. Если строк много, стоит отсортировать таблицу по искомому реквизиту, чтобы нужная запись попала в поле зрения быстрее.
Программный поиск выполняется циклом по коллекции табличной части. На каждой итерации проверяется значение нужного реквизита текущей строки, и при совпадении фиксируется сама строка или её индекс. Такой подход подходит, когда условие поиска заранее известно и не требует ручного просмотра каждой записи.
- 1Откройте документ и перейдите на вкладку с табличной частью
- 2Найдите нужную строку по реквизиту или значению
- 3Выделите строку и выполните команду удаления
- 4Сохраните документ и проверьте, что строка исчезла
Важно учитывать, что поиск по частичному совпадению может вернуть несколько строк, а поиск по точному значению — либо одну, либо ни одной. Если искомое значение отсутствует, программа должна обработать этот случай без ошибочного завершения, например вывести сообщение или пропустить удаление.
Как удалить строку в табличной части
В интерактивном режиме достаточно выделить строку мышкой и вызвать команду удаления через контекстное меню или панель команд. После этого строка исчезает из табличной части, но изменения вступают в силу только после сохранения документа. Если документ не сохранён, удаление можно отменить, закрыв форму без записи.
Программное удаление выполняется методом Удалить у табличной части, обычно с указанием ссылки на удаляемую строку. При этом остальные строки сохраняют свои данные, а порядковые номера могут пересчитаться автоматически. Если нужно удалить несколько строк подряд, стоит подумать о порядке обхода, чтобы не пропустить подходящие записи.
Ограничение заключается в том, что не каждую строку можно удалить без последствий. В проведённых документах изменение табличной части часто блокируется или требует предварительной отмены проведения. Также удалённые данные могут быть связаны с регистрами накопления, остатками или другими документами, поэтому прямое удаление не всегда безопасно.
Для Каждого Строка Из ТабличнаяЧасть Цикл
Если Строка.Номенклатура = Искомое Тогда
ТабличнаяЧасть.Удалить(Строка);
Прервать;
КонецЕсли;
КонецЦикла;Программный поиск и удаление на языке 1С
Типичный алгоритм выглядит так: открыть документ, получить доступ к его табличной части, пройти циклом по строкам и при выполнении условия вызвать Удалить. Примерно это записывается как перебор коллекции с проверкой значения реквизита и удалением найденной строки. После завершения цикла документ следует сохранить, иначе изменения не запишутся в базу.
Особенность удаления при обходе с начала к концу заключается в смещении индексов: после удаления текущей строки следующая строка занимает её место, и цикл может пропустить одну из подходящих записей. Поэтому при массовом удалении удобнее обходить табличную часть с конца к началу или сначала собирать список строк на удаление, а затем удалять их отдельно.
Удаление по индексу и по условию
Удаление по индексу подходит, когда положение строки известно точно, например вторая или последняя строка таблицы. Этот способ проще, но менее надёжный, если порядок строк может измениться между открытием документа и удалением. Удаление по условию более устойчиво к перестановкам, но требует чёткой формулировки критерия, по которому строка считается целевой.
Если условие не уникально, программа может удалить первую попавшуюся строку или все подходящие, в зависимости от логики цикла. Перед запуском массового удаления рекомендуется протестировать сценарий на копии базы или на выборочных документах, чтобы убедиться, что затрагиваются только нужные записи.
Как проверить результат
Строка отсутствует, документ сохранён
Строка осталась или документ не сохранился
Проверка результата и ограничения
После удаления нужно открыть табличную часть и убедиться, что искомой строки больше нет, а остальные данные не пострадали. Затем документ сохраняется, и при необходимости повторно проводится, если это требуется для корректности отчётов. Пропуск шага сохранения приводит к тому, что удаление существует только в текущей сессии и пропадает при закрытии.
Ограничения связаны с режимом работы документа: проведённые документы часто защищены от изменений табличной части, а удаление строк, отражённых в регистрах, может нарушить остатки и обороты. Если программа выдаёт ошибку при записи, стоит проверить, не заблокирован ли документ другим пользователем или процессом.
Когда стоит остановиться и обратиться к разработчику
Если строка связана с проведёнными операциями, регистрами накопления или данными других документов, самостоятельное удаление может привести к несоответствиям в учёте. В таких случаях безопаснее отменить проведение документа, внести исправление через корректирующий документ или обратиться к специалисту по 1С.
Признаком необходимости помощи разработчика служат повторяющиеся ошибки при записи, блокировка табличной части или отсутствие нужных прав доступа. Не стоит пытаться обходить защиту через прямое изменение базы данных, так как это может повредить целую информационную базу.
Сравнение вариантов
Подходит для единичных исправлений в несохранённом документе
Подходит для массовой обработки, требует навыков работы с языком 1С
Альтернативные подходы и рекомендации
Вместо физического удаления иногда удобнее пометить строку как неактуальную или скорректировать её значения, особенно если важно сохранить историю изменений. Для массовой очистки табличных частей подходят обработки или отчёты с выгрузкой условий, которые позволяют сначала просмотреть кандидатов на удаление, а затем выполнить операцию.
Регулярное резервное копирование и работа с копией базы перед нестандартными изменениями снижают риски. Если удаление строк становится регулярной задачей, целесообразно вынести алгоритм в отдельную внешнюю обработку или в модуль документа, чтобы избежать ручного кода в каждом случае.
Что важно запомнить
Найдите строку по условию, удалите её нужным способом, сохраните документ и проверьте результат, особенно если документ проведён.
Можно ли удалить строку в проведённом документе?
Обычно прямое изменение табличной части проведённого документа ограничено. Необходимо отменить проведение, внести правку и провести документ повторно, либо использовать корректирующий документ, если это предусмотрено конфигурацией.
Что делать, если искомая строка не находится?
Проверьте точное название реквизита, регистр символов и значение, а также не применён ли фильтр к табличной части. Программный поиск не найдёт строку, если условие не совпадает ни с одной записью или данные находятся в другой табличной части документа.
Удалит ли цикл все подходящие строки или только одну?
Это зависит от кода: команда Прервать после первого удаления остановит поиск, а без неё цикл продолжит обход. При удалении с начала к концу возможен пропуск строк из-за смещения индексов, поэтому для массового удаления лучше идти с конца или собирать список целей заранее.
Нужно ли сохранять документ после удаления строки?
Да, изменения в табличной части фиксируются только при сохранении документа. Если закрыть форму без записи, удалённая строка вернётся при следующем открытии, так как база не была обновлена.
Можно ли отменить уже сделанное удаление?
Если документ ещё не сохранён, отмена возможна при закрытии без записи. После сохранения удаление отменяется только восстановлением из резервной копии или введением корректирующей записи, поэтому перед действием стоит убедиться в необходимости изменений.