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

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

Ключевая сложность в том, что на управляемой форме таблица значений хранится не в привычном виде, а в специальном контейнере ДанныеФормыКоллекция. Платформа автоматически преобразует реквизит формы при сериализации, и работать с ним напрямую методами Добавить() и Найти() объектной таблицы значений нельзя — нужны специальные приёмы.

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

Создание реквизита формы типа «Таблица значений»

Первый шаг — добавить реквизит в структуру формы. Откройте форму в конфигураторе, перейдите на закладку «Реквизиты» в правой части редактора формы и нажмите «Добавить». В свойстве «Тип» выберите ТаблицаЗначений. После этого реквизит появится в дереве, но пока без единой колонки.

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

Обратите внимание на свойство «Сохраняемые данные» у реквизита. Оно влияет на то, будет ли содержимое таблицы передаваться между клиентом и сервером при каждом вызове. Для больших таблиц (тысячи строк) передача данных при каждом серверном вызове замедляет форму — в таких случаях стоит пересмотреть архитектуру и обрабатывать данные порциями.

Вывод таблицы на форму

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

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

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

Программное заполнение таблицы на сервере

Наиболее надёжный способ заполнить таблицу большим объёмом данных — сделать это в серверной процедуре через промежуточный объект ТаблицаЗначений. Это позволяет использовать запросы, выгрузку результатов и все объектные методы.

&НаСервере
Процедура ЗаполнитьТаблицуНаСервере()

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ ПЕРВЫЕ 100
|   Номенклатура.Ссылка КАК Номенклатура,
|   Номенклатура.Артикул КАК Артикул
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура";

ТЗ = Запрос.Выполнить().Выгрузить();

ТаблицаНаФорме.Очистить();
ЗначениеВДанныеФормы(ТЗ, ТаблицаНаФорме);

КонецПроцедуры

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

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

Заполнение таблицы на клиенте

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

&НаКлиенте
Процедура ДобавитьСтроку(Команда)

НоваяСтрока = ТаблицаНаФорме.Добавить();
НоваяСтрока.Наименование = "Новая позиция";
НоваяСтрока.Количество = 1;

КонецПроцедуры

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

Чтение и обработка данных из таблицы формы

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

&НаСервере
Процедура ОбработатьТаблицуНаСервере()

ТЗ = РеквизитФормыВЗначение("ТаблицаНаФорме");
ТЗ.Свернуть("Номенклатура", "Количество");
ЗначениеВДанныеФормы(ТЗ, ТаблицаНаФорме);

КонецПроцедуры

Обратите внимание: РеквизитФормыВЗначение принимает имя реквизита строкой, а ЗначениеВДанныеФормы — сам объект реквизита. Это частая причина путаницы. Пара таких вызовов «туда-обратно» — стандартный приём для серверной обработки данных формы.

Для простого перебора строк без преобразования можно обойтись и прямым обходом: Для Каждого Строка Из ТаблицаНаФорме Цикл работает и на клиенте, и на сервере без дополнительных преобразований.

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

Типичные ошибки и их устранение

Больше всего проблем возникает из-за путаницы между ТаблицаЗначений и ДанныеФормыКоллекция. Вторая по частоте причина — вызов серверных методов с попыткой передать реквизит формы как параметр в общий модуль: платформа не сериализует ДанныеФормыКоллекция для такой передачи, поэтому сначала преобразуйте её в объектную таблицу.

Отдельный случай — динамическое изменение состава колонок. Если структура таблицы должна меняться в зависимости от настроек, обычного реквизита недостаточно: нужно программно добавлять реквизиты через массив ИзменитьРеквизиты() и создавать элементы формы вручную. Это рабочий, но трудоёмкий путь; если колонок много и они известны заранее, проще создать все в конфигураторе и управлять видимостью.

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

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

Частые вопросы