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

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

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

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

Использование объекта ТаблицаЗначений

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

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

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

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

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Номенклатура", СправочникСсылка.Номенклатура);
ТЗ.Колонки.Добавить("Количество", ТипОписанияТипов("Число(15,2)"));
ТЗ.Колонки.Добавить("Сумма", ТипОписанияТипов("Число(15,2)"));

Для Каждого ТекСтрока Из Выборка Цикл
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Номенклатура = ТекСтрока.Номенклатура;
НоваяСтрока.Количество = ТекСтрока.Количество;
КонецЦикла;

Объект.ТаблицаРасчетов = ТЗ;

Применение динамических списков

Когда требуется не просто отобразить данные, но и обеспечить полноценную работу с ними (сортировку, отборы, поиск) с минимальными затратами ресурсов, идеальным решением становится Динамический список. Этот механизм позволяет привязать таблицу на форме непосредственно к виртуальной таблице или запросу, delegating работу с данными серверу.

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

• 🚀 Высокая производительность при работе с большими объемами данных за счет постраничной загрузки.
• ⚙️ Автоматическая поддержка стандартных механизмов отборов, группировок и сортировок без написания дополнительного кода.
• 🔄 Возможность редактирования данных непосредственно в списке с автоматической записью изменений в базу (при правильной настройке).

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

Работа с реквизитом ПолеТаблицы

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

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

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

⚠️ Внимание: При использовании ПолеТаблицы убедитесь, что имена колонок уникальны и не содержат пробелов или специальных символов, которые могут вызвать ошибки парсинга на стороне клиента.

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

В чем разница между ТаблицейЗначений и ПолемТаблицы?

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

Настройка элементов управления на форме

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

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

Параметр настройки	Описание	Рекомендуемое значение
Режим запуска	Определяет, как открывается форма	Обычное или Такси
Отображать заголовок	Показывать ли шапку таблицы	Истина
Высота строки	Фиксированная или авто	Авто
Выделение строки	Подсветка активной строки	Включено

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

Обработка событий и взаимодействие

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

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

&НаКлиенте
Процедура ТаблицаРасчетовПриВыборе(Элемент)

ТекущаяСтрока = Элементы.ТаблицаРасчетов.ТекущиеДанные;
Если ТекущаяСтрока = Неопределено Тогда
Возврат;
КонецЕсли;

// Открытие формы элемента
ПараметрыФормы = Новый Структура;
ПараметрыФормы.Вставить("Ключ", ТекущаяСтрока.Номенклатура);
ОткрытьФорму("Справочник.Номенклатура.Форма.ФормаЭлемента", ПараметрыФормы);

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

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

Оптимизация производительности выгрузки

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

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

⚠️ Внимание: Интерфейс и алгоритмы работы с данными могут отличаться в зависимости от версии платформы 1С:Предприятие. Всегда проверяйте документацию к конкретной версии релиза, если вы используете новые функции или работаете в облачном сервисе.

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

Часто задаваемые вопросы (FAQ)

Можно ли редактировать данные в ТаблицеЗначений на форме?

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

Как очистить таблицу значений перед новым заполнением?

Для очистки используйте метод ТЗ.Очистить(). Это удалит все строки из таблицы, но сохранит структуру колонок. Если нужно удалить и колонки тоже, следует присвоить переменной новое значение Новый ТаблицаЗначений().

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

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

В чем преимущество Динамического списка перед обычной ТЗ?

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