Формат EPF в 1С: что это за файл и как с ним работать

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

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

Ниже разобрано, что технически представляет собой формат EPF, чем он отличается от ERF и CF, как открыть и подключить обработку в типовых конфигурациях, какие риски несёт запуск файлов из непроверенных источников и как проверить, что обработка отработала корректно.

Что такое формат EPF и чем он отличается от других файлов 1С

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

Важно не путать EPF с похожими расширениями, с которыми сталкиваются пользователи 1С:

Ключевое практическое отличие: EPF и ERF не меняют структуру базы и не требуют обновления конфигурации — их можно запускать «на лету». А вот CF и CFE вносят изменения в метаданные и требуют административных процедур. Если вам прислали именно .epf, бояться «сломать конфигурацию» самим фактом открытия файла не стоит, но код внутри всё равно может изменить данные.

Из чего состоит внешняя обработка

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

Для просмотра и правки содержимого обработку открывают в конфигураторе 1С через «Файл — Открыть»: платформа распакует файл и покажет его структуру в привычном дереве. Там же можно изменить код и сохранить файл обратно в формате EPF. Если исходники обработки ведутся в системе контроля версий, обычно используют выгрузку в XML-файлы конфигуратора или инструменты вроде EDT, а собранный EPF хранят как готовый артефакт.

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

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

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

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

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

Как подключить EPF как дополнительную обработку

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

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

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

Безопасность: почему нельзя запускать EPF из непроверенных источников

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

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

Перед первым запуском любой обработки, изменяющей данные, сделайте резервную копию базы (выгрузку .dt или средствами СУБД) и убедитесь, что копия восстанавливается. Это единственная надёжная страховка от ошибок в чужом коде.

Типичные сценарии применения и ограничения формата

На практике EPF-обработки чаще всего используются для задач, которые не тянут на доработку конфигурации: загрузка данных из Excel и CSV, групповое изменение реквизитов, поиск и удаление дублей, перенос данных между базами, служебная диагностика. Многие полезные инструменты поставляются на диске ИТС именно в виде EPF — например, универсальные обработки поиска и замены значений.

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

Как проверить, что обработка отработала корректно

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

Контрольные точки

Как проверить результат

Форма обработки после открытия

Норма

Форма открылась, реквизиты доступны, нет сообщений об ошибках компиляции

Тревожный признак

Ошибка «Метод объекта не обнаружен» или пустое окно — несовместимость с версией платформы

Данные после выполнения

Норма

Изменения появились только в ожидаемых объектах, количество совпадает с протоколом

Тревожный признак

Изменены лишние объекты или часть операций пропущена без сообщений

Проведение документов

Норма

Документы проводятся, движения по регистрам корректны

Тревожный признак

Документы помечены непроведёнными или движения обнулены

Повторный запуск

Норма

Обработка корректно сообщает, что изменять нечего

Тревожный признак

При повторном запуске данные дублируются или затираются

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

Частые вопросы о формате EPF

Чем открыть EPF-файл, если 1С не установлена?

Никак содержательно: формат бинарный и предназначен только для платформы 1С:Предприятие. Текстовый редактор покажет нечитаемые данные. Если нужно просто посмотреть код, попросите у автора исходники в виде выгрузки XML или скриншоты модуля — без платформы работать с файлом не получится.

Чем EPF отличается от ERF?

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

Можно ли запустить EPF на Linux или macOS?

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

Почему обработка открывается, но кнопки не работают?

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

Можно ли преобразовать EPF обратно в исходный код?

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

Опасно ли открывать EPF в тестовой базе?

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