EPF в 1С: как установить внешнюю обработку

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

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

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

Что такое EPF и когда его подключают

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

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

Подготовка: что проверить до установки

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

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

Способ 1: разовое открытие через меню «Файл»

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

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

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

Способ 2: регистрация в справочнике «Дополнительные отчеты и обработки»

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

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

Пошаговая регистрация обработки

Откройте справочник «Дополнительные отчеты и обработки» (ссылка в том же разделе «Администрирование»). Нажмите «Создать» и в открывшейся форме загрузите EPF-файл с диска. Программа считает сведения из самой обработки: наименование, версию, безопасный режим, вид (заполнение объекта, печатная форма, отчёт, произвольная обработка).

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

Публикация обработки без поддержки БСП

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

Проверка результата после установки

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

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

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

Элемент в справочнике «Дополнительные отчеты и обработки»

Норма

Запись создана, файл загружен, размещение указано

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

Запись не сохраняется или файл не загружается

Команда в интерфейсе пользователя

Норма

Команда видна в нужном разделе у нужных пользователей

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

Команды нет даже после перезапуска сеанса

Запуск обработки

Норма

Форма открывается, операции выполняются без ошибок

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

Ошибка компиляции или сообщение о несовместимости

Работоспособность лучше проверять на копии базы или на тестовом документе. Особенно это касается обработок, которые массово изменяют данные: групповая обработка проведения, загрузка номенклатуры, пересчёт остатков. Ошибка в такой обработке затронет сразу много объектов.

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

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

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

Обновление, замена и удаление обработки

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

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

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

Можно ли установить EPF в 1С:Бухгалтерию в облаке (1С:Фреш)?

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

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

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

Обработка открылась, но кнопки не работают и появляются ошибки. Что делать?

Скорее всего, обработка рассчитана на другую конфигурацию или версию. Уточните у разработчика целевую конфигурацию и минимальную версию платформы, сравните со своей. Ошибки вида «объект не найден» почти всегда означают несовместимость.

Чем EPF отличается от расширения конфигурации (CFE)?

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

Нужно ли останавливать работу пользователей для регистрации обработки?

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

Как узнать, что именно делает скачанный EPF-файл?

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