Заполнение табличного документа на форме 1С

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

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

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

Инициализация и свойства элемента формы

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

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

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

⚠️ Внимание: Если свойство РежимТабличногоДокумента установлено в «ТолькоПросмотр», любые попытки программно изменить значение ячейки после отображения формы могут быть проигнорированы или вызвать ошибку, в зависимости от контекста выполнения кода.

После настройки свойств в модуле формы создается переменная, в которую будет помещаться объект документа. Обычно это делается в обработчике события ПриСозданииНаСервере или ПриОткрытии. Инициализация выглядит следующим образом:

ТабДок = Новый ТабличныйДокумент;
Элементы.ТабличноеПоле.Документ = ТабДок;

Работа с макетами и областями

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

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

• 📄 ОбластьЗаголовок — используется для вывода шапки таблицы с названиями колонок.
• 📊 ОбластьСтрока — основной шаблон, который тиражируется для каждой записи выборки.
• 🏁 ОбластьИтог — специальная область для вывода итоговых сумм в конце документа.

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

Алгоритм динамического заполнения данными

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

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

ТабДок.Очистить();
ОбластьСтрока = Макет.ПолучитьОбласть("Строка");

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

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

⚠️ Внимание: Не выполняйте вывод областей внутри транзакций или в тяжелых вычислительных циклах на клиенте без необходимости. Каждая операция вывода влияет на время отрисовки интерфейса.

Настройка размеров и форматирование ячеек

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

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

Свойство	Тип значения	Описание
ШиринаКолонки	Число	Задает ширину колонки в символах или пикселях
ВысотаСтроки	Число	Фиксирует высоту строки, отключая автоподбор
ОриентацияСтраницы	Перечисление	Портретная или альбомная ориентация для печати
Поля	Структура	Настройка полей страницы для корректной печати

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

Секрет идеального выравнивания

Если текст в ячейке не влезает и переносится некорректно, попробуйте установить свойство области "ВертикальноеВыравнивание" в значение "ПоЦентру" и включить "АвтоОбрезкаСтрок".

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

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

Используйте метод НачатьИзменение перед началом цикла заполнения и ЗакончитьИзменение после его завершения. Это сообщит системе, что серия изменений является атомарной, и перерисовка формы произойдет только один раз в самом конце, что даст кратный прирост скорости.

ТабДок.НачатьИзменение();

//.. цикл вывода областей..

ТабДок.ЗакончитьИзменение();

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

Использование пары методов НачатьИзменение() и ЗакончитьИзменение() может ускорить отрисовку таблицы из 1000 строк в 5-10 раз по сравнению с построчным выводом без блокировки обновления экрана.

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

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

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

• 🖱️ Событие Выбор — срабатывает при двойном клике или нажатии Enter на активной ячейке.
• ✏️ Событие ПриИзменении — фиксирует факт редактирования данных пользователем в режиме редактирования.
• 📋 Событие НачалоВыбора — позволяет подставить значение из списка при вводе в ячейку.

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

⚠️ Внимание: Интерфейс 1С и поведение элементов управления могут незначительно отличаться в зависимости от версии платформы (8.3.10, 8.3.20 и т.д.) и типа клиента (Тонкий, Веб, Толстый). Всегда тестируйте поведение форм в том клиенте, который используется основными пользователями.

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

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

Почему табличный документ на форме не печатается корректно?

Чаще всего проблема в настройках полей страницы или ориентации. Проверьте свойства Поля и ОриентацияСтраницы у объекта ТабличныйДокумент перед вызовом метода Печать(). Также убедитесь, что ширина колонок не превышает ширину печатной области.

Можно ли объединять ячейки в табличном документе на форме динамически?

Да, это можно сделать программно, используя метод ОбъединитьЯчейки объекта ТабличныйДокумент, указав координаты начальной и конечной ячейки. Однако проще и надежнее предусмотреть объединение в самом макете, если структура отчета известна заранее.

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

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

В чем разница между ТабличнымДокументом и ПолеТабличногоДокумента?

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