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

Другое · 6 мин

Как вызвать форму из формы в 1С

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

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

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

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

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

Когда и зачем открывать форму из формы

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

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

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

Синтаксис и основные параметры ОткрытьФорму

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

В модуле клиентской формы вызов часто пишется так: ОткрытьФорму("ИмяФормы", Параметры, ЭтаФорма, РежимОткрытияФормы.Модально). Параметр ЭтаФорма делает текущее окно владельцем открываемого. Если владелец не нужен, его можно опустить или передать Неопределено, в зависимости от контекста.

Владелец, модальность и возврат результата

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

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

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

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

Форма открылась без исключения
Норма

Окно появилось с ожидаемым заголовком и данными

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

Ошибка при открытии или окно не появилось

Модальность
Норма

Владелец заблокирован до закрытия при модальном режиме

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

Пользователь может работать в обоих окнах, хотя ожидалась блокировка

Результат выбора
Норма

Получено выбранное значение после подтверждения

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

Пустое значение или действие отменено пользователем

Передача данных между формами

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

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

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

Ограничения, контекст выполнения и типичные ошибки

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

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

Альтернативы прямому вызову формы

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

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

Итог

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

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

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

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

Как передать выбранное значение из модальной формы?

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

Чем отличается не модальная форма от модальной?

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

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

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