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