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

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

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

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

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

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

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

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

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

У 1С несколько похожих расширений, и их часто путают. ERF — это тоже внешняя обработка или отчёт, но с сохранённым исходным кодом модулей. Фактически ERF — «редактируемый» брат EPF: разработчик работает с ERF, а заказчику отдаёт EPF.

Практический вывод из таблицы: если вам нужно только запускать обработку — достаточно EPF. Если нужно дорабатывать код — ищите ERF-версию у автора или конвертируйте, если защита не установлена.

Как открыть и запустить EPF-файл

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

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

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

Если обработка нужна регулярно, удобнее подключить её через стандартный механизм «Дополнительные отчеты и обработки» (в типовых конфигурациях находится в разделе «Администрирование» или «НСИ и администрирование»). Тогда обработка появится в интерфейсе у пользователей как обычная команда, без ручного открытия файла каждый раз.

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

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

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

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

Как конвертировать EPF в ERF и редактировать код

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

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

Для массовой работы с обработками удобна выгрузка в XML-файлы средствами конфигуратора или через EDT. В EDT внешние обработки импортируются в проект, где код хранится в текстовом виде и работает с системами контроля версий — это стандарт для командной разработки.

Храните у себя именно ERF-версии собственных доработок, а EPF формируйте только для передачи заказчику. Если единственная копия обработки останется в EPF с защищённым модулем и пароль будет утерян, восстановить собственный код штатными средствами не получится.

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

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

Вторая типичная ситуация — обработка открывается, но при работе выдаёт ошибки вида «Объект не найден». Это значит, что она обращается к объектам конфигурации (документам, справочникам, реквизитам), которых в вашей базе нет или которые называются иначе. Обработка, написанная под «Управление торговлей», почти наверняка не заработает в «Бухгалтерии» без адаптации.

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

Проверка результата и безопасная работа

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

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

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

Запуск обработки

Норма

Форма открывается без сообщений об ошибках

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

Ошибка компиляции модуля или «объект не найден»

Работа под обычным пользователем

Норма

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

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

«Нарушение прав доступа» при выполнении команд

Результат выполнения

Норма

Данные изменены или отчёт сформирован так, как ожидалось

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

Данные изменились непредсказуемо, появились дубли или ошибочные записи

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

Норма

Обработка работает стабильно при повторных запусках

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

Ошибки появляются нестабильно, зависят от данных

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

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

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

Без платформы 1С содержимое EPF осмысленно не открыть — это бинарный формат, понятный только платформе. Максимум, что можно сделать сторонними средствами, — посмотреть служебную структуру контейнера, но формы и код без 1С недоступны.

Можно ли восстановить пароль на модуль EPF?

Штатных средств восстановления нет — защита для того и ставится. Корректный вариант — обратиться к автору обработки за ERF-версией или исходным кодом. Сторонние утилиты снятия защиты нарушают права разработчика и могут повредить файл.

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

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

EPF от УТ подойдёт для БП или ERP?

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

Чем отличается подключение через «Дополнительные отчеты и обработки» от открытия файла?

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

Можно ли запускать EPF-обработку по расписанию?

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