Как сделать внешнюю форму в 1С: инструкция для разработчика и пользователя

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

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

Ниже разобран полный цикл: от выбора вида внешнего объекта и создания формы в конфигураторе до подключения, проверки результата и типичных ошибок. Материал ориентирован на типовые конфигурации на управляемых формах (УТ 11, ERP, БП 3.0, КА 2), но общие принципы применимы и к обычным формам.

Что такое внешняя форма и когда она нужна

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

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

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

Выбор типа объекта: обработка, отчёт или печатная форма

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

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

Создание внешней обработки в конфигураторе

Откройте конфигуратор под пользователем с правами разработчика. Выполните «Файл — Новый» и выберите «Внешняя обработка». Задайте имя и синоним — они будут видны при подключении. Сохраните файл с расширением .epf в рабочий каталог.

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

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

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

Ниже минимальный каркас модуля внешней печатной формы для конфигураций на БСП:

Функция СведенияОВнешнейОбработке() Экспорт
  ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке();
  ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиПечатнаяФорма();
  ПараметрыРегистрации.Версия = "1.0";
  ПараметрыРегистрации.Назначение.Добавить("Документ.РеализацияТоваровУслуг");
  НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
  НоваяКоманда.Представление = НСтр("ru = 'Моя печатная форма'");
  НоваяКоманда.Идентификатор = "МояПечатнаяФорма";
  НоваяКоманда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыВызовСерверногоМетода();
  Возврат ПараметрыРегистрации;
КонецФункции

Подключение формы в режиме 1С:Предприятие

В типовых конфигурациях на БСП подключение выполняется через раздел «Администрирование — Печатные формы, отчеты и обработки». Включите флажок «Дополнительные отчеты и обработки», затем откройте одноимённый список и нажмите «Создать — Загрузить из файла». Укажите сохранённый .epf-файл — платформа прочитает функцию СведенияОВнешнейОбработке и заполнит карточку регистрации.

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

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

Проверка результата и отладка

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

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

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

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

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

Альтернативы внешним формам

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

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

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