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