К статье
Практический материал

Администрирование · 9 мин

EPF файлы 1С: как открыть внешнюю обработку

Что такое EPF-файл в 1С, чем он отличается от ERF, как открыть внешнюю обработку в режиме Предприятия и Конфигуратора, типичные ошибки и их решение.

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

Открыть EPF-файл можно двумя способами: в режиме «1С:Предприятие» — для работы с обработкой как пользователю, и в Конфигураторе — для просмотра и редактирования кода. Оба способа штатные, не требуют сторонних программ и доступны во всех актуальных версиях платформы 8.3.

Важно понимать: EPF-файлы выполняют произвольный код со встроенного языка 1С. Обработка из непроверенного источника может прочитать, изменить или удалить данные базы. Перед первым запуском стоит убедиться в надёжности источника и при возможности проверить код в Конфигураторе.

Что такое EPF-файл и чем он отличается от ERF

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

Родственный формат ERF (External Report File) — это внешний отчёт. Технически отличие минимально: у отчёта основной объект — отчёт, а не обработка, и он обычно строится на схеме компоновки данных. Оба формата открываются одинаково — через меню «Файл — Открыть».

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

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

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

Порядок действий одинаков для большинства конфигураций — «Бухгалтерия предприятия», «Управление торговлей», «Зарплата и управление персоналом» и других типовых решений на управляемых формах.

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

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

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

Как открыть EPF в Конфигураторе для просмотра кода

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

Запустите Конфигуратор для любой базы (можно пустой тестовой), затем выберите «Файл — Открыть» и укажите EPF-файл. Платформа покажет структуру обработки: формы, макеты, модуль объекта. Двойной щелчок по модулю открывает код для чтения и редактирования.

Изменённую обработку можно сохранить обратно в EPF через «Файл — Сохранить» или «Сохранить как». Это стандартный способ доработки внешних печатных форм и утилит без вмешательства в конфигурацию базы.

Регистрация обработки в справочнике дополнительных отчётов и обработок

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

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

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

Почему EPF-файл не открывается: типичные причины

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

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

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

Типичные ошибки
01
Открытие обработки не в той базе: загрузочная утилита изменила данные рабочей базы вместо тестовой — восстановление только из копии.
02
Попытка открыть EPF двойным щелчком в Проводнике: Windows не знает этот формат, файл нужно открывать изнутри 1С.
03
Игнорирование предупреждения безопасности: запуск обработки из непроверенного источника с правами полного доступа.
04
Путаница EPF и CF: файл конфигурации нельзя запустить как обработку и наоборот.

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

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

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

Администраторам имеет смысл ограничить права: пользователям без необходимости не нужны права на интерактивное открытие внешних обработок. Это снижает риск случайного или злонамеренного запуска постороннего кода.

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

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

Обработка открылась
Норма

Появилась форма с элементами управления, ошибок нет

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

Окно ошибки о структуре файла или несовместимости версии

Источник файла
Норма

Официальный ресурс поставщика или доверенный разработчик

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

Файл из письма, мессенджера или неизвестного сайта

Поведение после запуска
Норма

Обработка выполняет заявленные действия в интерфейсе

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

Появляются незапрошенные действия, запросы, ошибки прав

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

Можно ли открыть EPF-файл без установленной 1С?

Нет. EPF — бинарный формат платформы 1С:Предприятие, сторонние программы и просмотрщики его не поддерживают. Нужна установленная платформа версии 8.3, в которой файл открывается через «Файл — Открыть» в режиме Предприятия или Конфигуратора.

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

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

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

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

Обработка требует другую версию платформы — что делать?

Обновите платформу до версии, в которой сохранён файл, либо попросите автора пересохранить обработку в вашей версии. Самостоятельно «переконвертировать» бинарный EPF без платформы нужной версии нельзя.

Можно ли посмотреть код EPF-файла?

Да, если код не закрыт автором паролем или поставкой без исходного текста. Откройте файл в Конфигураторе через «Файл — Открыть» и посмотрите модуль объекта. Если модуль поставляется без исходного кода, увидеть его нельзя.

Изменит ли открытие EPF-файла мою конфигурацию?

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

Итог

Что важно запомнить

EPF-файл открывается штатно из 1С: «Файл — Открыть» в режиме Предприятия для запуска и в Конфигураторе для просмотра кода. Для постоянного использования обработку регистрируют в справочнике дополнительных отчётов и обработок. Главное правило безопасности: запускать только файлы из доверенных источников и проверять новые обработки на копии базы.