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