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