Вывод табличных данных на форму в 1С

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

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

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

Подготовка структуры данных и реквизитов формы

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

Создайте новый реквизит формы в конструкторе объектов. Назовите его, например, ТаблицаДанных. Укажите тип ТаблицаЗначений. На вкладке «Колонки» необходимо добавить поля, которые станут заголовками вашей будущей таблицы. Например, если вы выводите список товаров, создайте колонки «Номенклатура» (тип СправочникСсылка.Номенклатура), «Количество» (тип Число) и «Цена» (тип Число).

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

Размещение элемента ТабличноеПоле на форме

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

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

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

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

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

Сначала создаем экземпляр таблицы в коде, добавляем колонки (если они не были созданы в метаданных формы заранее) и заполняем строки. Затем полученный объект присваиваем реквизиту формы.

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

// Заполнение данными (пример)
Строка = Таб.Добавить();
Строка.Товар = Справочники.Номенклатура.НайтиПоНаименованию("Стол");
Строка.Остаток = 15;

Объект.ТаблицаДанных = Таб;
КонецПроцедуры

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

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

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

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

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

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

Тип условия	Пример выражения	Действие	Применение
Сравнение	Остаток < 0	Цвет текста: Красный	Ячейка
Равенство	Статус = "Закрыт"	Цвет фона: Серый	Строка
Диапазон	Сумма > 1000000	Шрифт: Жирный	Ячейка
Заполненность	Комментарий = Неопределено	Пиктограмма: Восклицательный знак	Ячейка

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

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

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

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

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

Процедура ТаблицаДанныхВыбор(Элемент, ВыбраннаяСтрока, Колонка, Поле, СтандартнаяОбработка)
Если ВыбраннаяСтрока.Товар <> Неопределено Тогда
// Открытие формы элемента
ФормаЭлемента = ВыбраннаяСтрока.Товар.ПолучитьФорму("ФормаЭлемента");
ФормаЭлемента.ОткрытьМодально();
КонецЕсли;
КонецПроцедуры

Если таблица редактируемая, событие ПриИзменении срабатывает при потере фокуса ячейкой. Здесь удобно делать пересчеты «на лету». Например, при изменении количества автоматически пересчитывать сумму строки. Не забудьте вызвать ОбновитьТаблицу() или аналогичные методы, если данные меняются программно внутри обработчика, чтобы интерфейс отрисовал новые значения.

Динамическое управление видимостью и шириной

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

Обращение к колонке табличного поля происходит через индекс или имя. Пример кода для скрытия колонки: Элементы.ТаблицаДанных.Колонки.Остаток.Видимость = Ложь;. Это изменение применяется мгновенно и сохраняется в рамках текущей сессии, если не прописана логика сохранения настроек пользователя.

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

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

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

Как сделать таблицу редактируемой прямо на форме?

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

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

Чаще всего проблема в том, что данные записаны в локальную переменную, но не присвоены реквизиту формы. Убедитесь, что вы делаете присваивание: Объект.ИмяРеквизита = ТаблицаЗначений. Также проверьте, не скрыта ли таблица условным оформлением или свойством Видимость.

Можно ли добавить кнопку удаления строки внутрь таблицы?

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

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

Сортировку можно задать программно после заполнения таблицы методом Таблица.Сортировать("Колонка1 Убыв, Колонка2 Возр"). Либо разрешить пользователю сортировку, установив свойство ПользовательскаяСортировка в значение Истина, тогда заголовки колонок станут кликабельными.