Как вывести список на форму 1С: полное руководство разработчика

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

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

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

Выбор типа списка: Динамический или ТаблицаЗначений

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

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

Рассмотрим ключевые различия в таблице ниже, чтобы вы могли принять взвешенное решение перед началом разработки:

Характеристика	ДинамическийСписок	ТаблицаЗначений (Реквизит)
Источник данных	Объект метаданных (Справочник, Регистр)	Произвольный алгоритм или ручной ввод
Поддержка отборов	Автоматическая (через панель отборов)	Только программная реализация
Производительность	Высокая (оптимизированные запросы)	Зависит от объема данных в памяти
Сложность настройки	Низкая (конструктор форм)	Средняя/Высокая (требуется код)

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

Создание формы и добавление элемента списка

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

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

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

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

Настройка колонок и отображаемых полей

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

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

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

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

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

Программное заполнение ТаблицыЗначений

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

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

Процедура ЗаполнитьСписок()
Таблица = РеквизитФормыВЗначение("СписокТоваров");
Таблица.Очистить();

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Номенклатура.Ссылка, Номенклатура.Наименование ИЗ Справочник.Номенклатура КАК Номенклатура";
Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.Товар = Выборка.Ссылка;
НоваяСтрока.Наименование = Выборка.Наименование;
КонецЦикла;

ЗначениеВРеквизитФормы(Таблица, "СписокТоваров");
КонецПроцедуры

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

Реализация отборов и поиска в списке

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

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

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

Как работает внутренний механизм отбора?

Динамический список формирует SQL-запрос с условием WHERE на основе установленных отборов. Это означает, что фильтрация происходит на стороне СУБД, что обеспечивает высокую скорость работы даже с миллионами записей.

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

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

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

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

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

⚠️ Внимание: При работе с управляемыми формами помните о разделении контекста выполнения. События, связанные с интерфейсом (клиентские), выполняются на стороне клиента, а доступ к данным базы — на сервере. Для взаимодействия используйте экспортные процедуры и контекст.

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

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

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

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

Как сделать колонку списка доступной для редактирования?

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

Можно ли вывести иерархический список на форму?

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

Как скрыть колонку списка программно?

Используйте клиентский код в событии ПриСозданииНаКлиенте. Обратитесь к элементу таблицы, найдите нужную колонку в коллекции Колонки и установите свойство Видимость в Ложь.

Что делать, если данные в списке не обновляются после записи объекта?

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