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

Другое · 6 мин

Как вызвать форму выбора в 1C: пошаговая инструкция

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

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

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

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

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

Когда форма выбора открывается автоматически

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

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

Поле с кнопкой выбораАвтоматическое открытие

Проверьте тип реквизита и наличие связанной формы выбора

Нужна фильтрация или несколько значенийПрограммный вызов

Используйте ОткрытьФорму с параметрами режима выбора

Форма закрыта без выбораОтказ пользователя

Проверяйте признак отмены перед использованием результата

Программный вызов формы выбора в управляемом приложении

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

Примеры ситуаций

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

Порядок действий
  1. 1
    Убедитесь, что целевая форма поддерживает режим выбора
  2. 2
    Заполните параметры режима выбора перед открытием формы
  3. 3
    Откройте форму через ОткрытьФорму с параметрами выбора
  4. 4
    После закрытия проверьте признак подтверждения и прочитайте выбранное значение

Параметры режима выбора и получение результата

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

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

Выбор в обычном приложении и внешних обработках

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

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

Частые ошибки и ограничения

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

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

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

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

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

Итог

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

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

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

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

Что делать, если форма открывается, но не возвращает выбранное значение?

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

Можно ли изменить типовую форму выбора конфигурации?

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

Какие права нужны для вызова формы выбора?

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