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