Как добавить управляемую форму в 1С

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

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

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

Какие бывают типы управляемых форм и что выбрать

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

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

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

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

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

В конструкторе задайте имя формы латиницей без пробелов (например, ФормаЭлементаРасширенная), выберите тип формы и отметьте, нужно ли назначить её основной. Для формы объекта конструктор предложит список реквизитов — отметьте те, что должны отображаться. После нажатия «Готово» платформа создаст форму и откроет редактор с уже размещёнными элементами.

1. 1
   Откройте конфигуратор и найдите объект в дереве конфигурации
2. 2
   Перейдите на вкладку «Формы» и нажмите «Добавить»
3. 3
   В конструкторе укажите имя, тип формы и отметьте нужные реквизиты
4. 4
   Нажмите «Готово» и при необходимости доработайте макет в редакторе формы
5. 5
   Обновите конфигурацию базы данных (F7) и проверьте форму в режиме предприятия

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

Настройка реквизитов и элементов формы

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

Чтобы добавить поле на форму, перетащите реквизит из правой панели в дерево элементов в нужное место. Положение в дереве определяет порядок на экране. Для группировки используйте элементы «Группа» с видом «Обычная группа» или «Страницы» — это помогает структурировать большие карточки, например вынести редко используемые реквизиты на отдельную вкладку.

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

Добавление команд и обработчиков событий

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

Обработчики событий создаются через палитру свойств формы или элемента: нажмите кнопку с лупой у нужного события (например, «ПриОткрытии», «ПриИзменении»), и конфигуратор сгенерирует заготовку процедуры в модуле формы. Ключевой момент — директивы компиляции: &НаКлиенте выполняется на компьютере пользователя, &НаСервере — на сервере, где доступны запросы к базе. Обращение к данным базы из клиентской процедуры вызовет ошибку.

&НаКлиенте
Процедура РассчитатьСумму(Команда)
	РассчитатьСуммуНаСервере();
КонецПроцедуры

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

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

Назначение формы основной и проверка результата

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

После всех изменений обновите конфигурацию базы данных (клавиша F7 или меню «Конфигурация → Обновить конфигурацию базы данных»). Без этого шага форма существует только в конфигурации разработчика и пользователям недоступна. Затем запустите режим «1С:Предприятие» и откройте объект: карточка должна открыться с вашей структурой полей.

Типичные ошибки и ограничения

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

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

Частые вопросы