Программное создание динамических списков на формах 1С

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• 📊 Идентификатор — уникальное имя поля внутри списка, используемое в коде.
• 📝 Заголовок — текст, отображаемый в шапке колонки таблицы на форме.
• 🔗 ПутьКДанным — указывает, из какого атрибута или выражения брать значение.
• ⚙️ Настройки — позволяют задать формат вывода, например, для дат или денежных сумм.

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

ПолеСсылка = СписокДанных.Поля.Добавить("Ссылка");
ПолеСсылка.Заголовок = "Номенклатура";
ПолеСсылка.ПутьКДанным = "Ссылка";

ПолеНаименование = СписокДанных.Поля.Добавить("Наименование");
ПолеНаименование.Заголовок = "Название";
ПолеНаименование.ПутьКДанным = "Наименование";

Наполнение списка данными через запрос

Самый ответственный этап — наполнение списка данными. Для этого используется метод Заполнить, который принимает на вход текст запроса или объект КомпоновкаДанных. Использование запроса является наиболее производительным способом, так как позволяет отфильтровать данные на стороне СУБД.

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

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

Оптимизация запросов

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

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

Элемент списка	Тип данных 1С	Описание
Ссылка	СправочникСсылка	Уникальный идентификатор объекта
Наименование	Строка	Текстовое представление объекта
Артикул	Строка	Дополнительный код товара
Количество	Число	Количественный показатель

Код выполнения запроса выглядит лаконично. Метод Заполнить автоматически выполнит запрос и распределит результаты по строкам списка. После этого данные станут доступны для отображения на клиенте.

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

СписокДанных.Заполнить(ТекстЗапроса);

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

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

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

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

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

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

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

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

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

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

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

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

Процедура СписокДанныхВыбор(Элемент, ВыбраннаяСтрока, Поле, Расширение)
Если ВыбраннаяСтрока.Пустая() Тогда
Возврат;
КонецЕсли;

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

Оптимизация производительности и отладка

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

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

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

• 🚀 Индексация — убедитесь, что поля, участвующие в отборе и сортировке, проиндексированы в базе данных.
• 📉 Лимиты — установите ограничение на количество возвращаемых строк (ТОП N) для тестовых выборок.
• 🧹 Очистка — перед повторным заполнением списка очищайте его, чтобы избежать дублирования данных.

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

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

Можно ли редактировать данные прямо в динамическом списке?

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

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

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

Поддерживает ли динамический список группировку строк?

Да, группировка настраивается через свойства элемента формы или программно через объект НастройкиДинамическогоСписка, аналогично настройкам отчета.

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

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

Обязательно ли указывать тип значения для списка?

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