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