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