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

Другое · 7 мин

Создание кнопки подбора в 1С: пошаговая инструкция

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

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

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

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

Когда кнопка подбора нужна в конфигурации

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

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

Стандартный подбор естьПоле заполняется из списка без кнопки

Проверьте поведение реквизита при вводе и нажатии клавиш выбора.

Нужен отдельный подборНет списка или открывается не тот объект

Убедитесь, что тип реквизита соответствует справочнику и форма выбора доступна.

Способы создания кнопки подбора в 1С

Через команду формы

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

Через обработчик события нажатия

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

Через встроенные средства платформы

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

Пошаговая настройка кнопки подбора

Порядок действий
  1. 1
    Откройте конфигурацию в режиме редактирования и найдите объект или форму, где нужна кнопка.
  2. 2
    Создайте команду формы или кнопку на форме и укажите обработчик нажатия.
  3. 3
    В коде обработчика откройте форму выбора целевого справочника или документа в режиме выбора.
  4. 4
    При получении выбранного значения запишите его в реквизит и завершите обработку.
  5. 5
    Проверьте работу на тестовых данных перед вводом в эксплуатацию.

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

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

Связь кнопки с реквизитом и проверка результата

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

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

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

Открывается список нужного справочника с возможностью выбора

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

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

Запись значения
Норма

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

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

Реквизит остаётся пустым или заполняется не тем объектом

Сохранение
Норма

Значение сохраняется при записи документа

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

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

Успешная настройка видна по трем признакам: форма выбора открывается по нажатию, после выбора реквизит заполняется корректным объектом, значение сохраняется при записи. Если хотя бы один признак отсутствует, кнопку считают нерабочей.

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

Ограничения и риски самостоятельной настройки

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

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

Частые ошибки при создании кнопки подбора

Типичные ошибки
01
Открыта форма просмотра вместо формы выбора, поэтому значение не возвращается в реквизит.
02
Значение записано в локальную переменную, а не в реквизит формы или объекта, и после закрытия формы пропадает.
03
Кнопка добавлена, но не выведена на командную панель, поэтому пользователь не видит её.

Частая ошибка — смешивание открытия элемента для редактирования и выбора значения. В режиме выбора форма возвращает ссылку, в обычном режиме — только открывает карточку.

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

Альтернативы кнопке подбора

Сравнение вариантов

Стандартный подбор реквизита

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

Обработка выбора через отдельную форму

Подходит для сложных условий и фильтров; требует настройки обработчика и проверки прав.

Выбор из выпадающего списка без открытия формы

Подходит для небольших справочников; неудобен при большом объеме данных.

Если подбор нужен редко, можно ограничиться выпадающим списком или стандартным полем ввода с автодополнением. Это проще в поддержке, но менее удобно при больших справочниках.

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

Итог

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

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

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

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

Что делать, если значение не сохраняется после выбора?

Проверьте, что обработчик записывает результат в реквизит формы или объекта, а не в локальную переменную, и что форма открыта в режиме выбора.

Безопасно ли менять типовую конфигурацию?

Прямые изменения типовых объектов могут пропасть при обновлении; предпочитайте расширения или обратитесь к администратору.

Почему кнопка открывает карточку вместо списка?

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

Нужно ли проверять нажатие Отмена?

Да, иначе при отмене выбора реквизит может быть перезаписан пустым значением или предыдущими данными.