1С: как заполнить таблицу формы из таблицы значений

Таблица значений — это объект встроенного языка 1С, который существует только в памяти на сервере, а таблица формы — элемент интерфейса, связанный с реквизитом формы типа «ТаблицаЗначений» или «ДанныеФормыКоллекция». Напрямую присвоить один объект другому нельзя: между ними разные типы данных и разные контексты выполнения. Поэтому перенос делается через специальные методы платформы.

Задача возникает постоянно: данные получены запросом, загружены из файла или собраны программно в таблицу значений, и теперь их нужно показать пользователю на форме. В зависимости от того, где выполняется код (на сервере или на клиенте) и какой тип у реквизита формы, применяются разные подходы — метод Загрузить(), преобразование ЗначениеВДанныеФормы() или построчное заполнение.

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

Как устроены таблица значений и таблица формы

Таблица значений (ТаблицаЗначений) — несериализуемый объект, доступный только на сервере (и в толстом клиенте). У неё есть колонки с явными типами, строки, индексы и методы выборки. Реквизит управляемой формы визуально выглядит так же, но физически это ДанныеФормыТаблица или ДанныеФормыКоллекция — специальные типы, которые платформа умеет передавать между клиентом и сервером.

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

Способ 1: метод Загрузить() для реквизита формы

Самый короткий путь — когда реквизит формы имеет тип «ТаблицаЗначений». Тогда у него доступен метод Загрузить(), который принимает готовую таблицу значений и полностью заменяет содержимое реквизита. Важно: вызывать его нужно в серверном контексте, через обёртку РеквизитФормыВЗначение() или напрямую, если платформа позволяет обратиться к реквизиту как к таблице.

Типовой код в серверной процедуре формы:

&НаСервере
Процедура ЗаполнитьТаблицуНаСервере()
ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Номенклатура", Новый ОписаниеТипов("СправочникСсылка.Номенклатура"));
ТЗ.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));
// ... заполнение ТЗ данными, например из запроса
ТаблицаФормы.Загрузить(ТЗ);
КонецПроцедуры

Имена колонок таблицы значений должны совпадать с именами колонок реквизита формы. Лишние колонки в источнике могут вызвать ошибку либо будут проигнорированы в зависимости от версии платформы, поэтому безопаснее формировать таблицу-источник строго под структуру приёмника.

Способ 2: ЗначениеВДанныеФормы для ДанныеФормыКоллекция

Если реквизит формы — это табличная часть объекта (например, вы открыли форму документа) или коллекция типа ДанныеФормыКоллекция, метод Загрузить() напрямую недоступен. Здесь используется связка ЗначениеВДанныеФормы() и ДанныеФормыВЗначение(), либо промежуточная таблица значений.

Для табличной части документа перенос выглядит так:

&НаСервере
Процедура ЗаполнитьТЧНаСервере()
ОбъектДокумента = РеквизитФормыВЗначение("Объект");
ОбъектДокумента.Товары.Загрузить(ТЗИзЗапроса);
ЗначениеВРеквизитФормы(ОбъектДокумента, "Объект");
КонецПроцедуры

Для самостоятельного реквизита типа ДанныеФормыКоллекция удобнее использовать ЗначениеВДанныеФормы(ТЗ, РеквизитФормы) — платформа сама скопирует строки и типы. Этот приём не требует пересоздания объекта и сохраняет остальные реквизиты формы нетронутыми.

ЗначениеВДанныеФормы(ТаблицаЗначенийИсточник, ЭтаФорма.РеквизитТаблица);

Почему заполнение делается только на сервере

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

Если данные нужно собрать по интерактивным действиям пользователя, передавайте на сервер только параметры (отборы, даты, ссылки), а не сами данные. Это снижает объём трафика между клиентом и сервером и упрощает отладку.

1. 1
   Создайте реквизит формы типа ТаблицаЗначений и перетащите его на форму как табличное поле
2. 2
   В клиентской процедуре команды вызовите серверную процедуру заполнения
3. 3
   На сервере создайте ТаблицаЗначений с колонками, совпадающими по именам с колонками реквизита
4. 4
   Заполните таблицу данными из запроса или программно
5. 5
   Вызовите Реквизит.Загрузить(ТЗ) или ЗначениеВДанныеФормы(ТЗ, Реквизит)
6. 6
   Откройте форму и проверьте, что строки отобразились

Совпадение типов колонок и типичные ошибки

Самая частая причина пустой таблицы на форме — несовпадение имён колонок. Если в таблице значений колонка называется Товар, а в реквизите формы — Номенклатура, данные молча не перенесутся или появится ошибка. Перед загрузкой полезно сравнить состав колонок источника и приёмника.

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

Проверка результата и отладка

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

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

FAQ