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