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