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

Другое · 7 мин

Программное добавление табличной части на форму в 1С

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

Задача добавить табличную часть на форму в 1С возникает, когда нужно заполнить строки вложенного реестра прямо на экране перед сохранением документа или справочника. Табличная часть может быть привязана к свойству объекта конфигурации, а может выводиться на форме как отдельный элемент. От этого зависит, с каким объектом работать: с данными самого объекта или с элементом формы.

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

Разница между управляемыми и обычными формами существенна. На управляемых формах строки добавляются через коллекцию Строк элемента формы, а на обычных — через табличное поле и его методы. Смешивание подходов приводит к ошибкам, поэтому сначала нужно определить тип формы.

Хранение данных и отображение на форме

Табличная часть объекта — это свойство конфигурационного объекта типа «Таблица значений» или вложенный реестр документов. Она существует независимо от формы и сохраняется при записи объекта. Элемент формы — это визуальное представление, которое выводит эти данные пользователю. Можно добавить строку в объект, но не увидеть её на форме, если элемент формы не связан с этим свойством или не обновлён.

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

Когда программное добавление оправдано

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

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

Управляемая форма: порядок действий

На управляемой форме строка добавляется в элемент формы, а затем привязывается к данным объекта. Типичная последовательность:

1. Открыть форму модуля объекта или формы документа.

2. Найти элемент формы, соответствующий табличной части.

3. Вызвать метод Добавить у коллекции Строк этого элемента.

4. Заполнить реквизиты новой строки.

5. При необходимости записать объект.

Пример кода на встроенном языке:

&НаСервере
Процедура ДобавитьСтрокуТабличнойЧасти()
НоваяСтрока = ЭлементыФормы.ТабличнаяЧасть.Строки.Добавить();
НоваяСтрока.Номенклатура = Объект.Номенклатура;
НоваяСтрока.Количество = 1;
НоваяСтрока.Цена = Объект.Цена;
КонецПроцедуры

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

Обычные формы и их особенности

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

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

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

Строка появилась в табличной части после добавления
Норма

Строка отображается с заполненными реквизитами

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

Строка отсутствует или форма выдаёт ошибку

Данные сохраняются после записи объекта
Норма

При повторном открытии строки на месте

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

Строка исчезает после закрытия формы

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

Проверка результата и сохранение

После добавления строки проверьте, что строка появилась в списке, реквизиты заполнены корректно, а после записи объекта данные остались в базе. Если строка исчезает при закрытии формы, скорее всего, она была добавлена только в элемент формы, но не сохранена в объекте.

Типичные ошибки
01
Добавление строки только в элемент формы без записи объекта — данные пропадают после закрытия формы.
02
Использование кода для управляемых форм на обычной форме — ошибки синтаксиса и отсутствие результата.

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

Ограничения, ошибки и риски

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

Сравнение вариантов

Программное добавление строк

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

Ручное заполнение пользователем

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

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

Когда не стоит программировать добавление

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

Итог

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

Добавляйте строки в существующую табличную часть, учитывайте тип формы и сохраняйте объект после изменений.

Нужно ли менять конфигурацию, чтобы добавить табличную часть на форму?

Если табличная часть уже есть в объекте и на форме, менять конфигурацию не нужно: достаточно добавить строки программно. Если табличной части нет ни в объекте, ни на форме, сначала потребуется добавить свойство табличной части в конфигурацию и разместить его на форме.

Работает ли один и тот же код на управляемых и обычных формах?

Нет. На управляемых формах используется коллекция Строк элемента формы, на обычных — табличное поле и его методы. Код нужно писать отдельно для каждого типа формы.

Почему добавленная строка исчезает после закрытия формы?

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

Можно ли добавить табличную часть, которой нет в конфигурации?

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