К статье
Практический материал

Другое · 7 мин

Динамический список на форме 1С: пошаговая настройка

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

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

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

Сравнение вариантов

Встроенный динамический список

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

Программное заполнение списка значений

Подходит для сложной или вычисляемой логики; требует больше кода и ручного управления обновлением.

Когда динамический список нужен на форме

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

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

Порядок действий
  1. 1
    Создайте реквизит формы и элемент списка с типом динамический список
  2. 2
    Опишите запрос источника данных с параметрами фильтрации
  3. 3
    Привяжите параметры к управляющим реквизитам формы
  4. 4
    В обработчике изменения реквизита обновите список и проверьте выбранное значение
  5. 5
    Откройте форму и убедитесь, что содержимое списка меняется после выбора управляющего поля

Признаки, что подходит динамический список

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

Два основных способа реализации

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

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

Настройка встроенного динамического списка

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

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

Типичные ошибки
01
Забыть очистить список перед повторным заполнением — остаются старые значения
02
Не сбросить выбранное значение, ставшее недопустимым после изменения фильтра
03
Использовать клиентский запрос для большого объема данных — форма тормозит
04
Не совпадают типы параметра динамического списка и реквизита формы

Программное заполнение списка значений

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

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

Контрольные точки

Как проверить результат

Изменение управляющего реквизита
Норма

Список зависимого поля обновляется и показывает только подходящие значения

Тревожный признак

Список не меняется, пуст или содержит старые значения

Запись документа после выбора
Норма

Данные сохраняются без ошибок

Тревожный признак

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

Проверка результата и типичные ошибки

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

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

Ограничения и безопасная работа

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

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

Итог

Что важно запомнить

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

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

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

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

Что делать, если список не обновляется после выбора поля?

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

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

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

Нужно ли сбрасывать значение, если оно перестало подходить?

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