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

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

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

Практически все современные типовые конфигурации 1С — «Управление торговлей», «Бухгалтерия предприятия», «Зарплата и управление персоналом» — построены на управляемых формах. Поэтому понимание этого механизма необходимо и разработчику, который дорабатывает конфигурацию, и внедренцу, который разбирается, почему форма ведёт себя именно так.

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

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

Второе принципиальное отличие — модель выполнения. Обычная форма «живёт» целиком на клиенте и напрямую обращается к базе. Управляемая форма существует в двух экземплярах: представление на клиенте и объект формы на сервере. Данные между ними передаются порциями, поэтому важно минимизировать количество серверных вызовов.

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

Форма состоит из трёх частей: реквизитов (данные), элементов (визуальное представление) и команд (действия пользователя). Реквизиты — это то, что форма хранит и передаёт между клиентом и сервером: ссылки, таблицы значений, примитивные типы. Элементы — поля, кнопки, таблицы, группы — лишь отображают реквизиты или вызывают команды.

Основной реквизит формы документа или справочника обычно имеет тип «ДанныеФормыСтруктура» на основе объекта. Платформа автоматически преобразует его в объект базы данных при записи и обратно при чтении. Дополнительные реквизиты — например, таблица для отбора или флаг настройки — разработчик добавляет сам.

Важно понимать: на клиенте доступны не все типы. Например, объект справочника или запрос существуют только на сервере. Если на клиенте нужно изменить данные объекта, правильный путь — вызвать серверную процедуру, изменить объект там и вернуть результат.

Директивы компиляции: НаКлиенте, НаСервере и другие

Каждая процедура и функция в модуле управляемой формы помечается директивой, которая определяет место выполнения. &НаКлиенте — код работает на компьютере пользователя: обработка нажатий, диалоги, работа с файлами. &НаСервере — код на сервере 1С: запросы, работа с объектами, проведение документов.

Директива &НаСервереБезКонтекста означает, что процедура выполняется на сервере без передачи туда всего состояния формы. Это самый быстрый способ получить данные, потому что не тратится время на сериализацию реквизитов. Такой процедуре недоступны реквизиты формы напрямую — параметры нужно передавать явно.

Директива &НаКлиентеНаСервереБезКонтекста используется для общих вспомогательных функций — расчётов, форматирования, — которые не обращаются к базе и могут выполняться где угодно. Неправильный выбор директивы — частая причина ошибок «Процедура или функция с указанным именем не определена» и лишних серверных вызовов.

&НаКлиенте
Процедура РассчитатьИтог(Команда)
	Итог = РассчитатьИтогНаСервере(Объект.Ссылка);
КонецПроцедуры

&НаСервереБезКонтекста
Функция РассчитатьИтогНаСервере(Ссылка)
	// запрос к данным документа
КонецФункции

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

Форма создаётся в конфигураторе: в дереве объекта (справочника, документа) открывается ветка «Формы», добавляется новая форма нужного вида — форма объекта, списка, выбора. Конструктор предлагает автоматически разместить основные реквизиты. Если у объекта нет своей формы, платформа генерирует её на лету по умолчанию.

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

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

Типичные задачи: программная работа с формой

Открытие формы с параметрами и отбором

Формы открываются методом ОткрытьФорму() с передачей структуры параметров. Для формы списка через параметр «Отбор» передаётся отбор по полям, для формы объекта — «Ключ» со ссылкой на существующий элемент. Параметры обрабатываются в событии ПриСозданииНаСервере через объект Параметры.

Динамическое изменение элементов

Состав элементов управляемой формы можно менять программно: создавать реквизиты методом ИзменитьРеквизиты(), добавлять элементы через Элементы.Добавить(). Это используется, когда структура формы зависит от данных — например, набор полей определяется настройками пользователя. Учтите: изменение реквизитов возможно только на сервере.

Условное оформление

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

Ограничения и частые ошибки

Управляемые формы накладывают ограничения, к которым нужно привыкнуть. Нельзя произвольно позиционировать элементы — только группировка и порядок. Модальные окна по умолчанию запрещены: вместо Вопрос() используется ПоказатьВопрос() с описанием оповещения. Не все типы доступны на клиенте, а серверный вызов — это сетевое взаимодействие, которое стоит сокращать.

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

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

После доработки форму проверяют в нескольких клиентах: минимум в тонком, а если пользователи работают через браузер — и в веб-клиенте. Отдельно проверяют сценарии: создание нового объекта, открытие существующего, запись, копирование. Разное поведение в этих сценариях — норма, и обработчики должны его учитывать.

Частые вопросы об управляемых формах