Что такое файлы с расширением EPF в 1С и как с ними работать

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

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

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

Что находится внутри EPF-файла

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

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

Как открыть EPF в режиме Предприятия

Самый простой способ запуска — меню «Файл — Открыть» (сочетание Ctrl+O) в тонком или толстом клиенте. Укажите путь к файлу, и обработка откроется как обычное окно приложения. В типовых конфигурациях на управляемых формах тот же путь доступен через «Ещё — Открыть файл» или через сервисные обработки в разделе администрирования.

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

1. 1
   Сохраните EPF-файл в каталог, доступный пользователю 1С
2. 2
   Запустите 1С в режиме Предприятия под пользователем с достаточными правами
3. 3
   Откройте меню «Файл — Открыть» и выберите файл
4. 4
   Дождитесь загрузки формы обработки и проверьте, что она отображается корректно
5. 5
   Выполните тестовый запуск на небольшом объёме данных

Открытие через «Дополнительные отчеты и обработки»

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

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

Чтобы посмотреть или изменить код обработки, запустите конфигуратор любой базы (подойдёт даже пустая) и выполните «Файл — Открыть», выбрав EPF. Обработка откроется в дереве объектов: доступны формы, макеты и модуль объекта. Редактирование ничем не отличается от работы с обработкой внутри конфигурации — после изменений файл сохраняется тем же пунктом «Сохранить».

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

Конвертация EPF в ERF и обратно

Для переноса обработки в систему контроля версий или командной разработки EPF преобразуют в исходники ERF. Штатного пункта в интерфейсе конфигуратора для этого нет: конвертацию выполняют через пакетный запуск конфигуратора с ключом DumpExternalDataProcessorOrReportToFiles или с помощью инструментов вроде OneScript и EDT. Обратная сборка из исходников в EPF выполняется аналогично — командой LoadExternalDataProcessorOrReportFromFiles.

v8.exe DESIGNER /F"C:\base" /DumpExternalDataProcessorOrReportToFiles "C:\src\MyProc" "C:\files\MyProc.epf"

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

Чем EPF отличается от похожих форматов

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

Безопасность при работе с внешними обработками

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

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

Типичные проблемы и их решение

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

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

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