Другое · 9 мин
Как создать управляемую форму в 1С и проверить её работу
Пошаговая статья о создании управляемых форм в 1С: где добавлять форму, как проверить тип, какие ошибки избегать и как открыть форму в пользовательском режиме.
Управляемая форма — основной интерфейсный объект в конфигурациях 1С, работающих в управляемом приложении. Она используется для отображения справочников, документов, отчетов и обработок в тонком клиенте, веб-клиенте и мобильном приложении. Создание такой формы начинается в конфигураторе, а не в пользовательском режиме.
Перед созданием формы убедитесь, что конфибурация поддерживает управляемое приложение. В ином случае новая форма может быть создана как обычная и некорректно работать в современных клиентах. Порядок действий зависит от назначения объекта: для справочника форма обычно создается как форма объекта, для документа — форма документа и форма списка, для отчета — форма отчета.
Где и как добавить управляемую форму
Откройте конфигурацию в режиме редактирования и найдите нужный объект метаданных: справочник, документ, перечисление, план обмена, отчет или обработку. В контекстном меню объекта выберите создание формы. В мастере укажите тип формы — объект, список или отчет — и подтвердите создание. Новая форма появится в подчиненной ветке объекта.
В свойствах созданной формы проверьте вид формы. Для управляемого приложения он должен соответствовать управляемой форме, а не обычной. Если в свойствах есть выбор между обычным и управляемым представлением, выбирайте управляемый. Иначе форма может открыться только в старом толстом клиенте или не открыться вовсе.
На форме настройте реквизиты, которые будут доступны пользователю. Добавьте поля из реквизитов объекта, табличных частей и вычисляемых значений. Для каждого элемента управления укажите доступность, видимость и обязательность заполнения в соответствии с бизнес-логикой.
Настройка модуля формы и серверных вызовов
Откройте модуль управляемой формы. Здесь размещают обработчики событий: при открытии формы, при изменении реквизита, при нажатии команды, при записи. Для операций с данными, которые могут быть долгими или требовать доступа к базе, используйте процедуры с директивой &НаСервере. Остальную логику интерфейса оставляйте на клиенте.
Не вызывайте тяжелые вычисления напрямую в обработчиках клиентских событий без переноса на сервер. Это может привести к зависанию интерфейса, особенно в веб-клиенте. При работе с табличными частями проверяйте, что строки существуют перед обращением к ячейкам, иначе возникнет ошибка при выполнении.
После изменения модуля формы сохраните конфигурацию и выполните обновление базы данных, если требуется. В режиме предприятия проверьте, что форма открывается по стандартной команде из списка или карточки объекта.
Команды и открытие формы из кода
Для программного открытия формы используйте метод ОткрытьФорму. Укажите имя формы в виде строки, например "Справочник.Контрагенты.ФормаОбъекта", и передайте нужные параметры: ссылку на объект, режим открытия и владельца. При открытии формы объекта в режиме редактирования пользователь может изменить данные, поэтому проверяйте права доступа заранее.
Если форма вызывается из команды списка, уточните, передается ли выделенный элемент. При отсутствии выделения команда должна либо открывать форму создания нового объекта, либо выводить сообщение о необходимости выбрать запись. Это предотвращает попытку работы с пустой ссылкой.
Для возврата данных из формы используйте параметр режим открытия и обработку результата после закрытия формы. В управляемом приложении форма может быть открыта модально или в фоновом режиме. Выбор зависит от того, нужно ли пользователю дождаться завершения работы с формой перед продолжением.
Проверьте открытие через список и карточку объекта в тонком или веб-клиенте
Убедитесь, что форма создана как управляемая для текущего типа приложения
Перенесите тяжелые операции в процедуры с директивой &НаСервере
Проверка результата и отладка
После сохранения формы перейдите в режим предприятия и откройте соответствующий справочник или документ. Убедитесь, что команда открытия формы доступна, форма отображает все необходимые реквизиты, а табличные части заполняются без ошибок. Попробуйте создать и записать тестовый объект, затем прочитать его обратно.
Если форма не открывается, просмотрите сообщения конфигуратора и журнал регистрации. Частая причина — опечатка в имени формы, отсутствие прав доступа к объекту или несоответствие формы клиенту. Проверьте также, что конфигурация обновлена и нет несохраненных изменений.
Для отладки модуля формы используйте точки остановки и вывод значений в отладчик. Проверяйте значения реквизитов на клиенте и сервере отдельно, так как они могут находиться в разных контекстах выполнения. Не полагайтесь только на визуальное состояние формы.
- 1Открыть объект метаданных в конфигураторе и создать форму
- 2Выбрать управляемый вид формы и сохранить
- 3Настроить реквизиты, элементы и команды
- 4Проверить модуль формы и перенести тяжелые операции на сервер
- 5Открыть форму в режиме предприятия и записать тестовый объект
Ограничения и риски самостоятельной работы
Не вносите изменения в форму конфигурации, которая поставляется с типовой конфигурацией и поддерживается поставщиком, без создания копии или расширения. Прямое изменение типовой формы может привести к потере правок при обновлении конфигурации. Используйте расширения конфигурации или собственные подсистемы, если это предусмотрено платформой.
Изменение прав доступа к форме или объекту может ограничить работу сотрудников. Перед внесением правок в продакшене протестируйте их на отдельной базе или копии рабочей информации. Не изменяйте формы в рабочей базе в рабочее время без резервной копии.
Если вы не уверены в назначении свойства формы или поведении команды, не пробуйте варианты наугад на живых данных. Лучше сначала воспроизвести ситуацию в учебной базе и сравнить результат. Ошибка в модуле формы может блокировать запись документов и привести к простою.
Типичные ошибки при создании форм
Одна из частых ошибок — создание обычной формы вместо управляемой в конфигурации для современного клиента. Тогда форма может быть недоступна или отображаться некорректно. Другая ошибка — обращение к реквизитам формы, которые не добавлены на форму или имеют неверное имя.
Также часто забывают про контекст выполнения: попытка показать сообщение или открыть форму из серверной процедуры без клиентского вызова приводит к ошибке. Неправильная обработка пустых ссылок в табличной части вызывает прерывание записи при отсутствии строк.
Некоторые разработчики оставляют обработчики событий пустыми или дублируют логику в нескольких событиях. Это усложняет поддержку и делает поведение формы непредсказуемым. Каждый обработчик должен решать одну задачу и быть покрыт проверкой при открытии и записи.
Альтернативы и когда форма не нужна
В некоторых задачах достаточно стандартной формы списка или карточки объекта, которую платформа создает автоматически. Если нужно только показать данные без изменений, подойдет отчет или динамический список. Создавайте собственную форму только когда стандартного интерфейса недостаточно для бизнес-процесса.
Как проверить результат
Форма открывается без ошибок и отображает реквизиты
Форма не открывается или открывается пустая
Данные сохраняются и читаются обратно
Ошибка записи или потеря введенных значений
Форма ведет себя одинаково в поддерживаемых клиентах
Разница в поведении между клиентами
Для массового ввода данных иногда удобнее использовать обработку загрузки или внешнюю таблицу, а не форму документа. Для просмотра показателей в реальном времени подходят панели или отчеты с графиками. Выбор инструмента зависит от частоты использования и количества пользователей.
Если форма создается для одного пользователя и редко открывается, затраты на поддержку могут превысить пользу. В таких случаях рациональнее настроить права до стандартной форме, чем разрабатывать новую.
Что важно запомнить
Управляемая форма создается в конфигураторе для нужного объекта, проверяется вид формы, настраиваются реквизиты и модуль, а результат обязательно проверяется в режиме предприятия на тестовых данных.
Частые вопросы
Нужно ли переводить конфигурацию в управляемый режим перед созданием формы?
Да, если вы планируете использовать современные клиенты. Управляемые формы рассчитаны на управляемое приложение, а обычные формы предназначены в основном для совместимости со старыми клиентами. Проверьте свойства конфигурации перед созданием формы.
Можно ли изменить типовую форму поставляемой конфигурации?
Не рекомендуется изменять типовую форму напрямую, так как правки могут пропасть при обновлении. Используйте расширение конфигурации или создайте собственную форму в своей подсистеме, если платформа и конфигурация это допускают.
Что делать, если форма не открывается после создания?
Проверьте вид формы, наличие сохраненных изменений, права доступа к объекту и сообщения журнала регистрации. Убедитесь, что имя формы указано верно при программном открытии, и попробуйте открыть форму в разных клиентах.
Нужно ли переносить всю логику формы на сервер?
Нет, только операции с данными и долгие вычисления. Интерфейсная логика, управление видимостью элементов и простые проверки могут оставаться на клиенте, чтобы не замедлять отклик формы.
Как открыть форму программно из другой обработки?
Используйте метод ОткрытьФорму, указав полное имя формы и нужные параметры: ссылку на объект, режим и владельца. Перед открытием проверьте, что ссылка не пустая, и обработайте ситуацию, когда пользователь не выбрал запись.