Администрирование · 10 мин
Формат EPF в 1С: что это и как открыть файл
Что такое файл EPF в 1С, как открыть его через меню Файл или конфигуратор, какие права нужны и что делать, если обработка не запускается. Пошаговая инструкция.
Файл с расширением EPF — это внешняя обработка платформы «1С:Предприятие». В таком файле хранится программный код, формы и макеты, которые выполняются поверх основной конфигурации: заполнение табличных частей, групповая обработка документов, загрузка данных из Excel, дополнительные отчёты. Расширение EPF означает External Processing File, и открыть его можно только средствами самой платформы 1С — ни Word, ни архиватор, ни сторонние просмотрщики с этим форматом не работают.
Чаще всего EPF-файлы попадают к пользователю от разработчиков, с дисков ИТС или с профильных ресурсов. Главный вопрос — не «чем открыть», а «где именно открывать»: в режиме «1С:Предприятие» для запуска обработки или в конфигураторе для просмотра и изменения кода. Оба сценария требуют установленной платформы 1С подходящей версии.
Ниже разобраны оба способа открытия, требования к правам, типичные ошибки запуска и безопасные приёмы работы с обработками из непроверенных источников.
Что находится внутри EPF-файла
EPF — это контейнер в двоичном формате платформы. Внутри него: модуль объекта с программным кодом на встроенном языке 1С, одна или несколько форм, макеты (табличные документы, схемы компоновки данных, двоичные данные) и служебная информация — синоним, версия, сведения о совместимости. Открыть этот файл текстовым редактором бессмысленно: вы увидите нечитаемые символы.
Важно не путать EPF с похожими расширениями. ERF — внешний отчёт, открывается аналогично, но предназначен для вывода данных, а не для их изменения. CFE — расширение конфигурации, подключается через конфигуратор или функциональность «Расширения» и работает постоянно, а не по запуску. CF и DT — файлы конфигурации и выгрузки базы, их открывают только в конфигураторе. Если файл не открывается, первым делом убедитесь, что расширение именно EPF.
Как открыть EPF в режиме «1С:Предприятие»
Это основной сценарий, когда обработку нужно запустить и получить результат. Запустите базу в обычном режиме под пользователем с достаточными правами. Затем откройте меню «Файл» (значок в левом верхнем углу или круглая кнопка в старых интерфейсах) и выберите пункт «Открыть». В диалоге укажите тип файла «Внешние обработки (*.epf)» или «Все файлы», перейдите к нужному файлу и подтвердите открытие.
Платформа может показать предупреждение системы безопасности о запуске внешнего файла — это нормальное поведение. Подтверждайте открытие только если доверяете источнику обработки. После запуска появится форма обработки с её кнопками и настройками; дальнейшие действия зависят от её назначения.
В некоторых конфигурациях (например, «Бухгалтерия предприятия», «Управление торговлей») есть подсистема «Дополнительные отчеты и обработки». Через неё EPF подключается постоянно: файл регистрируется в базе, и обработка становится доступна из списка без выбора файла при каждом запуске. Этот способ удобен, если обработкой пользуются регулярно.
- 1Откройте базу 1С под пользователем с правами на запуск внешних обработок
- 2В меню «Файл» выберите «Открыть»
- 3Укажите файл EPF и подтвердите открытие
- 4При предупреждении безопасности подтвердите запуск, если источнику доверяете
- 5Выполните нужные действия в форме обработки и проверьте результат в данных
Как открыть EPF в конфигураторе
Конфигуратор нужен, когда требуется посмотреть или изменить код обработки, проверить, что именно она делает с данными, или адаптировать её под свою конфигурацию. Запустите «1С:Предприятие» в режиме «Конфигуратор», затем в меню «Файл» выберите «Открыть» и укажите EPF-файл. Платформа отобразит структуру обработки: формы, модули, макеты.
Двойной щелчок по модулю объекта открывает код. По форме — визуальный редактор. Через пункт «Действия → Сохранить как» обработку можно сохранить под новым именем после доработки. Обратите внимание: изменения в EPF не затрагивают конфигурацию базы — обработка остаётся отдельным файлом.
Просмотр кода в конфигураторе — стандартный способ проверить обработку из непроверенного источника перед запуском в рабочей базе. Ищите в модуле вызовы записи и удаления объектов, обращения к файловой системе и внешним ресурсам.
Какие права и версия платформы нужны
Запуск внешних обработок контролируется ролью «Запуск внешних обработок» (в типовых конфигурациях — право «Открытие внешних отчетов и обработок» или профиль группы доступа). Если пункта «Файл → Открыть» нет или платформа выдаёт ошибку прав, обратитесь к администратору базы: он либо выдаст нужное право, либо подключит обработку через механизм дополнительных отчётов и обработок, где права настраиваются отдельно.
Вторая частая причина проблем — несовместимость версий. Обработка, созданная на более новой платформе, может не открыться на старой: появится сообщение о несовместимой версии файла. Обратная ситуация (старый EPF на новой платформе) обычно работает, но обработка, написанная под обычные формы, в тонком клиенте с управляемым интерфейсом может не запуститься. Также проверьте режим совместимости конфигурации и то, под какой клиент (толстый или тонкий) рассчитана обработка.
Как проверить, что обработка открылась корректно
Открылась форма обработки с элементами управления
Окно мигнуло и закрылось, либо появилась ошибка компиляции модуля
Нет ошибок в окне сообщений
Ошибки «Метод не обнаружен», «Переменная не определена» — код несовместим с конфигурацией
Данные изменились или отчёт сформирован как ожидалось
Обработка отработала без ошибок, но данных нет — проверьте отборы и права на объекты
Безопасность при работе с EPF из непроверенных источников
Внешняя обработка — это исполняемый код с полным доступом к данным базы в рамках прав запустившего пользователя. Вредоносный EPF может изменить или удалить документы, выгрузить данные наружу, выполнить произвольный код. Поэтому обработки с форумов и файлообменников нельзя запускать сразу в рабочей базе.
Безопасный порядок такой: сначала откройте файл в конфигураторе и просмотрите код, затем протестируйте на копии базы, и только после этого запускайте в рабочей. Перед запуском обработок, которые массово изменяют данные, сделайте резервную копию (выгрузку DT) — это единственный способ откатиться при ошибке в логике обработки.
Дополнительный уровень защиты даёт запуск под пользователем с ограниченными правами и профили безопасности в кластере серверов 1С, если у вас клиент-серверный вариант работы.
Частые ошибки и их решение
Сообщение «Нарушение прав доступа» означает, что у пользователя нет права на открытие внешних обработок — решается настройкой ролей или профиля доступа. Ошибка «Несовместимая версия файла» — обработка создана на более новой платформе; нужно либо обновить платформу, либо попросить разработчика пересохранить файл под вашу версию.
Если обработка открывается, но при запуске выдаёт ошибки вида «Метод объекта не обнаружен» или «Реквизит не найден», причина в том, что она написана под другую конфигурацию: в вашей базе нет нужных объектов или они называются иначе. Такую обработку придётся адаптировать в конфигураторе или искать версию под вашу конфигурацию.
Отдельный случай — обработка для обычного приложения в базе, работающей только в управляемом режиме. Форма просто не откроется. Решение — запустить толстый клиент в режиме обычного приложения (если конфигурация это допускает) или использовать управляемую версию обработки.
Альтернативы ручному открытию файла
Если обработка используется постоянно, разовое открытие через «Файл → Открыть» неудобно. В конфигурациях на БСП (Библиотека стандартных подсистем) зарегистрируйте EPF в справочнике «Дополнительные отчеты и обработки»: обработка появится в интерфейсе, получит назначаемые права и сможет выполняться по расписанию.
Для разработчиков удобнее работать с исходниками обработки через EDT или выгрузку в XML-файлы конфигуратором — так код попадает в систему контроля версий. А если функциональность должна стать частью конфигурации, обработку переносят в состав конфигурации или оформляют как расширение CFE.
Способы работы с EPF
Быстро для разового запуска; требует права на внешние обработки, файл выбирается каждый раз
Для просмотра и правки кода; не запускает обработку на выполнение в пользовательском режиме
Для регулярного использования: права, расписание, доступ из интерфейса; работает только в конфигурациях с БСП
Когда логика должна работать постоянно; требует навыков разработки и тестирования
Часто задаваемые вопросы
Можно ли открыть EPF без установленной 1С?
Нет. Формат EPF — внутренний формат платформы «1С:Предприятие», сторонних просмотрщиков для него не существует. Нужна установленная платформа любой подходящей версии и, для запуска, — информационная база.
Чем EPF отличается от ERF?
EPF — внешняя обработка, предназначена для действий над данными (изменение, загрузка, печать). ERF — внешний отчёт, предназначен для вывода информации. Открываются они одинаково, через «Файл → Открыть», различается только назначение и структура внутренних модулей.
Почему при открытии появляется окно с предупреждением безопасности?
Платформа предупреждает о запуске исполняемого файла из внешнего источника. Это штатная защита. Подтверждайте открытие только для файлов из доверенных источников; если файл пришёл из интернета, сначала просмотрите его код в конфигураторе.
Обработка открылась, но выдаёт ошибку «Метод не обнаружен». Что делать?
Обработка написана под другую конфигурацию или другую версию типовой. Самостоятельно это исправляется адаптацией кода в конфигураторе, что требует знания встроенного языка 1С. Проще найти версию обработки, рассчитанную именно на вашу конфигурацию.
Можно ли запускать EPF по расписанию?
Да, если конфигурация содержит подсистему «Дополнительные отчеты и обработки»: при регистрации обработки в ней доступен вариант выполнения по расписанию через регламентные задания. Простое открытие через «Файл → Открыть» такой возможности не даёт.
Как вернуть данные, если обработка испортила документы?
Автоматического отката нет. Восстановление возможно только из резервной копии (выгрузки DT или копии базы SQL). Поэтому перед запуском обработок, изменяющих данные, резервная копия обязательна, а первый запуск делается на копии базы.
Что важно запомнить
EPF открывается только платформой 1С: через «Файл → Открыть» в режиме предприятия для запуска и в конфигураторе для просмотра кода. Нужны права на внешние обработки и совместимая версия платформы. Обработки из непроверенных источников сначала изучают в конфигураторе и тестируют на копии базы с резервной копией.