Динамический список в 1С: как создать с нуля за 10 шагов

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

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

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

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

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

🔄 Актуальность данных — изменения в базе сразу отображаются в списке без перезагрузки формы.
⚡ Производительность — загрузка данных порциями (постранично), что снижает нагрузку на сервер.
🔍 Гибкость отборов — пользователи могут фильтровать данные по любым полям без изменения кода.
🛠️ Универсальность — один и тот же список можно использовать в разных формах и отчётах.

Типичные сценарии применения:

📊 Отображение справочников (номенклатура, контрагенты, сотрудники) с возможностью поиска.
📈 Аналитические панели с группировкой данных по периодам или категориям.
📋 Журналы документов (заказы, счета, платежи) с фильтрацией по статусу или дате.

⚠️ Внимание: Динамические списки не подходят для вывода больших объемов данных (свыше 10 000 строк) без дополнительной оптимизации. В таких случаях рассмотрите использование виртуальных таблиц или предопределённых данных.

Подготовка к созданию: что нужно знать до начала работы

Прежде чем приступать к созданию динамического списка, убедитесь, что у вас есть:

Доступ к конфигуратору 1С:Предприятие 8.3 с правами на редактирование.

Понимание структуры базы данных (какие таблицы и поля будут использоваться).

Определённая цель: для чего нужен список (отчёт, справочник, журнал документов).

Также полезно освежить знания по:

📖 Языку запросов 1С — для формирования источника данных.

🎨 Работе с формами — динамический список обычно размещается на форме.

🔐 Правам доступа — настройка видимости данных для разных ролей.

📊 Какой у вас опыт работы с 1С?
Начинающий (менее 1 года)
Средний (1-3 года)
Опытный (более 3 лет)
Я только изучаю

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

⚠️ Внимание: В версиях 1С:Предприятие ниже 8.3.10 некоторые функции динамических списков (например, группировка по нескольким полям) могут работать некорректно. Проверьте версию платформы в меню Справка → О программе.

Шаг 1: Создание источника данных для динамического списка

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

📋 Таблица базы данных (справочник, документ, регистр).

🔄 Запрос (позволяет объединять данные из нескольких таблиц).

📊 Объектный список (например, СправочникОбъект.Номенклатура).

Рассмотрим создание источника на примере запроса. Предположим, нам нужно отобразить список номенклатуры с ценами и остатками.

Откройте конфигуратор и перейдите в раздел Объекты → Динамические списки.

Создайте новый динамический список (кнопка Добавить).

В свойстве Источник данных выберите Запрос.

Нажмите на кнопку Конструктор запроса и сформируйте текст:

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

Обратите внимание на параметр &ТекущаяДата — он позволяет получать актуальные данные на заданную дату. Этот параметр можно будет передавать из формы.

💡
Если в запросе используются виртуальные таблицы (например, РегистрНакопления.ОстаткиНоменклатуры.Остатки), убедитесь, что у пользователя есть права на чтение этих регистров. Иначе список будет пустым, а ошибок в интерфейсе не появится!

Шаг 2: Настройка структуры динамического списка

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

Перейдите на вкладку Структура в свойствах динамического списка и добавьте колонки:

Имя колонки Заголовок Тип данных Выражение Ширина

Ссылка Номенклатура СправочникСсылка.Номенклатура Ссылка 200

Наименование Наименование Строка Наименование 300

Артикул Артикул Строка Артикул 100

Цена Цена, руб. Число Цена 100

Остаток Остаток, шт. Число Остаток 100

Для каждой колонки можно настроить дополнительные свойства:

🔗 Гиперссылка — если поле является ссылкой на объект (например, Ссылка), включите опцию Показывать как ссылку.

📌 Фиксированная ширина — полезно для колонок с небольшим количеством данных (например, Артикул).

🔢 Формат числа — для числовых полей (например, Цена) укажите количество знаков после запятой.

Все необходимые поля добавлены в структуру|

Типы данных колонок соответствуют источникам|

Заданы осмысленные заголовки колонок|

Настроены форматы отображения для числовых полей-->

Критическая ошибка новичков: если не указать выражение для колонки (поле "Выражение"), она будет пустой, даже если данные в источнике есть. Всегда проверяйте соответствие имён колонок и полей в запросе!

Шаг 3: Размещение динамического списка на форме

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

Добавить список на существующую форму (например, форму справочника).

Создать новую форму специально для списка.

Рассмотрим второй вариант, так как он более универсален:

В дереве конфигурации найдите раздел Общие → Формы и создайте новую форму.

Перетащите динамический список из палитры элементов на форму.

В свойствах элемента формы укажите созданный ранее динамический список в поле ДинамическийСписок.

Настройте дополнительные параметры:

🔄 АвтоЗагрузкаДанных — включите, чтобы данные подгружались сразу при открытии формы.

📄 ПоказыватьКоманднуюПанель — добавьте кнопки для работы со списком (обновление, настройки и т.д.).

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

Пример кода для программной настройки параметров списка на форме:

&НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Элементы.ДинамическийСписок1.Параметры.Добавить("ТекущаяДата", ТекущаяДата());
КонецПроцедуры

Здесь мы передаём текущую дату в параметр запроса, чтобы список показывал актуальные цены и остатки.

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

Шаг 4: Настройка отборов и параметров

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

Рассмотрим оба подхода:

1. Статические отборы (в конфигураторе)

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

Добавьте новое условие отбора.

В поле Левое значение укажите Номенклатура.ПометкаУдаления.

В поле Вид сравнения выберите Равно.

В поле Правое значение укажите Ложь.

2. Динамические отборы (из формы)

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

&НаСервере Процедура УстановитьОтборПоГруппе(Группа) Элементы.ДинамическийСписок1.Параметры.Отбор.Очистить(); Элементы.ДинамическийСписок1.Параметры.Отбор.Добавить("Группа", Группа); Элементы.ДинамическийСписок1.Обновить();
КонецПроцедуры

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

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

Для этого нужно в модуле формы добавить обработчик события ПриЧтенииНастроек и программно установить нужные параметры отбора. Например:

&НаСервере Процедура ПриЧтенииНастроекНаСервере(ЧтениеНастроек, СтандартнаяОбработка) Если Не ЧтениеНастроек.Настройки.Свойство("ОтборПоГруппе") Тогда ЧтениеНастроек.Настройки.Отбор.Добавить("Группа", Справочники.ГруппыНоменклатуры.Товары); КонецЕсли;
КонецПроцедуры

Этот код устанавливает отбор по группе "Товары" для всех пользователей, если настройка не была сохранена ранее.

Шаг 5: Оптимизация производительности

Динамические списки могут тормозить, если:

🐢 Источник данных содержит слишком много строк (свыше 10 000).

🔄 Запрос выполняет сложные соединения таблиц.

📊 В списке отображается много колонок с вычисляемыми полями.

Чтобы ускорить работу списка, следуйте этим рекомендациям:

Проблема Решение Пример

Медленная загрузка данных Используйте постраничную загрузку Элементы.ДинамическийСписок1.Параметры.РазмерСтраницы = 100;

Сложный запрос Оптимизируйте индексы в базе Добавьте индекс по полю, используемому в отборе

Много вычисляемых полей Перенесите вычисления на сервер Используйте ВычисляемоеПоле с флагом НаСервере

Частые обновления Отключите автоматическое обновление Элементы.ДинамическийСписок1.АвтоОбновление = Ложь;

Для больших списков рекомендуется использовать виртуальные таблицы вместо прямых запросов к регистрам. Например, вместо:

ВЫБРАТЬ ОстаткиНоменклатуры.Номенклатура КАК Номенклатура, ОстаткиНоменклатуры.КоличествоОстаток КАК Остаток ИЗ
РегистрНакопления.ОстаткиНоменклатуры КАК ОстаткиНоменклатуры

Используйте:

ВЫБРАТЬ ОстаткиНоменклатурыОстатки.Номенклатура КАК Номенклатура, ОстаткиНоменклатурыОстатки.КоличествоОстаток КАК Остаток ИЗ
РегистрНакопления.ОстаткиНоменклатуры.Остатки(&ТекущаяДата,) КАК ОстаткиНоменклатурыОстатки

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

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

Шаг 6: Расширенные возможности: группировка, сортировка, события

Динамические списки поддерживают множество дополнительных функций, которые делают их ещё более полезными:

1. Группировка данных

Чтобы сгруппировать данные по какому-либо полю (например, по группам номенклатуры), в свойствах динамического списка на вкладке Группировка добавьте нужное поле. Также можно настроить иерархическую группировку по нескольким полям.

2. Пользовательская сортировка

По умолчанию список сортируется по первому полю. Чтобы изменить порядок, используйте свойство Порядок:

Элементы.ДинамическийСписок1.Параметры.Порядок.Очистить();
Элементы.ДинамическийСписок1.Параметры.Порядок.Добавить("Наименование", НаправлениеСортировки.Возр);

3. Обработка событий

Динамические списки поддерживают следующие события:

📥 ПриАктивизацииСтроки — срабатывает при выборе строки.

🔄 ПриОбновленииДанных — вызывается после обновления списка.

📤 ПриИзмененииОтбора — происходит при изменении фильтров.

Пример обработки выбора строки:

&НаКлиенте Процедура ДинамическийСписок1ПриАктивизацииСтроки(Элемент, СтрокаДанных) Сообщить("Выбрана номенклатура: " + СтрокаДанных.Наименование);
КонецПроцедуры

4. Экспорт данных

Пользователи могут экспортировать данные из динамического списка в Excel, PDF или другие форматы. Для этого в командной панели списка автоматически добавляется кнопка Выгрузить. Чтобы отключить эту возможность, установите свойство РазрешитьВыгрузку в значение Ложь.

Как добавить собственную кнопку экспорта с кастомными настройками?

Создайте команду на форме и в её обработчике используйте метод Выгрузить() с параметрами. Пример:

&НаСервере Процедура ВыгрузитьВExcelНаСервере() ТаблицаДанных = Элементы.ДинамическийСписок1.Выгрузить(); Экспорт = Новый ЭкспортДанныхВТаблицуExcel; Экспорт.УстановитьДанные(ТаблицаДанных); Экспорт.Выгрузить(Новый Файл("export.xlsx"));
КонецПроцедуры

Этот код сохраняет данные в файл export.xlsx с настройками по умолчанию.

Типичные ошибки и как их избежать

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

Ошибка Причина Решение

Список не обновляется Не переданы параметры в запрос Проверьте коллекцию Параметры на форме

Пустой список при наличии данных Ошибка в отборе или правах доступа Упростите запрос и проверьте права пользователя

Медленная работа при прокрутке Слишком большой размер страницы Уменьшите РазмерСтраницы до 50-100 строк

Не работают гиперссылки Не установлено свойство ПоказыватьКакСсылку Настройте колонку в структуре списка

Одна из самых коварных ошибок — несоответствие типов данных в запросе и структуре списка. Например, если в запросе поле имеет тип Число, а в структуре указано Строка, то данные не отобразятся, но ошибки не будет. Всегда сверяйте типы!

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

FAQ: Ответы на частые вопросы

Как сделать динамический список с подчинённым списком (master-detail)?

Для этого нужно:

Создать два динамических списка: главный и подчинённый.

В главном списке настроить событие ПриАктивизацииСтроки, в котором будет устанавливаться отбор для подчинённого списка.

Пример кода:
&НаКлиенте Процедура ГлавныйСписокПриАктивизацииСтроки(Элемент, СтрокаДанных) Элементы.ПодчиненныйСписок.Параметры.Отбор.Очистить(); Элементы.ПодчиненныйСписок.Параметры.Отбор.Добавить("Родитель", СтрокаДанных.Ссылка); Элементы.ПодчиненныйСписок.Обновить();
КонецПроцедуры

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

Да, но для этого нужно:

Настроить распределённую информационную базу (РИБ) или использовать веб-сервисы.

В запросе источника данных использовать функции для работы с внешними источниками, например, HTTPСервисВызов().

Пример запроса с данными из REST API:

ВЫБРАТЬ JSONЗначение.Имя КАК Наименование, JSONЗначение.Цена КАК Цена ИЗ HTTPСервисВызов("https://api.example.com/goods", , , "GET") КАК HTTPОтвет
РАЗМЕСТИТЬ JSONЗначение ПО HTTPОтвет.ТелоКакСтроку

Учтите, что такой подход требует стабильного интернет-соединения и может замедлять работу списка.

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

Для этого используйте ролевой доступ:

В конфигураторе откройте настройки ролей (Администрирование → Пользователи и права).

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

Если нужно ограничить доступ к отдельным строкам, используйте RLS (Row-Level Security) — настройку прав на уровне записей.

Пример RLS для справочника Номенклатура:

ВЫБРАТЬ РАЗРЕШЕННЫЕ Номенклатура.Ссылка КАК Ссылка ИЗ Справочник.Номенклатура КАК Номенклатура ГДЕ
Номенклатура.Подразделение В (&ПодразделенияПользователя)

Здесь &ПодразделенияПользователя — параметр, передаваемый из сеанса пользователя.

Почему динамический список тормозит при открытии формы?

Вероятные причины и решения:

🔍 Слишком большой начальный запрос — ограничьте количество загружаемых строк свойством РазмерСтраницы.

🔄 Сложные вычисляемые поля — перенесите вычисления на сервер или используйте материализованные представления.

📊 Отсутствие индексов — проверьте, есть ли индексы по полям, используемым в отборе и сортировке.

🔌 Проблемы с сетью — если база на сервере, проверьте скорость соединения.

Для диагностики включите профилировку запросов в конфигураторе (Сервис → Параметры → Профилировка) и анализируйте медленные операции.

Как сохранить настройки динамического списка (колонки, отборы) для всех пользователей?

Используйте общие настройки:

В модуле формы добавьте обработчик события ПриЧтенииНастроек.

Программно установите нужные параметры (видимые колонки, сортировку, отборы).

Пример:
&НаСервере Процедура ПриЧтенииНастроекНаСервере(ЧтениеНастроек, СтандартнаяОбработка) // Устанавливаем видимые колонки Если Не ЧтениеНастроек.Настройки.Колонки.Найти("Артикул

Имя колонки	Заголовок	Тип данных	Выражение	Ширина
`Ссылка`	Номенклатура	СправочникСсылка.Номенклатура	`Ссылка`	200
`Наименование`	Наименование	Строка	`Наименование`	300
`Артикул`	Артикул	Строка	`Артикул`	100
`Цена`	Цена, руб.	Число	`Цена`	100
`Остаток`	Остаток, шт.	Число	`Остаток`	100

Проблема	Решение	Пример
Медленная загрузка данных	Используйте постраничную загрузку	`Элементы.ДинамическийСписок1.Параметры.РазмерСтраницы = 100;`
Сложный запрос	Оптимизируйте индексы в базе	Добавьте индекс по полю, используемому в отборе
Много вычисляемых полей	Перенесите вычисления на сервер	Используйте `ВычисляемоеПоле` с флагом `НаСервере`
Частые обновления	Отключите автоматическое обновление	`Элементы.ДинамическийСписок1.АвтоОбновление = Ложь;`

Ошибка	Причина	Решение
Список не обновляется	Не переданы параметры в запрос	Проверьте коллекцию `Параметры` на форме
Пустой список при наличии данных	Ошибка в отборе или правах доступа	Упростите запрос и проверьте права пользователя
Медленная работа при прокрутке	Слишком большой размер страницы	Уменьшите `РазмерСтраницы` до 50-100 строк
Не работают гиперссылки	Не установлено свойство `ПоказыватьКакСсылку`	Настройте колонку в структуре списка

Как создать динамический список в 1С 8.3: от простого к сложному

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

Подготовка к созданию: что нужно знать до начала работы

Шаг 1: Создание источника данных для динамического списка

Шаг 2: Настройка структуры динамического списка

Шаг 3: Размещение динамического списка на форме

Шаг 4: Настройка отборов и параметров

1. Статические отборы (в конфигураторе)

2. Динамические отборы (из формы)

Шаг 5: Оптимизация производительности

Шаг 6: Расширенные возможности: группировка, сортировка, события

1. Группировка данных

2. Пользовательская сортировка

3. Обработка событий

4. Экспорт данных

Типичные ошибки и как их избежать

FAQ: Ответы на частые вопросы

📖 Читайте также