Другое · 7 мин
Как обойти строки табличной части документа в 1С
Как перебирать строки табличной части документа в 1С: циклы по ссылкам и индексам, удаление и изменение строк, отличия модуля объекта и формы, проверка результата.
Табличная часть документа в 1С представляет собой набор строк, которые нужно перебирать для заполнения реквизитов, пересчета сумм, проверки заполнения или удаления лишних позиций. Основной способ доступа зависит от того, где находится код: в модуле объекта документа или в модуле формы. В первом случае строки доступны напрямую через свойство объекта, во втором — через элементы формы и текущие данные.
Если требуется изменить данные документа, важно учитывать его статус. Черновик обычно можно править без ограничений, а проведенный документ часто защищен от изменения или требует отмены проведения. Перед массовой обработкой строк рекомендуется протестировать алгоритм на копии базы или отдельном документе, чтобы не повредить остатки и регистры.
Цикл по строкам должен быть предсказуемым: при добавлении или удалении строк внутри обхода индексы могут сбиться, а ссылки на строки стать недействительными. Поэтому ниже рассматриваются безопасные способы обхода, условия выбора метода и признаки того, что результат получен верно.
Способы перебора строк табличной части
В модуле объекта документа строки табличной части доступны как коллекция. Самый простой вариант — цикл «Для каждого», который обходит каждую строку по очереди. Это удобно, когда нужно прочитать значения реквизитов или записать новые значения в существующие поля строки.
Пример в общем виде: для каждой строки из табличной части взять значение количества и цены, вычислить сумму и записать её в реквизит суммы строки. Цикл завершается автоматически после последней строки. Такой подход подходит для чтения и изменения значений внутри строк, но не для удаления строк во время обхода вперед.
Если нужны позиции строк для обращения к предыдущей или следующей строке, используйте обход по индексам от нуля до количества строк минус один. Каждую строку можно получить по индексу, а затем обратиться к её полям. Этот способ удобен, когда важно знать номер строки для сообщений об ошибках или для сравнения с соседней строкой.
Изменение и удаление строк во время обхода
Удаление строк в цикле «вперёд» по индексам опасно: после удаления текущей строки все последующие сдвигаются на один индекс, и программа может пропустить строку или обратиться к несуществующей позиции. Безопаснее удалять строки, идя от последней к первой, либо сначала собрать строки, подлежащие удалению, в отдельный список, а затем удалить их после завершения обхода.
Если строка помечается на удаление через флаг или временный реквизит, основной цикл может просто пропускать такие строки, а отдельный проход удаляет их в обратном порядке. Такой подход снижает вероятность сбоя индексов и упрощает отладку. При работе с проведенными документами проверьте, разрешено ли изменение табличной части в текущем статусе, иначе изменения могут быть отменены или заблокированы.
Работа с табличной частью в форме
В управляемой форме доступ к строкам табличной части отличается от модуля объекта. Часто достаточно работать с текущими данными выделенной строки через элемент формы табличной части. Для массовых изменений всех строк формы целесообразно передать данные на сервер, где доступна полная табличная часть объекта, выполнить обработку и вернуть результат на форму.
Как проверить результат
Все обязательные поля заполнены
Есть пустые обязательные поля
Суммы совпадают с ожидаемыми
Расхождение сумм после обхода
Удалены только целевые строки
Пропадали лишние строки или индексы сбились
Клиентский код формы имеет ограничения на прямое изменение коллекции строк табличной части. Если нужно добавить или удалить несколько строк, предпочтительнее сделать это на сервере в модуле объекта или в серверной процедуре формы, а затем обновить элементы формы. Это помогает избежать несоответствия между данными на форме и данными объекта.
Проверка результата и границы безопасной работы
После обхода и изменения строк убедитесь, что реквизиты строк заполнены корректно, суммы сходятся, а обязательные поля не пустые. Если алгоритм удалял строки, проверьте, что нужные строки не пропали случайно, а нежелательные удалены. При массовом пересчете полезно сравнить итоговые значения до и после обработки на контрольном документе.
Не изменяйте табличную часть во время проведения документа, если это не предусмотрено конфигурацией, и не выполняйте массовую обработку в рабочей базе без резервной копии. Убедитесь, что у пользователя есть права на запись документа, и что другие пользователи не редактируют тот же документ одновременно. При сомнениях обратитесь к администратору информационной базы или разработчику конфигурации.
Типичные ошибки и альтернативы
Частая ошибка — изменение табличной части внутри цикла «Для каждого» без учета изменения коллекции. Это приводит к пропуску строк или ошибкам выполнения. Другая ошибка — попытка изменить проведенный документ без отмены проведения, что либо игнорируется программой, либо вызывает нарушение учета.
Сравнение вариантов
Подходит для чтения и изменения полей строк, не подходит для безопасного удаления строк внутри обхода.
Позволяет обращаться к номеру строки и соседям, требует обратного хода при удалении.
Удобна для массовых изменений табличной части, требует разделения клиентского и серверного кода.
Если логика сложная, удобно скопировать строки табличной части в таблицу значений, обработать их отдельно и затем записать результат обратно. Для импорта данных из внешних источников можно использовать загрузку из файла или обмен через значения, а не построчное ручное заполнение. Выбор метода зависит от объема данных, частоты операции и ограничений конфигурации.
Сравнение вариантов обхода
Цикл «Для каждого» проще и читаемее для чтения и изменения значений строк, но не подходит для удаления по ходу обхода. Обход по индексам дает контроль над позицией и удобен для сообщений об ошибках, но требует осторожности при изменении количества строк. Серверная обработка подходит для массовых изменений, клиентская — для работы с текущей строкой формы.
Итог
Что важно запомнить
Обходите строки табличной части через ссылку или индексы, удаляйте от конца к началу, проверяйте статус документа и тестируйте на копии.
Можно ли удалять строки табличной части внутри цикла «Для каждого»?
Прямое удаление строк из коллекции во время обхода «Для каждого» небезопасно и может привести к ошибкам или пропуску строк. Лучше собрать строки на удаление или идти от последней строки к первой, а после обхода выполнить удаление.
Чем отличается доступ к табличной части в модуле объекта и в модуле формы?
В модуле объекта доступна полная табличная часть документа, в модуле формы часто достаточно текущих данных выделенной строки. Массовые изменения всех строк формы удобнее выполнять на сервере, а затем обновлять форму.
Нужно ли отменять проведение документа перед изменением строк?
Если документ проведен, изменение табличной части может быть ограничено или заблокировано конфигурацией. Проверьте статус документа и при необходимости отмените проведение, вносите изменения, а затем проводите документ повторно.
Как проверить, что обход строк отработал правильно?
Сравните количество строк и итоговые суммы до и после обработки, убедитесь в заполнении обязательных реквизитов и отсутствии случайно удаленных строк. Контрольный документ и резервная копия помогут отменить изменения при ошибке.
Можно ли использовать таблицу значений вместо прямого обхода табличной части?
Да, для сложной логики строк можно скопировать в таблицу значений, обработать их отдельно и записать результат обратно в табличную часть. Это упрощает отладку, но требует аккуратного сопоставления строк при обратной записи.