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

Другое · 6 мин

Создание управляемой формы в 1C

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

Управляемая форма в 1C — это форма прикладного объекта, предназначенная для тонкого клиента и веб-клиента. Она открывается из списка справочника, документа, регистра или другого объекта и показывает реквизиты, табличные части и команды в интерфейсе пользователя.

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

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

Когда управляемая форма подходит

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

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

Подготовка и выбор объекта конфигурации

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

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

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

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

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

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

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

Элементы, команды и обработка событий

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

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

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

Проверка, отладка и типичные ошибки

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

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

Не вносите правки напрямую в действующую базу без плана отката и согласования с администратором.

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

При повторении ошибки восстановите конфигурацию из резервной копии и повторите создание формы на чистой копии.

Обратите внимание на сообщения конфигуратора при сохранении: несохраненные изменения не будут видны пользователям.

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

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

Открытие формы под разными ролями
Норма

Форма открывается, команды доступны согласно правам

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

Форма не открывается или команды недоступны без причины

Заполнение обязательных реквизитов
Норма

Система требует заполнение перед сохранением

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

Обязательные поля можно оставить пустыми

Проведение документа
Норма

Документ проводится без ошибок

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

Ошибки проведения после изменений формы

Ограничения и альтернативы

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

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

Итог

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

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

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

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

Можно ли изменить форму в уже работающей базе?

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

В чем разница между управляемой и обычной формой?

Управляемая форма рассчитана на тонкий и веб-клиенты, обычная — преимущественно на толстый клиент. Выбор зависит от способа работы пользователей и типа конфигурации.

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

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