Как выгрузить EPF из 1С: инструкция для разных сценариев

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

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

Что такое EPF и когда требуется его выгрузка

EPF (External Processing File) — бинарный файл внешней обработки платформы «1С:Предприятие». Внутри него упакованы модуль объекта, формы, макеты и другие ресурсы. Такой файл запускается командой «Файл → Открыть» в режиме предприятия или подключается через механизм дополнительных отчетов и обработок (БСП), не требуя изменения конфигурации.

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

Как сохранить открытую обработку в EPF-файл

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

Откройте конфигуратор под пользователем с правами администратора. Загрузите обработку через меню «Файл → Открыть», выбрав нужный EPF-файл. Затем выберите «Файл → Сохранить как», укажите папку, имя файла и убедитесь, что в поле «Тип файла» выбрано «Внешняя обработка (*.epf)». После нажатия «Сохранить» файл появится на диске.

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

1. 1
   Откройте конфигуратор с правами администратора
2. 2
   Выполните «Файл → Открыть» и выберите обработку
3. 3
   Убедитесь, что обработка открылась без ошибок компиляции
4. 4
   Выберите «Файл → Сохранить как» и тип «Внешняя обработка (*.epf)»
5. 5
   Укажите папку и имя, нажмите «Сохранить»
6. 6
   Проверьте, что файл открывается повторно

Как выгрузить обработку из дерева конфигурации

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

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

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

Как извлечь EPF из справочника дополнительных обработок

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

Откройте раздел «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки». Найдите нужный элемент списка и откройте его карточку. В карточке доступна команда «Выгрузить в файл» (в некоторых версиях — «Сохранить на диск» или аналогичная кнопка в меню «Ещё»). Укажите папку — обработка будет сохранена как EPF-файл.

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

Как собрать EPF из исходных файлов

При работе с системой контроля версий обработки хранят в виде набора XML-файлов: конфигуратор умеет выгружать внешнюю обработку в исходники и загружать её обратно. Это удобно для code review и отслеживания изменений.

Чтобы выгрузить обработку в исходники, откройте её в конфигураторе и выполните «Конфигурация → Выгрузить внешнюю обработку/отчет в файлы» (либо используйте пакетный режим конфигуратора с параметром DumpExternalDataProcessorOrReportToFiles). Для обратной сборки используется команда загрузки из файлов — на выходе получается готовый EPF.

Пример пакетной сборки из командной строки:

"C:\Program Files\1cv8\<версия>\bin\1cv8.exe" DESIGNER /F"C:\Bases\Test" /N"Администратор" /LoadExternalDataProcessorOrReportFromFiles "C:\src\MyReport.xml" "C:\out\MyReport.epf"

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

Как проверить выгруженный файл

После выгрузки стоит убедиться, что EPF не повреждён и содержит именно ту обработку, которая нужна. Минимальная проверка — открыть файл в конфигураторе: если структура обработки (формы, макеты, модуль) отображается корректно, файл в порядке.

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

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

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

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

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