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