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

Другое · 7 мин

Список значений на форме в 1С: создание и настройка

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

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

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

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

Когда список значений уместен на форме

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

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

Создание и заполнение СпискаЗначений в коде

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

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

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

Порядок действий
  1. 1
    Определите реквизит или переменную формы типа СписокЗначений
  2. 2
    Очистите список перед заполнением при повторном открытии формы
  3. 3
    Добавьте варианты парой «значение — представление»
  4. 4
    Назначьте список элементу формы
  5. 5
    Проверьте отображение вариантов и выбранное значение

Размещение элемента на форме и настройка свойств

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

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

Чтение выбранного значения и работа с событиями

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

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

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

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

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

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

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

Список пуст, варианты повторяются или элемент не виден

Выбор значения и запись формы
Норма

Выбранное значение сохраняется в реквизите и используется в логике

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

Значение не записывается или сбрасывается при повторном открытии

Отличия управляемой и обычной формы, ограничения

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

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

Типичные ошибки
01
Заполнение списка при каждом открытии без очистки приводит к дублям вариантов
02
Использование списка значений вместо справочника для постоянно меняющихся данных
03
Несоответствие типа реквизита формы и типа элемента списка

Частые ошибки и проверка результата

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

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

Итог

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

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

Можно ли использовать список значений вместо справочника?

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

Где заполнять список значений на форме?

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

Как узнать, какое значение выбрал пользователь?

Выбранное значение считывается из свойства элемента формы в обработчике события выбора, записи или закрытия. Точное имя свойства зависит от типа формы и релиза платформы.

Подходит ли список значений для длинных списков?

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

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

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