Расширение формы в 1С: что это и как его использовать

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

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

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

Чем расширение формы отличается от обычной доработки

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

Расширение работает иначе. Оно существует как отдельный объект, который «наслаивается» на типовую форму в момент открытия. Платформа берёт типовую форму и применяет к ней изменения из расширения: добавляет элементы, подменяет обработчики, вставляет команды. Сама типовая форма при этом физически не меняется.

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

Что можно изменить в форме через расширение

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

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

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

Как создать расширение и заимствовать форму

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

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

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

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

Добавление реквизита на форму: практический пример

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

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

Если нужно отреагировать на изменение поля, добавьте обработчик события «ПриИзменении» прямо в модуле формы расширения. Код обработчика пишется в модуле формы расширения и имеет доступ как к вашим реквизитам, так и к реквизитам типовой формы.

&НаКлиенте
Процедура Расш1_КомментарийДляСкладаПриИзменении(Элемент)
	Если СтрДлина(Объект.Расш1_КомментарийДляСклада) > 200 Тогда
		Сообщить("Комментарий слишком длинный");
	КонецЕсли;
КонецПроцедуры

Перехват типовых процедур модуля формы

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

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

Аннотация &Вместо — самая рискованная. После обновления конфигурации типовая процедура может измениться, но расширение продолжит подменять её старой логикой, и вы этого не заметите до появления ошибок в работе пользователей. По возможности выбирайте &Перед, &После или &ИзменениеИКонтроль.

Проверка работы и контроль применимости

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

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

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

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

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

Когда расширение не подходит

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

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

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