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

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

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

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

Что такое EPF и чем он отличается от других форматов 1С

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

Близкий родственник EPF — файл ERF, внешний отчёт. Технически они устроены почти одинаково, но отчёт ориентирован на формирование результата (обычно через СКД — систему компоновки данных), а обработка — на выполнение действий: заполнение документов, обмен файлами, пакетные операции. Платформа различает эти форматы при подключении к механизму дополнительных отчётов и обработок.

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

Где применяются внешние обработки на практике

Наиболее частый сценарий — дополнительные печатные формы. Когда типовой счёт на оплату или акт не устраивает, разработчик создаёт EPF с нужным макетом, и бухгалтер печатает документ через кнопку «Печать» без каких-либо доработок конфигурации. Второй массовый сценарий — загрузка и выгрузка данных: прайсы поставщиков из Excel, выгрузка в банк-клиенты нестандартных форматов, обмен с маркетплейсами.

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

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

Самый простой способ разового запуска — открыть файл прямо из клиентского приложения. В меню выберите «Файл → Открыть» (в большинстве интерфейсов также работает сочетание Ctrl+O), укажите EPF-файл и подтвердите открытие. Платформа может показать предупреждение о безопасности — это нормальная реакция на запуск внешнего кода.

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

1. 1
   Сохраните файл в понятную папку и убедитесь, что источник надёжен
2. 2
   В клиенте 1С откройте меню «Файл → Открыть» или нажмите Ctrl+O
3. 3
   Выберите EPF-файл и подтвердите открытие
4. 4
   При предупреждении безопасности проверьте имя файла и нажмите «Да» только если доверяете источнику
5. 5
   Проверьте, что обработка открылась и выполняет ожидаемое действие на тестовых данных

Почему обработка может не открыться

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

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

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

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

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

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

Как редактировать и обновлять EPF

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

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

Безопасность и ограничения формата

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

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

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

Что выбрать: EPF, расширение конфигурации или доработку

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

Сравнение вариантов

EPF (внешняя обработка)

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

CFE (расширение конфигурации)

Для доработки типовых форм, добавления реквизитов и подмены модулей. Сохраняет обновляемость, но требует подключения к базе

Доработка конфигурации

Для глубоких изменений логики. Максимальные возможности, но снимает объекты с полной поддержки и усложняет обновления

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

Можно ли открыть EPF-файл без установленной 1С?

Нет. EPF — бинарный формат платформы «1С:Предприятие», сторонние программы его не читают. Для просмотра содержимого нужен Конфигуратор, для запуска — клиентское приложение 1С соответствующей версии платформы.

Чем EPF отличается от ERF?

EPF — внешняя обработка, ориентированная на выполнение действий (загрузка данных, печать, пакетные операции). ERF — внешний отчёт, предназначенный для формирования и вывода данных, обычно через СКД. Технически форматы близки, но при подключении платформа различает их по назначению.

Безопасно ли открывать EPF, присланный по почте?

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

Почему после подключения обработки она не видна пользователям?

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

Можно ли конвертировать EPF обратно в исходный код?

EPF и является рабочей формой обработки: код модулей доступен для просмотра и редактирования в Конфигураторе. Отдельной «декомпиляции» не требуется — если разработчик не поставил пароль на модуль, весь код открывается штатно. Модули, защищённые паролем поставщика, просмотреть нельзя.

Работает ли EPF в веб-клиенте и на Linux-сервере?

Зависит от того, как написана обработка. Если она использует только управляемые формы и серверные вызовы без привязки к локальной файловой системе — будет работать. Обработки с обращением к локальным файлам, COM-объектам Windows или модальными диалогами в веб-клиенте и на Linux обычно требуют доработки.