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

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

Формат EPF встречается повсеместно: доработки от франчайзи 1С, бесплатные обработки с портала Infostart, универсальные инструменты вроде «Консоли запросов» или «Универсального подбора и обработки объектов» распространяются именно в этом виде. Пользователь получает один файл, открывает его в своей базе — и получает готовый функционал.

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

Что такое внешняя обработка и зачем она нужна

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

Типовые сценарии использования внешних обработок:

• разовые сервисные операции: поиск и удаление дублей, перенумерация документов, очистка устаревших данных;
• загрузка и выгрузка данных: импорт номенклатуры из Excel, обмен с банком или с сайтом;
• заполнение табличных частей документов по кнопке «Заполнить» — механизм заполнения табличных частей в типовых конфигурациях рассчитан именно на внешние обработки;
• печатные формы, которых нет в типовой поставке;
• инструменты разработчика и администратора: консоль запросов, редактор движений документа, просмотр регистров.

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

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

У платформы 1С несколько похожих расширений файлов, и их часто путают. Разобраться в различиях важно, потому что способ открытия и назначение у них разные.

Практически важна пара EPF/ERF: обе открываются одинаково, но назначение разное. Отчёт (ERF) по замыслу только читает данные и выводит результат, обработка (EPF) обычно что-то изменяет. Технически платформа этому не препятствует: код отчёта тоже может записывать данные, поэтому правило «сначала резервная копия» относится к обоим форматам.

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

EPF или расширение конфигурации

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

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

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

Подходит для постоянных доработок интерфейса и логики. Управляется централизованно, но требует прав администратора и проверки совместимости при обновлениях.

Как открыть EPF-файл в режиме «Предприятие»

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

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

Есть нюанс с механизмом защиты от опасных действий. В современных версиях платформы при открытии внешних файлов появляется предупреждение, а в некоторых настройках открытие вообще блокируется. Это управляется параметром «Защита от опасных действий» в свойствах пользователя (в конфигураторе: «Администрирование» → «Пользователи» → профиль пользователя) и настройками профилей безопасности кластера. Отключать защиту глобально ради одного файла не стоит — лучше открывать обработку под учётной записью, где защита настроена осознанно.

После открытия проверьте, что обработка действительно делает то, что заявлено. Хороший признак — наличие режима «тест» или «только показать, что будет изменено». Если обработка сразу пишет данные без предварительного просмотра, запускайте её на копии базы или на небольшом количестве объектов.

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

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

Порядок подключения:

1. Включите механизм: «Администрирование» → «Печатные формы, отчёты и обработки» → установите флаг «Дополнительные отчёты и обработки».
2. Перейдите по появившейся ссылке «Дополнительные отчёты и обработки» и нажмите «Добавить из файла».
3. Выберите EPF-файл. Платформа прочитает сведения из модуля обработки: наименование, версию, вид (заполнение объекта, печатная форма, отчёт, дополнительная обработка и т.д.).
4. Настройте размещение: в каких разделах или для каких документов обработка будет доступна, и права — кому из пользователей она видна.
5. Запишите и проверьте: обработка должна появиться в заявленных разделах или в меню документа («Заполнить», «Печать» или «Дополнительные обработки»).

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

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

Для просмотра и доработки кода EPF-файл открывают в конфигураторе: «Файл» → «Открыть» → выбор файла. Появится структура обработки: формы, макеты, модуль объекта. Редактирование ничем не отличается от работы с обычной обработкой внутри конфигурации — доступны отладка, синтакс-помощник, проверка модуля.

Типовая задача — адаптировать обработку под свою конфигурацию. Например, обработка писалась под «Управление торговлей», а нужно запустить её в ERP: имена реквизитов и документов могут отличаться, и код потребует правки. Перед изменениями сохраните исходный файл отдельно, чтобы можно было откатиться.

Перед запуском чужой обработки полезно открыть её в конфигураторе и поиском по модулям проверить подозрительные места: обращения к внешним компонентам, HTTP-запросы, запуск внешних приложений, операции удаления данных. Это занимает несколько минут и снимает большинство вопросов безопасности.

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

Безопасность: риски и обязательные проверки

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

Минимальный набор мер:

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

Контрольные точки

Как проверить результат работы обработки

Количество обработанных объектов

Норма

Совпадает с ожидаемым числом из отбора

Тревожный признак

Обработано больше объектов, чем планировалось, или есть пропуски

Контрольные документы до и после

Норма

Изменились только целевые реквизиты, движения корректны

Тревожный признак

Затронуты посторонние реквизиты, периоды или связанные документы

Журнал регистрации

Норма

Нет ошибок записи и отказов в доступе

Тревожный признак

Массовые ошибки, обрывы транзакций

Типичные ошибки при работе с EPF

Отдельный частый случай — «обработка открылась и сразу закрылась» или пустое окно. Обычно это означает несовместимость интерфейса (обычные формы против управляемых) либо ошибку в обработчике «ПриСозданииНаСервере». Диагностируется открытием файла в конфигураторе и запуском под отладчиком.

Можно ли создать собственную EPF-обработку

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

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

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

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

Чем открыть файл EPF, если 1С не установлена?

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

Можно ли запустить EPF автоматически, по расписанию?

Да, если обработка зарегистрирована в механизме «Дополнительные отчёты и обработки» и поддерживает выполнение по расписанию (в карточке обработки настраивается расписание, команда должна иметь вариант вызова «ВызовСерверногоМетода»). Открытые вручную через «Файл → Открыть» обработки по расписанию не выполняются.

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

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

Что делать, если обработка испортила данные?

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

Работает ли EPF в файловой и клиент-серверной базе одинаково?

С точки зрения пользователя — да: файл открывается одинаково. Различия проявляются в коде: обработки, использующие прямой доступ к файловой системе или внешние компоненты на клиенте, в клиент-серверном варианте и в веб-клиенте могут работать иначе или требовать установки компонентов на сервере.

Чем внешний отчёт ERF отличается от обработки EPF при подключении?

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