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

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

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

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

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

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

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

Существуют также расширения конфигурации (CFE) — их часто путают с EPF. Расширение подключается к базе постоянно и модифицирует поведение конфигурации, тогда как внешняя обработка запускается вручную на время сеанса и ничего в структуре базы не меняет.

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

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

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

1. 1
   Сохраните EPF-файл в доступную папку, при необходимости разблокируйте его в свойствах файла Windows
2. 2
   Запустите 1С в режиме «Предприятие» под пользователем с достаточными правами
3. 3
   Выберите «Файл → Открыть» или нажмите Ctrl+O и укажите файл .epf
4. 4
   Дождитесь открытия формы обработки и проверьте, что она корректно работает с данными текущей базы

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

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

Для просмотра и изменения кода внешняя обработка открывается в конфигураторе: «Файл → Открыть» с выбором .epf-файла. После открытия доступны дерево объектов обработки, модули, формы и макеты — структура аналогична обычным объектам конфигурации. Изменения сохраняются обратно в тот же файл через «Файл → Сохранить».

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

Как создать собственную внешнюю обработку

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

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

Функция СведенияОВнешнейОбработке() Экспорт
  Параметры = Новый Структура;
  Параметры.Вставить("Вид", "ДополнительнаяОбработка");
  Параметры.Вставить("Версия", "1.0");
  Возврат Параметры;
КонецФункции

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

Безопасность: что проверить перед запуском чужого EPF

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

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

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

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

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

Проверка результата и частые проблемы

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

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

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