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