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

Другое · 8 мин

Управляемая форма 1С: что это, где применяется и как с ней работать

Управляемая форма в 1С:Предприятие — форма для тонкого и веб-клиента, где настраиваются элементы, команды и события. Разбор отличий от обычной формы и порядок работы.

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

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

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

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

Чем управляемая форма отличается от обычной

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

ПараметрОбычная формаУправляемая форма
Основной клиентТолстый клиентТонкий клиент и веб-клиент
Модуль формыОдин общий модульКлиентский и серверный модули
Доступ через браузерНе предназначенаПоддерживается
Перенос между клиентамиОграниченТребует проверки кода и свойств

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

Из чего состоит управляемая форма

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

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

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

Где и зачем применяются управляемые формы

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

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

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

Как создать и настроить управляемую форму

Разработка ведется в конфигураторе 1С:Предприятие в режиме редактирования конфигурации. Нужно открыть нужный объект, добавить к нему форму и установить тип управляемой формы. Затем на форме размещаются элементы, привязываются к реквизитам, настраиваются команды и свойства внешнего вида.

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

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

Ограничения и риски при работе с формами

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

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

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

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

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

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

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

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

Тип формы в свойствах
Норма

Управляемая форма

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

Обычная форма для толстого клиента

Место открытия
Норма

Тонкий или веб-клиент

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

Только толстый клиент

Выполнение команды записи
Норма

Данные сохраняются

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

Ошибка серверного метода или отсутствие реакции

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

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

Итог

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

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

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

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

Можно ли скопировать обычную форму и сделать её управляемой?

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

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

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

Безопасно ли править управляемую форму в рабочей базе?

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