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

Другое · 5 мин

Создание и открытие формы программно в 1C

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

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

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

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

Когда программное открытие формы оправдано

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

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

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

ОткрытьФорму и ПараметрыФормы

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

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

bsl
Параметры = Новый Структура; Параметры.Вставить("Контрагент", Контрагент); ОткрытьФорму("Справочник.Контрагенты.ФормаЭлемента", Параметры, ЭтаФорма, РежимОткрытияФормы.Модально);

Управляемые и обычные формы: отличие

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

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

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

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

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

Типичные ошибки
01
Неверное имя формы в метаданных — ошибка во время выполнения
02
Отсутствие владельца или неверный режим окна — форма открывается некорректно
03
Предположение о существовании формы без проверки конфигурации

Как проверить, что форма открылась корректно

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

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

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

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

Объект формы после вызова
Норма

Форма открыта, ошибок нет

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

Исключение или форма не появилась

Заполнение параметрами
Норма

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

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

Поля пустые или не соответствуют ожидаемым

Альтернативы и границы самостоятельной работы

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

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

Итог

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

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

Можно ли создать форму с нуля только кодом?

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

Что передать в ОткрытьФорму?

Имя формы в метаданных, структуру параметров, объект-владелец, режим открытия и способ отображения окна. Точный набор зависит от типа формы и клиента.

Почему форма не открывается?

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

Когда использовать модальное окно?

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

Работает ли код одинаково в толстом и тонком клиенте?

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