Внешние обработки и отчёты в Studio

Что такое файлы .epf и .erf, из каких частей состоит разобранный файл в Studio и как он собирается обратно.

Studio работает с внешними файлами 1С: внешними обработками (.epf) и внешними отчётами (.erf). Конфигурацию базы Studio не меняет.

Коротко#

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

Что такое внешняя обработка и внешний отчёт#

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

В Studio оба типа устроены одинаково. Различаются подписи: «Обработка .epf» / «Отчёт .erf» в диалоге нового файла, «Собрать .epf» / «Собрать .erf» и «Скачать .epf» / «Скачать .erf» на этапе Artifact.

Из чего состоит разобранный файл#

После загрузки или создания файла навигатор слева показывает дерево:

Внизу навигатора — карточка файла, например «Обработка <имя>» и «форм: 9 · Заменить». Подробнее об этапе исходников — Source, о формах — Обычные и управляемые формы в Studio.

Как файл попадает в Studio#

• Создать с нуля. Диалог «Новый внешний файл»: тип «Обработка .epf» или «Отчёт .erf», имя. Форма — одна, тип формы — «Обычная»; выбрать управляемую форму нельзя. Через несколько десятков секунд появляется «Исходники сохранены» — Создать новую обработку или отчёт.
• Открыть файл. Кнопка «Открыть файл» в навигаторе открывает окно выбора файла с фильтром .epf, .erf. После разбора появляется баннер «Загружена внешняя обработка <имя>.epf» — Загрузить файл .epf или .erf.

Разбор и сборка выполняются на серверах Smart1Spec. Что принимается при загрузке, перечислено в Поддерживаемые типы файлов.

Как файл собирается обратно#

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

Что из этого следует#

• Править в Studio можно код модулей. Формы, их элементы и макеты меняют в Конфигураторе.
• Всё, что код берёт из конфигурации, Studio не проверяет: опечатку в имени справочника или реквизита покажет только 1С.
• Если нужна управляемая форма, загрузите готовый файл с такой формой: в нём можно править модуль формы и просматривать форму, но создать управляемую форму в Studio нельзя.
• Сохраняйте исходный файл у себя до первой сборки: в Studio нет отката к загруженной версии после сохранения правок.

Сверено с продуктом: 27.10.2026