Как сделать динамический список в 1С Предприятие

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

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

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

Основы работы со списками в платформе 1С

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

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

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

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

Настройка источника данных через СКД

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

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

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

• 📊 Набор данных: определяет физическую таблицу или текст запроса.
• ⚙️ Параметры: переменные, значения которых передаются в запрос при обновлении.
• 🎨 Оформление: правила изменения цвета и шрифта ячеек в зависимости от значений.

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

Программное управление списком на клиенте

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

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

Отбор = ДинамическийСписок.Отбор;
Отбор.Очистить();
НовыйОтбор = Отбор.Добавить("Менеджер", ВидСравнения.Равно);
НовыйОтбор.Значение = ВыбранныйМенеджер;

Без этого шага пользователь не увидит новых данных, даже если логика отработала корректно. Также следует учитывать, что обновление может занять время, поэтому для тяжелых выборок рекомендуется использовать индикаторы прогресса.

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

Реализация сложных отборов и фильтров

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

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

Для программной установки сложных отборов, включающих логические операторы И и ИЛИ, используется структура ГруппаОтборов. Вы можете вкладывать группы друг в друга, создавая древовидную структуру условий. Это позволяет реализовать сценарии вроде: «Показать документы, где сумма больше 1000 ИЛИ статус равен "Оплачен"».

Тип отбора	Описание	Пример использования
Простой	Сравнение поля со значением	Контрагент = "ООО Ромашка"
Группа (И)	Все условия должны выполняться	Дата > НачалоПериода И Дата < КонецПериода
Группа (ИЛИ)	Достаточно выполнения одного условия	Статус = "Новый" ИЛИ Статус = "В работе"
В группе	Вхождение значения в список	Валюта В ("USD", "EUR", "RUB")

⚠️ Внимание: Избегайте использования функций в левой части условий отбора (например, Год(Дата) = 2026). Это запрещает использование индексов и приводит к полному сканированию таблицы, что критично замедляет работу.

Как оптимизировать отбор по строкам?

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

Обработка событий и обновление интерфейса

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

В обработчике этого события вы считываете значения из элементов управления (поля ввода, переключатели, таблицы) и присваиваете их параметрам динамического списка. Если параметры не будут переданы корректно, список либо не обновится, либо выдаст ошибку выполнения запроса.

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

• 🔄 ОбновлениеСписков: основное событие для синхронизации параметров.
• 👁️ НачалоПолученияДанных: позволяет показать индикатор загрузки.
• ✅ КонецПолученияДанных: используется для скрытия индикатора и анализа результатов.

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

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

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

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

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

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

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

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

Как добавить кнопку экспорта динамического списка в Excel?

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

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

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

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

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

Как скрыть служебные колонки (например, Ссылка) от пользователя?

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

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

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