Как открыть файл EPF в 1С 8.3

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

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

Что такое файл EPF и когда он нужен

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

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

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

Способ 1: разовый запуск через меню «Файл»

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

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

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

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

Способ 2: подключение через дополнительные отчёты и обработки

Когда обработка нужна регулярно и нескольким пользователям, правильнее зарегистрировать её в механизме БСП «Дополнительные отчёты и обработки». Тогда команда запуска появится в интерфейсе конфигурации, файл будет храниться внутри базы, а доступ к нему можно раздать по ролям.

Порядок подключения в типовых конфигурациях (УТ 11, ERP, БП 3.0, КА):

1. Откройте раздел «Администрирование» → «Печатные формы, отчёты и обработки».
2. Включите флажок «Дополнительные отчёты и обработки», если он ещё не установлен.
3. Перейдите по ссылке «Дополнительные отчёты и обработки» и нажмите «Создать» (или «Добавить из файла»).
4. Выберите EPF-файл. Конфигурация прочитает сведения из обработки: наименование, версию, вид, безопасный режим.
5. При необходимости укажите разделы командного интерфейса, где будет доступна команда, и настройте быстрый доступ для пользователей.
6. Запишите элемент и проверьте запуск через появившуюся команду.

Когда файл не регистрируется

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

Права, безопасный режим и защита от опасных действий

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

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

Отдельный момент — безопасный режим исполнения. При подключении через дополнительные обработки конфигурация может принудительно запускать код в безопасном режиме, где недоступны операции с файловой системой и COM-объектами. Если обработке нужны такие операции (например, чтение Excel), в карточке подключения снимается флажок безопасного режима либо выдаются разрешения — это должен делать администратор осознанно.

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

Типичные ошибки при открытии EPF и их решение

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

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

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

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

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

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

Норма

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

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

Ошибка компиляции, сообщение о недостатке прав, пустое окно

Выполнение операции

Норма

Обработка выводит результат: таблицу, отчёт, сообщение о количестве изменённых объектов

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

Зависание, аварийное завершение сеанса, ошибки в журнале регистрации

Состояние данных

Норма

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

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

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

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

Норма

Обработка открывается повторно, настройки сохраняются

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

Ошибка при повторном открытии, потеря настроек

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

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

Можно ли открыть EPF в обычном приложении 1С 8.3?

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

Чем открыть EPF вне 1С, чтобы посмотреть содержимое?

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

Почему кнопка «Открыть» неактивна или файл не запускается у обычного пользователя?

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

Чем EPF отличается от файла CF?

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

Обработка просит отключить безопасный режим — это опасно?

Безопасный режим запрещает обращения к файловой системе, COM-объектам и внешним компонентам. Если обработка загружает файлы Excel или работает с оборудованием, ей действительно нужен полный режим. Разрешайте это только обработкам из доверенных источников и желательно после теста на копии базы.

Можно ли запускать EPF автоматически по расписанию?

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