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