Как добавить динамический список на форму 1С

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

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

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

Подготовка реквизитов формы и модуля объекта

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

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

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

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

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

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

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

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

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
СписокДанных = Новый СписокЗначений;
СписокДанных.Добавить("Значение1", "Представление1");
СписокДанных.Добавить("Значение2", "Представление2");
Объект.СписокКонтрагентов = СписокДанных;
КонецПроцедуры

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

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

Вывод списка на форму: элементы управления

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

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

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

• 📊 Используйте свойство Оформление для выделения цветом строк в зависимости от статуса данных.
• 🔍 Включите БыстрыйОтбор, если список содержит более 20 строк, чтобы пользователю было удобно искать.
• 🔒 Ограничьте редактирование через свойство ТолькоПросмотр, если данные являются справочными.

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

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

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

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

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

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

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

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

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

Метод оптимизации	Эффект	Сложность внедрения
Отбор данных в запросе	Высокий	Низкая
Виртуальные таблицы	Средний	Средняя
Асинхронная загрузка	Высокий	Высокая
Кэширование на клиенте	Средний	Средняя

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

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

Частые ошибки и способы их устранения

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

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

Секрет работы с большими списками

Если список превышает 10 000 строк, рассмотрите возможность использования постраничной загрузки или виртуального скроллинга, хотя стандартными средствами 1С это реализуется сложно. Чаще всего проблема решается грамотным отбором данных на этапе запроса.

Также стоит упомянуть проблему контекста выполнения. Код, работающий с элементами формы, часто должен выполняться на клиенте, а работа с базой данных — на сервере. Нарушение этого правила приведет к ошибкам вызова серверного контекста из клиента. Используйте модификаторы &НаКлиенте и &НаСервере корректно.

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

Можно ли использовать динамический список в качестве источника для отчета СКД?

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

Как сохранить данные динамического списка при закрытии формы?

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

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

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

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

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