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

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

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

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

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

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

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

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

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

Практический вывод: EPF и ERF — «лёгкие» инструменты, которые можно запустить напрямую из пользовательского режима. CF, CFE и DT относятся к администрированию и требуют конфигуратора, а их неосторожное применение способно изменить или разрушить данные всей базы.

Как открыть файл EPF в режиме 1С:Предприятие

Самый простой способ разово запустить обработку — открыть её как обычный файл. Это работает в любой типовой конфигурации и не требует прав на изменение настроек. Порядок действий одинаков для большинства версий платформы 8.3.

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

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

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

Как подключить EPF через «Дополнительные отчеты и обработки»

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

Для подключения включите использование механизма: «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки». Затем откройте одноимённый справочник, создайте элемент и загрузите файл EPF. Если обработка написана по стандарту БСП, она сама сообщит программе свои команды: где размещаться, как называться и кому показываться.

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

Как открыть и отредактировать EPF в конфигураторе

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

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

// Пример: обработчик команды формы внешней обработки
&НаКлиенте
Процедура ВыполнитьОбработку(Команда)
	Состояние("Выполняется обработка данных...");
	ОбработатьДанныеНаСервере();
	ПоказатьПредупреждение(, "Обработка завершена");
КонецПроцедуры

Безопасность: что проверить перед запуском EPF

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

Минимальный набор мер: запускать обработки только от известных разработчиков или официальных источников, проверять файл антивирусом (сам EPF — не вирус, но вложения бывают замаскированы), тестировать на копии базы и делать резервную копию перед обработками, массово изменяющими данные. Для подключённых через БСП обработок используйте профили безопасности — платформа умеет ограничивать доступ внешнего кода к файловой системе и COM-объектам.

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

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

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

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

Частые вопросы о файлах EPF