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

Другое · 7 мин

Заполнение списка выбора в управляемой форме 1С программно

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

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

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

Что представляет собой список выбора в управляемой форме

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

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

Откуда берутся значения и где их заполнять

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

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

Программное заполнение через реквизит формы

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

bsl
Значения = Новый СписокЗначений; Значения.Добавить("А", "Активные"); Значения.Добавить("Н", "Неактивные"); ЭтотОбъект.Статус = Значения;

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

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

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

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

Отображение вариантов в форме
Норма

Пользователь видит ожидаемый набор вариантов

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

Список пуст или показаны старые варианты

Запись выбранного значения
Норма

Сохраняется код значения, а не текст представления

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

Сохраняется представление или пустое значение

Тип реквизита формы
Норма

Реквизит имеет тип списка значений

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

Реквизит имеет иной тип, список не принимается

Заполнение элемента формы напрямую

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

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

Типичные ошибки
01
Присвоение списка реквизиту неподдерживаемого типа — список не отображается или возникает ошибка
02
Смешение значения и представления — записывается текст вместо кода

Условия, проверка и динамическое изменение

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

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

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

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

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

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

Статический список в конфигураторе

Подходит для неизменяемых вариантов, не требует кода

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

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

Прямое изменение элемента формы

Универсально, но привязано к имени элемента и менее устойчиво к правкам

Альтернативы и выбор способа

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

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

Итог

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

Создавайте список значений, добавляйте пары значение-представление и присваивайте подходящему реквизиту или элементу; проверяйте тип реквизита, контекст выполнения и результат сохранения.

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

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

Где лучше заполнять список: на сервере или на клиенте?

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

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

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

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

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