Загрузка и отображение таблицы значений на форме 1С

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

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

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

Создание и инициализация объекта ТаблицаЗначений

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

Например, если вам нужно вывести список номенклатуры с ценами, вы создадите колонки "Номенклатура" (тип СправочникСсылка.Номенклатура) и "Цена" (тип Число). После определения структуры можно приступать к наполнению. Добавление строк происходит через метод Добавить, который возвращает ссылку на новую строку, позволяя сразу заполнить её значения.

Вот пример кода, демонстрирующий создание простой таблицы:

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

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

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

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

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

• 📊 Поле ввода позволяет редактировать данные непосредственно в ячейках таблицы, если это разрешено свойствами.
• 👁️ Только просмотр отключает возможность изменения ячеек пользователем, что полезно для отчетов.
• 🔍 Поиск и сортировка могут быть включены через настройки элемента для удобства навигации по большому массиву данных.

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

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

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

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

Частой ошибкой является попытка вывести таблицу, не привязав её к реквизиту. В таком случае табличное поле будет пустым, так как оно "смотрит" на реквизит формы, а не на локальную переменную модуля. Правильная последовательность действий: создать таблицу, наполнить её, а затем присвоить её реквизиту формы, например, Объект.МояТаблица = ТабДанных.

Почему данные не видны на форме?

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

Также стоит рассмотреть ситуацию, когда таблицу нужно обновлять динамически. Например, при нажатии кнопки "Заполнить". В этом случае вы очищаете текущую таблицу через метод Очистить() и заново наполняете её, после чего платформа автоматически обновит отображение на клиенте, так как привязка уже установлена.

Настройка отображения колонок и заголовков

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

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

Имя колонки	Тип данных	Рекомендуемый формат	Выравнивание
Номенклатура	СправочникСсылка	─	По левому краю
Количество	Число	ЧЦ=15; ЧДЦ=0	По центру
Сумма	Число	ЧЦ=15; ЧДЦ=2; ЧВН=0	По правому краю
ДатаОперации	Дата	ДФ="dd.MM.yyyy"	По центру

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

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

Загрузка данных из внешних файлов Excel и CSV

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

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

При чтении CSV файлов важно правильно указать разделитель (запятая, точка с запятой или табуляция). Неправильный выбор разделителя приведет к тому, что вся строка файла попадет в одну ячейку таблицы 1С. Также стоит учитывать кодировку файла, обычно это UTF-8 или Windows-1251.

⚠️ Внимание: При загрузке больших файлов (более 10 000 строк) процесс может занять значительное время и заблокировать интерфейс. Рекомендуется использовать фоновые задания или выводить индикатор прогресса для пользователя.

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

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

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

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

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

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

Наиболее вероятная причина — отсутствие связи между переменной в модуле и реквизитом формы. Убедитесь, что вы присваиваете объект ТаблицаЗначений именно реквизиту формы (например, Объект.МояТаблица), а не просто создаете локальную переменную. Также проверьте, что код наполнения таблицы выполняется до момента открытия окна формы.

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

Да, объект ТаблицаЗначений имеет метод Сортировать. Вы можете передать в него имя колонки и направление сортировки (например, "Цена Убыв"). Это изменит порядок строк в самой таблице, и изменения автоматически отразятся на форме.

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

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

Можно ли использовать ТаблицуЗначений для хранения картинок?

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