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