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

Другое · 7 мин

Как программно установить список выбора в 1С:Предприятии

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

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

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

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

Когда программный список выбора уместен

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

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

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

Как заполнить СписокВыбора в модуле формы

Получите доступ к списку через свойство реквизита формы, например Элементы.ИмяРеквизита.СписокВыбора. Перед добавлением вариантов вызовите очистку, чтобы не накопились дубликаты при повторном открытии формы.

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

Пример типичной последовательности действий

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

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

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

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

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

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

Список заполняется при открытииВарианты появляются каждый раз

Проверьте событие ПриОткрытии и отсутствие дублей

Значение не сохраняетсяРеквизит принимает другое значение

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

Поле не редактируетсяСписок не влияет на доступность

Проверьте свойство ТолькоПросмотр и права пользователя

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

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

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

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

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

Частые ошибки и способы их избежать

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

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

Типичные ошибки
01
Забыли очистить список перед заполнением, что привело к дублям
02
Передали представление вместо значения, из-за чего реквизит записался неверно
03
Изменили список для поля только для чтения, где он не применяется

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

Альтернативы: СписокЗначений и таблица значений

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

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

СписокВыбора формы

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

СписокЗначений

Удобен для передачи набора в коде, не привязан к форме напрямую

Таблица значений

Выбор строк с несколькими реквизитами, сложнее в настройке поля

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

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

Итог

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

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

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

Можно ли задать список выбора для реквизита документа напрямую?

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

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

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

Безопасно ли менять список в работающей базе?

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

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

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

Можно ли использовать один список для нескольких полей?

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