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

Другое · 6 мин

Открытие формы выбора программно в 1С: пошаговый разбор

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

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

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

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

Когда нужно открывать форму выбора из кода

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

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

Параметры и способы открытия формы

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

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

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

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

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

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

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

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

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

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

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

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

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

Типичные ошибки
01
Неверное имя формы или параметров приводит к ошибке открытия
02
Игнорирование отмены выбора вызывает обработку пустого результата
03
Отсутствие проверки прав доступа ограничивает видимость объектов

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

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

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

Итог

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

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

Нужно ли всегда передавать ЭтаФорма при открытии?

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

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

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

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

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

Как ограничить список объектов в форме выбора?

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