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

Другое · 6 мин

Изменение данных в табличной части документа 1С программно

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

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

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

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

Как получить объект документа для редактирования

Для работы с существующим документом используйте ссылку на документ и метод ПолучитьОбъект(). Такой объект открывается в режиме редактирования, что позволяет изменять реквизиты и строки табличной части. Если документа ещё нет, создайте его через СоздатьДокумент(), заполните основные реквизиты и только потом вносите изменения в табличную часть.

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

Порядок действий
  1. 1
    Получить объект документа через ссылку или создать новый
  2. 2
    Обратиться к табличной части по имени реквизита
  3. 3
    Найти нужную строку или добавить новую
  4. 4
    Изменить значения полей строки
  5. 5
    Сохранить документ методом Записать()
  6. 6
    Проверить результат повторным чтением

Как изменить существующие строки табличной части

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

Пример логики: получить коллекцию строк, найти строку, где Номенклатура равна нужному значению, обновить Количество и Сумму, прервать цикл и вызвать Записать(). Если подходящих строк несколько, решите заранее, менять все подходящие или только первую найденную.

Добавление и удаление строк

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

Особенности проведения и сохранения

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

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

Частые ошибки при программной правке

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

Ещё одна ошибка — изменение индексов при удалении строк в цикле «Для каждого». Если удалять строки по порядку с начала, часть строк может быть пропущена. Также не забудьте сохранить документ: изменения в объекте не попадают в базу без вызова Записать().

Типичные ошибки
01
Неверное имя табличной части — код не найдёт нужную коллекцию строк
02
Удаление строк по индексу в прямом цикле — часть строк пропускается
03
Изменение проведённого документа без отмены проведения — нарушение регистров
04
Забыть вызвать Записать() — изменения не сохраняются в базе

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

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

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

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

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

Значения полей в табличной части после записи
Норма

Соответствуют заданным в коде значениям

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

Поля не изменились или изменились не те строки

Состояние документа
Норма

Документ сохранён и, при необходимости, проведён

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

Документ не записан или проведение завершилось ошибкой

Остатки и регистры
Норма

Без неожиданных изменений после правки

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

Появились расхождения с первичными данными

Когда лучше не использовать программную правку

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

Не пишите код «на авось» в боевой базе без тестирования на копии. Сначала отработайте сценарий на обучающей или тестовой информационной базе, проверьте поведение при проведении и отмене проведения, а только потом переносите решение в производство.

Итог

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

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

Нужно ли создавать документ заново, чтобы изменить табличную часть?

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

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

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

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

Проверьте, вызван ли метод Записать(), правильно ли указано имя табличной части и найдена ли строка по условию. Также убедитесь, что документ не заблокирован другим пользователем и у текущего сеанса есть права на запись.

Безопасно ли удалять строки в цикле «Для каждого»?

Не всегда. При удалении по индексу с начала номера строк сдвигаются, и некоторые строки могут быть пропущены. Безопаснее идти от конца к началу или заранее собрать индексы строк для удаления.