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

Другое · 6 мин

Задание параметра динамического списка в 1С

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

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

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

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

Что представляет собой параметр динамического списка

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

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

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

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

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

Способы задания параметра в конфигураторе

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

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

bsl
Процедура ПриОткрытии(Отказ)
    ПараметрСписка = ТекущийКонтрагент;
КонецПроцедуры

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

Программное задание параметра в коде

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

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

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

Открытие динамического списка
Норма

Список содержит ожидаемые записи по заданному отбору

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

Список пуст или содержит не те записи

Тип значения параметра
Норма

Тип соответствует ожидаемому в метаданных

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

Передано Неопределено или значение другого типа

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

Задание через форму объекта

Если список открывается из формы документа, параметр можно передать в параметры метода ОткрытьФорму. Тогда форма списка получает значение ещё до отрисовки интерфейса, и пользователь видит уже отфильтрованный набор.

Типичные ошибки
01
Передача значения неверного типа приводит к пустому списку или ошибке выполнения
02
Изменение параметра после открытия списка не обновляет уже отображённую выборку
03
Отсутствие проверки на Неопределено вызывает ошибку при присваивании параметру

Проверка результата и отладка

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

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

Ограничения и частые ошибки

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

Не рекомендуется жестко кодировать значения параметров прямо в запросе без возможности изменения через форму. Это усложняет поддержку и делает список менее гибким при изменении бизнес-правил.

Безопасная самостоятельная работа

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

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

Итог

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

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

Частые вопросы

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

В большинстве случаев параметр применяется при открытии формы списка. Для применения нового значения обычно требуется закрыть список и открыть его повторно с обновлённым параметром.

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

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

Нужно ли программировать задание параметра, если он можно задать в свойствах формы?

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

Безопасно ли править модуль формы самостоятельно?

Небольшие правки в модуле формы допустимы на тестовой базе. Серьёзные изменения запроса или структуры списка лучше выполнять с участием разработчика и с резервной копией информации.