Внешняя обработка .epf: три способа открыть файл в 1С 8.3 и что делать, если он не запускается

Чтобы запустить EPF-файл в 1С 8.3, откройте базу в режиме «1С:Предприятие», нажмите Ctrl+O (или главное меню ☰ → Файл → Открыть), выберите файл .epf и подтвердите предупреждение о безопасности. Обработка откроется в новом окне. Это самый быстрый способ для разового запуска.

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

Что такое внешняя обработка EPF и зачем её запускают

EPF (External Processing File) — это внешняя обработка 1С:Предприятия 8. Она хранится отдельным файлом рядом с базой, а не внутри конфигурации. Программист может написать её без изменения типовой конфигурации, поэтому обновления базы такой файл не ломают.

Типичные задачи внешних обработок:

• 📥 загрузка данных из Excel , CSV, выгрузок банка или маркетплейса;
• 🖨 нестандартные печатные формы: накладные, акты, этикетки по образцу клиента;
• 🧹 групповое изменение реквизитов, перепроведение, исправление ошибок в данных;
• 🔍 проверки и поиск: дубли контрагентов, незаполненные поля, расхождения;
• 🛠 служебные утилиты: консоль запросов, выгрузка и загрузка данных XML.

Внешний отчёт — родственник обработки с расширением .erf. Запускают его теми же способами. Разница в назначении: отчёт формирует таблицу на основе схемы компоновки данных, обработка — выполняет действия.

Подготовка к запуску: файл, права и тип клиента

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

Откуда файл и для какой конфигурации

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

Права пользователя

Открыть файл с диска можно только при наличии права «Интерактивное открытие внешних обработок» (для отчётов — «внешних отчётов»). У пользователя с полными правами оно есть. В типовых конфигурациях на БСП это право входит в отдельную роль, которую администратор добавляет в профиль группы доступа: Администрирование → Настройки пользователей и прав → Профили групп доступа.

Тип клиента: тонкий или толстый

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

Обработки на управляемых формах работают в любом клиенте, включая веб.

Версия платформы

Файл, сохранённый в более новой платформе, может не открыться в старой. Если у программиста платформа 8.3.25, а у вас 8.3.18, попросите его сохранить файл в режиме совместимости или обновите платформу до номера не ниже того, на котором сделана обработка.

Как запустить EPF-файл через меню «Файл → Открыть»

Способ подходит для разового запуска и для проверки нового файла. Работает во всех конфигурациях на платформе 8.3.

Шаг 1. Откройте базу в режиме «1С:Предприятие»

В окне запуска выберите базу и нажмите 1С:Предприятие, не Конфигуратор. В Конфигураторе файл тоже откроется, но как исходник для редактирования, а не для работы.

Шаг 2. Выберите файл

1. Нажмите Ctrl+O или откройте главное меню (кнопка ☰ в левом верхнем углу окна) и выберите Файл → Открыть….
2. В окне выбора файла укажите тип «Внешняя обработка (*.epf)», если файл не виден.
3. Выделите файл и нажмите Открыть.

Шаг 3. Подтвердите предупреждение

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

После этого откроется основная форма обработки. Дальше всё зависит от её назначения: выбрать файл загрузки, задать период, нажать кнопку «Выполнить» или аналогичную.

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

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

Где находится справочник

Сначала включите функциональность, затем откройте справочник:

На этой странице установите флажок «Дополнительные отчеты и обработки», после чего станет активной одноимённая ссылка.

Добавление файла

1. Перейдите по ссылке «Дополнительные отчеты и обработки».
2. Нажмите Создать (или Добавить из файла, в зависимости от релиза) и выберите .epf.
3. Программа прочитает сведения из файла и заполнит наименование, вид и версию.
4. На вкладке размещения укажите разделы, в которых должна появиться команда, и пользователей, которым она доступна.
5. Нажмите Записать и закрыть.

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

Почему файл не регистрируется

Регистрировать можно не всякую обработку. В модуле объекта должна быть экспортная функция СведенияОВнешнейОбработке(): из неё программа узнаёт вид обработки, версию, команды и место размещения. Если функции нет, программа сообщит, что обработка не поддерживает регистрацию. Такой файл можно только открыть через Файл → Открыть или попросить программиста доработать его под БСП.

Другие способы запуска внешней обработки

Командная строка и ярлык: ключ /Execute

Ключ /Execute запускает 1С:Предприятие и сразу открывает указанную обработку. Пример для файловой базы:

"C:\Program Files\1cv8\8.3.25.1374\bin\1cv8.exe" ENTERPRISE /F"D:\Bases\Buh" /N"Администратор" /P"пароль" /Execute"D:\Obr\Zagruzka.epf"

Для серверной базы вместо /F используют /S"сервер\имя_базы". Путь к 1cv8.exe подставьте свой: номер версии в папке у вас другой.

Такую строку кладут в ярлык на рабочий стол или в задание планировщика Windows. Чтобы обработка выполнила работу без нажатия кнопок, программист пишет действие в обработчике открытия формы и завершает сеанс после выполнения.

Конфигуратор: просмотр и правка кода

В Конфигураторе Файл → Открыть открывает EPF как отдельный объект: видны реквизиты, формы, модули. Отсюда же можно запустить обработку на отладку (F5). Обычному пользователю этот путь не нужен, но он полезен, чтобы проверить код незнакомого файла перед запуском в рабочей базе.

Если модуль защищён паролем, код вы не увидите. Это не признак вредоносности, но повод спросить автора, что делает обработка.

Из кода другой обработки или расширения

Разработчики подключают внешнюю обработку программно. В клиент-серверном варианте файл сначала помещают во временное хранилище, затем на сервере вызывают ВнешниеОбработки.Подключить() и открывают форму по полученному имени. Метод по умолчанию подключает обработку в безопасном режиме: она не сможет обращаться к файлам, внешним компонентам и COM-объектам без отдельного разрешения.

1С:Фреш и другие облака

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

Почему EPF не открывается: ошибки и решения

Если обработка зависла на большом объёме данных, не закрывайте 1С через диспетчер задач сразу. Сначала подождите: загрузка 50 000 строк из Excel может идти десятки минут. Принудительное завершение посреди записи оставит часть данных изменёнными, а часть нет.

Как запускать внешние обработки безопасно

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

Практические правила:

• 🔒 не запускайте файлы из писем и мессенджеров, если не знаете отправителя;
• 👀 перед первым запуском откройте файл в Конфигураторе и посмотрите модуль объекта и модули форм: подозрительны КомандаСистемы, ЗапуститьПриложение, создание COM-объектов, отправка HTTP-запросов на неизвестные адреса;
• 🧪 проверяйте новую обработку на копии базы, а не на рабочей;
• 👥 не выдавайте всем пользователям право интерактивного открытия внешних обработок: оставьте его администраторам, остальным подключайте проверенные файлы через справочник;
• 🛡 не отключайте защиту от опасных действий у рядовых пользователей.

Флажок «Защита от опасных действий» находится в карточке пользователя в Конфигураторе: Администрирование → Пользователи. Снимать его имеет смысл только у разработчика, которому предупреждение мешает при отладке.

EPF, ERF, CF, CFE: какой файл чем открывать

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

Что выбрать, если доработку можно сделать разными способами:

• EPF/ERF — разовые и редкие задачи, загрузки, печатные формы, отчёты. Не зависят от обновлений и не требуют монопольного доступа.
• CFE — когда нужно изменить поведение типовых документов и форм: добавить реквизит , поменять проверку. Расширения появились в платформе 8.3.6 и переживают обновления типовой конфигурации лучше, чем правка основной.
• Правка CF — крайний случай: конфигурация снимается с поддержки, и каждое обновление превращается в ручное объединение.

Никогда не загружайте .dt в рабочую базу, чтобы «посмотреть, что внутри» — загрузка полностью заменит ваши данные содержимым файла.

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