Динамический список в 1С: устройство, настройка и практика работы

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

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

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

Что такое динамический список и как он устроен

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

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

При этом динамический список живёт только внутри формы. Программно обратиться к нему можно через имя реквизита формы, например Список.ТекстЗапроса или Список.КомпоновщикНастроек. Сам по себе, вне формы, как самостоятельный объект он не существует.

Основная таблица и произвольный запрос

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

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

ВЫБРАТЬ
	Док.Ссылка КАК Ссылка,
	Док.Номер КАК Номер,
	Док.Дата КАК Дата,
	ЕСТЬNULL(Остатки.КоличествоОстаток, 0) КАК Остаток
ИЗ
	Документ.ЗаказПокупателя КАК Док
	ЛЕВОЕ СОЕДИНЕНИЕ РегистрНакопления.ТоварыНаСкладах.Остатки КАК Остатки
	ПО Док.Склад = Остатки.Склад

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

Настройка отборов, сортировки и группировки

Динамический список построен на системе компоновки данных, поэтому отборы и сортировка настраиваются через КомпоновщикНастроек. Разработчик может задать настройки по умолчанию в конфигураторе, а пользователь — менять их через кнопку «Ещё → Настроить список» прямо в режиме предприятия.

Программная установка отбора требуется, когда форма открывается с параметрами — например, список документов по конкретному контрагенту. Обычно это делается в обработчике ПриСозданииНаСервере: добавляется элемент отбора в настройки компоновщика с нужным полем, видом сравнения и значением.

1. 1
   В обработчике ПриСозданииНаСервере обратитесь к Список.КомпоновщикНастроек.Настройки.Отбор
2. 2
   Добавьте элемент: НовыйЭлемент = Отбор.Элементы.Добавить(Тип("ЭлементОтбораКомпоновкиДанных"))
3. 3
   Задайте ЛевоеЗначение = Новый ПолеКомпоновкиДанных("Контрагент")
4. 4
   Установите ВидСравнения = Равно, ПравоеЗначение = параметр, Использование = Истина
5. 5
   Откройте форму и проверьте, что список отфильтрован, а отбор виден пользователю

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

Производительность: что тормозит список

Главный источник проблем — тяжёлый произвольный запрос. Соединения с виртуальными таблицами без отборов, вложенные запросы, функции в условиях соединения — всё это заставляет СУБД перечитывать большие объёмы при каждой прокрутке и каждом обновлении списка.

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

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

Динамический список против таблицы значений и запроса

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

Эмпирическое правило простое: если пользователю нужно смотреть актуальные данные и открывать объекты — берите динамический список; если нужно вводить или менять данные прямо в таблице — таблицу значений; если нужен анализ с итогами — отчёт.

Типичные ошибки и как их проверить

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

Для диагностики медленных списков полезно замерить время выполнения запроса через консоль запросов на копии рабочей базы и посмотреть план запроса средствами СУБД. Часто выясняется, что проблема решается одним параметром виртуальной таблицы или дополнительным индексом.

FAQ: частые вопросы о динамических списках