Другое · 7 мин
Динамический список на форме 1С: пошаговая настройка
Настройка зависимого списка на форме 1С: выбор источника, параметры, обновление при изменении реквизита и проверка результата без риска для данных.
Динамический список на форме 1С — это список допустимых значений реквизита, который меняется в зависимости от другого поля той же формы. Например, после выбора контрагента в списке договоров остаются только договоры этого контрагента, а после выбора организации доступны только её склады. Такой подход снижает количество ошибочных вводов и ускоряет заполнение документов.
На управляемых формах список может оформляться как встроенный динамический список с параметрами или заполняться программно в виде списка значений. Выбор способа зависит от того, откуда берутся данные: из регистра информации, справочника с отбором или набора значений, который невозможно получить стандартным запросом без дополнительной обработки.
Сравнение вариантов
Подходит для данных из базы с отбором по параметрам; ограничен возможностями запроса и настройки формы.
Подходит для сложной или вычисляемой логики; требует больше кода и ручного управления обновлением.
Когда динамический список нужен на форме
Зависимый список оправдан, когда одно поле ограничивает допустимые значения другого. Типичные ситуации: выбор склада по организации, договора по контрагенту, сотрудника по подразделению, номенклатуры по группе товаров. Если вариантов много и они зависят от контекста, статический список будет либо слишком длинным, либо содержать недопустимые значения.
Такой список удобен в документах, где пользователь сначала указывает основной объект, а затем уточняет связанный реквизит. Это снижает нагрузку на память пользователя и уменьшает вероятность сохранения некорректной связи между объектами базы.
- 1Создайте реквизит формы и элемент списка с типом динамический список
- 2Опишите запрос источника данных с параметрами фильтрации
- 3Привяжите параметры к управляющим реквизитам формы
- 4В обработчике изменения реквизита обновите список и проверьте выбранное значение
- 5Откройте форму и убедитесь, что содержимое списка меняется после выбора управляющего поля
Признаки, что подходит динамический список
- значение одного поля определяет допустимые значения другого;
- статический список содержит сотни или тысячи строк, из которых подходят немногие;
- пользователи часто выбирают несоответствующие объекты и получают ошибки при записи.
Два основных способа реализации
Первый способ — использовать встроенный динамический список формы. Он создается на основе запроса с параметрами, которые передаются из формы. Список автоматически подтягивает данные из базы и может обновляться при изменении параметров. Это удобно, когда данные лежат в справочниках, регистрах или документах и их можно отфильтровать стандартным запросом.
Второй способ — заполнять список значений программно в модуле формы. Подходит, когда набор значений формируется по сложной логике, вычисляется в памяти или берется из нескольких источников одновременно. Здесь разработчик сам управляет содержимым списка, но должен обеспечить его очистку и повторное заполнение при изменении условий.
Настройка встроенного динамического списка
Создайте реквизит формы, который будет хранить выбранное значение, и укажите для элемента формы источник данных «Динамический список». В настройках динамического списка определите запрос, источник и параметры, которые будут фильтровать результат. Параметры обычно привязываются к другим реквизитам формы, например контрагенту или организации.
В обработчике события изменения управляющего реквизита задайте значение параметра динамического списка и вызовите обновление списка. После этого форма перезапрашивает допустимые значения и отображает только подходящие. Если выбранное ранее значение больше не входит в новый список, его следует сбросить или пометить как недопустимое.
Программное заполнение списка значений
Для ручного заполнения используйте список значений или таблицу значений, которую присваивают элементу формы в процедуре при изменении управляющего реквизита. Перед заполнением список очищается, затем добавляются строки, соответствующие текущему условию. Этот подход дает полный контроль над отображением, включая порядок строк и дополнительные колонки.
Важно выполнять запросы к базе на сервере, а не на клиенте, особенно если данных много. Клиентские запросы могут замедлить работу формы и привести к задержкам при открытии или изменении полей. Серверный вызов возвращает готовый набор, который форма отображает без лишних обменов.
Как проверить результат
Список зависимого поля обновляется и показывает только подходящие значения
Список не меняется, пуст или содержит старые значения
Данные сохраняются без ошибок
Ошибка записи или сохраняется недопустимая связь объектов
Проверка результата и типичные ошибки
После настройки откройте форму в режиме работы, выберите значение в управляющем поле и проверьте, что список зависимого поля обновился. Затем выберите допустимое значение и попробуйте записать документ. Если запись проходит и данные сохраняются корректно, настройка работает. Если список пуст или не меняется, причина может быть в неверном параметре, отсутствии прав на данные или ошибке запроса.
Частые ошибки: забыть очистить список перед повторным заполнением, не сбросить значение, ставшее недопустимым после фильтрации, использовать клиентский запрос для большого объема данных, не совпадать типы параметров и реквизитов. Также некорректно работает список, если источник данных ссылается на удаленный или недоступный объект.
Ограничения и безопасная работа
Динамический список не заменяет проверку прав доступа: пользователь может увидеть в списке только то, что разрешено его ролям, но при попытке записи система может отказать. Не полагайтесь только на интерфейс формы для защиты данных — настройте права и проверяйте критические условия на сервере.
Перед внесением изменений в конфигурацию создайте резервную копию и протестируйте форму на копии базы. Изменения в модуле формы или запросе динамического списка могут затронуть все документы, использующие эту форму, поэтому проверяйте сценарий на нескольких ролях и с разными данными.
Что важно запомнить
Динамический список настраивается через источник с параметрами или программное заполнение, обновляется при изменении управляющего поля и проверяется на форме перед записью.
Часто задаваемые вопросы
Можно ли сделать динамический список без программирования?
Да, если данные можно отфильтровать стандартным запросом и параметры привязаны к реквизитам формы, достаточно настроить источник динамического списка в свойствах элемента. Программирование потребуется только для сложной логики или нестандартных условий.
Что делать, если список не обновляется после выбора поля?
Проверьте, что обработчик изменения управляющего реквизита действительно вызывает обновление списка и задает актуальные параметры. Убедитесь, что тип параметра совпадает с типом реквизита, а источник данных доступен для текущего пользователя.
Безопасно ли редактировать форму на рабочей базе?
Не рекомендуется вносить изменения прямо на рабочей базе без резервной копии и предварительного тестирования на копии. Ошибка в модуле или запросе может повлиять на работу всех пользователей и целостность данных.
Нужно ли сбрасывать значение, если оно перестало подходить?
Да, после изменения фильтра ранее выбранное значение может оказаться недопустимым. Хорошая практика — очищать зависимое реквизит или информировать пользователя, чтобы не сохранялась некорректная связь.