Изменение динамического списка в 1С: Полный гайд

Работа с интерфейсом современной конфигурации 1С часто требует нестандартного подхода к отображению данных. Разработчикам и администраторам нередко приходится сталкиваться с задачей, когда стандартная форма списка объектов не удовлетворяет потребностям пользователя. Например, необходимо отобразить реквизиты из справочника-владельца или добавить вычисляемое поле, которого нет в метаданных. Именно здесь на сцену выходит механизм динамического списка. Это мощный инструмент, который позволяет гибко управлять набором полей, их порядком и даже логикой выборки данных без изменения структуры самой базы данных.

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

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

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

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

Обратите внимание на структуру полей формы. Динамический список автоматически добавляет поля в соответствии с настройками запроса, но часто разработчики добавляют туда лишние элементы управления, которые дублируют данные или conflict-уют с системными полями. Удаление таких дублей — первый шаг к оптимизации.

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

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

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

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

Здесь вы можете добавлять новые поля, указывая путь к ним через точку. Например, если вы хотите вывести наименование контрагента из документа, путь будет выглядеть как Контрагент.Наименование. Платформа автоматически построит необходимые соединения (JOIN) в SQL-запросе. Это избавляет программиста от написания громоздких текстов запросов вручную.

• 📦 Добавление полей из связанных справочников через точечную нотацию.
• ⚙️ Настройка сортировки по умолчанию для новых колонок.
• 🔍 Установка фильтров на уровне параметров выборки.
• 📐 Определение псевдонимов для сложных выражений.

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

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

Добавление вычисляемых колонок и псевдополей

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

Процесс создания такого поля начинается с добавления нового элемента в структуру параметров выборки. Вы задаете имя поля, которое будет использоваться в коде, и выражение, которое вычисляет значение. Это выражение пишется на языке запросов 1С и может включать условную логику ВЫБОР...КОГДА...ТОГДА.

ВЫБОР
КОГДА Документ.Проведен
ТОГДА "Проведен"
ИНАЧЕ "Черновик"
КОНЕЦ КАК СтатусТекст

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

Оптимизация вычисляемых полей

Если вычисление требует обращения к другой таблице, попробуйте использовать виртуальные таблицы (например, РегистрНакопления.Остатки) вместо прямых JOIN, это часто дает прирост скорости в 5-10 раз.

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

Программная модификация списка через обработчики событий

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

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

Событие	Назначение	Объект доступа
ПриСозданииНаСервере	Инициализация структуры списка	ПараметрыВыборки
ПриКомпоновкеРезультата	Корректировка запроса перед выполнением	КомпоновщикНастроек
ОбработкаВыбора	Реакция на клик по строке	ЭлементыФормы
ПередЗаписью	Валидация данных списка	Объект

Использование события ПриКомпоновкеРезультата дает еще больше гибкости. Здесь можно вмешаться в процесс построения запроса, добавить условия ГДЕ, которые зависят от контекста, не видного в обычных параметрах. Это мощный инструмент, но он требует глубокого понимания объекта КомпоновщикНастроек.

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

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

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

Главная проблема динамических списков — деградация скорости работы при росте объема данных. Если в списке 100 записей, любые манипуляции проходят незаметно. Но при 100 000 записей неправильная настройка может "повесить" базу на несколько минут. Основной враг здесь — отсутствие индексов на полях, используемых в отборах и соединениях.

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

• 🚀 Проверка планов выполнения запросов через консоль запросов.
• 🗄️ Индексация полей, участвующих в условиях отбора.
• 📉 Отказ от вычисляемых полей в условиях WHERE.
• ⚡ Использование виртуальных таблиц регистров.

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

Избегайте использования функций преобразования типов прямо в условиях отбора динамического списка. Например, отбор по условию Год(Дата) = 2026 запретит использование индекса по полю Дата. Лучше использовать диапазон дат: Дата >= НачалоГода(2026) И Дата < КонецГода(2026).

Секрет быстрой работы

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

Расширенные возможности: условное оформление и действия

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

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

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

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

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

Можно ли изменить динамический список в режиме предприятия без конфигуратора?

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

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

Наиболее вероятная причина — ошибка в выражении параметра выборки или отсутствие прав доступа к добавленному полю у текущего пользователя. Также возможно циклическое соединение таблиц, которое СУБД не может обработать. Проверьте логи сервера 1С.

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

В клиентском коде (например, в событии ПриОткрытии) найдите элемент таблицы по имени и установите его свойство Видимость в Ложь: Элементы.ИмяКолонки.Видимость = Ложь. Это скроет колонку только для текущего сеанса.

Влияет ли количество полей в динамическом списке на скорость работы?

Да, напрямую. Каждое дополнительное поле, особенно из связанных таблиц, усложняет SQL-запрос. Рекомендуется добавлять в список только те поля, которые реально необходимы пользователю для работы, избегая принципа "пусть будет все".

Что делать, если динамический список игнорирует отборы?

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