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