Как добавить новую форму в 1С

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

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

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

Какие виды форм существуют и какую выбрать

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

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

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

Подготовка: что проверить перед созданием формы

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

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

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

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

Конструктор форм — основной инструмент для быстрого создания типовых экранов. Он сам генерирует структуру элементов и связывает их с реквизитами объекта, а разработчику остаётся поправить детали. Ниже порядок действий на примере формы документа; для справочников шаги аналогичны.

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

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

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

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

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

Полезные свойства элементов, которые чаще всего меняют новички: «Заголовок» (подпись поля), «Подсказка» и «ОтображениеПодсказки» (текст помощи у поля), «Доступность» и «ТолькоПросмотр» (блокировка редактирования), «КнопкаВыпадающегоСписка» и «БыстрыйВыбор» для полей ссылочного типа. Ширину и порядок элементов платформа рассчитывает автоматически, но поведение можно скорректировать свойствами растягивания группы.

Добавление реквизита формы

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

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

Табличные части на форме

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

Код модуля формы: обработчики событий

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

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

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
	Если Объект.Ссылка.Пустая() Тогда
		Объект.Ответственный = Пользователи.ТекущийПользователь();
	КонецЕсли;
КонецПроцедуры

&НаКлиенте
Процедура КоличествоПриИзменении(Элемент)
	Строка = Элементы.Товары.ТекущиеДанные;
	Строка.Сумма = Строка.Количество * Строка.Цена;
КонецПроцедуры

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

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

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

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

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

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

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

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

Частые вопросы о добавлении форм в 1С