Внешняя обработка .epf: открыть, подключить к базе и запустить без ошибок

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

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

Что такое файл EPF и откуда он берётся

Файл с расширением .epf — это внешняя обработка 1С:Предприятия 8. Внутри лежит программный код, формы и макеты, но сама обработка не встроена в конфигурацию. Её можно передать по почте, положить в общую папку и открыть в любой совместимой базе.

Рядом обычно встречается родственный формат:

• 📄 .epf — внешняя обработка: загрузка данных, групповое изменение, заполнение, печать, служебные действия;
• 📊 .erf — внешний отчёт: формирует табличный документ по данным базы.

Открываются оба формата одинаково. Всё, что написано ниже про .epf, применимо и к .erf.

Откуда берутся такие файлы:

• 🧑‍💻 их пишет программист 1С под конкретную задачу;
• 📦 их поставляют вместе с сервисами и обменами (загрузка выписок, прайсов, данных из Excel);
• 🗂 их выгружают из самой базы: в Конфигураторе любую обработку из конфигурации можно сохранить как внешнюю.

Где искать файл, если его «потеряли»

Типичные места, куда сохраняют .epf:

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

Поиск по диску в Windows: в Проводнике введите в строке поиска *.epf — система покажет все внешние обработки на выбранном диске.

Способ 1. Открыть EPF через меню «Файл»

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

1. Запустите базу в режиме 1С:Предприятие (тонкий или толстый клиент — не важно).
2. Откройте главное меню. В интерфейсе «Такси» это кнопка с тремя полосками в левом верхнем углу окна.
3. Выберите Файл → Открыть. То же самое делает сочетание Ctrl+O.
4. В окне выбора файла укажите нужный .epf и нажмите «Открыть».
5. Появится предупреждение безопасности о том, что файл может содержать опасный код. Если источник проверенный — подтвердите открытие.
6. Откроется форма обработки. Дальше работайте по её инструкции: заполните параметры, нажмите кнопку выполнения.

💡 Можно просто перетащить файл .epf мышью из Проводника в окно запущенной 1С — результат тот же, что и через меню.

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

Если пункта «Открыть» нет в меню

Пункт «Файл → Открыть» у пользователя виден только при наличии права на интерактивное открытие внешних обработок. Нет права — нет пункта, или он есть, но открытие заканчивается ошибкой. Решение — в разделе про права ниже.

Способ 2. Подключить обработку к базе через «Дополнительные отчёты и обработки»

Для типовых конфигураций на БСП (Бухгалтерия 3.0, ЗУП 3.1, УТ 11, КА, ERP) это основной способ для обработок, которыми пользуются регулярно. Файл загружается внутрь базы, и его больше не нужно искать на диске.

Шаг 1. Включить функциональность

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

Шаг 2. Загрузить файл

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

Шаг 3. Запустить

Глобальные обработки появляются в соответствующем разделе через команду «Дополнительные обработки» (например, в разделе «Администрирование» или «Банк и касса» — какой раздел вы выбрали в карточке). Печатные формы и обработки заполнения встают в меню «Печать» и «Заполнить» нужных документов.

Безопасный режим в карточке

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

Способ 3. Запуск и правка из Конфигуратора

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

1. Откройте базу в режиме Конфигуратор.
2. Выберите Файл → Открыть и укажите .epf. Откроется дерево обработки: реквизиты, формы, макеты, модули.
3. Чтобы выполнить её, нажмите F5 (Отладка → Начать отладку). Запустится 1С:Предприятие, подключённое к отладчику.
4. В запущенном сеансе откройте тот же файл через Ctrl+O. Точки останова, поставленные в модулях, сработают.
5. После правок сохраните файл (Ctrl+S) и переоткройте его в сеансе 1С:Предприятие — изменения подхватятся.

Зачем это нужно не только программисту:

• 🔍 посмотреть, что делает обработка, до запуска на рабочей базе;
• 🧩 проверить, какая у обработки форма — управляемая или обычная;
• 🛠 узнать, в какой версии платформы файл сохранён: если Конфигуратор не открывает файл, а на другом компьютере он открывается — причина в версии.

💡 Из Конфигуратора можно и обратное: открыть любую обработку из дерева конфигурации и через контекстное меню объекта — команда «Сохранить как внешнюю обработку , отчет…» — сохранить её в файл .epf. Так делают, когда хотят запустить типовую обработку в другой базе.

Права доступа и защита от опасных действий

Две отдельные настройки решают, сможет ли пользователь открыть файл: роль с правом открытия и флажок защиты.

Право на открытие

На уровне платформы за это отвечают права «Интерактивное открытие внешних обработок» и «Интерактивное открытие внешних отчетов». В типовых конфигурациях их не раздают по одному — они входят в профиль групп доступа.

Как дать право в Бухгалтерии 3.0 и ЗУП 3.1:

1. Откройте Администрирование → Настройки пользователей и прав.
2. Перейдите в «Группы доступа» (или откройте карточку пользователя и его группы).
3. Добавьте пользователя в группу с профилем «Открытие внешних отчетов и обработок» либо включите этот профиль в существующую группу.
4. Пусть пользователь перезапустит программу — права применяются при новом входе.

У профиля «Администратор» это право есть всегда.

Защита от опасных действий

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

Где она настраивается:

• 🔧 в Конфигураторе: Администрирование → Пользователи, карточка пользователя, вкладка «Основные», флажок «Защита от опасных действий»;
• 🖥 в типовых конфигурациях на БСП — в карточке пользователя в режиме 1С:Предприятие, если программа выводит эту настройку для администратора.

Не снимайте защиту массово всем пользователям. Её отключают точечно — например, для служебного пользователя, под которым по расписанию запускается обработка из командной строки и подтверждать окно некому.

Чем отличаются способы с точки зрения безопасности

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

Обработка открывается у админа, но не у бухгалтера

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

Обработка работает в файловой базе, но падает на сервере

В клиент-серверном варианте серверный код выполняется на сервере 1С, а не на компьютере пользователя. Пути вида C:\Users\Иванов\Desktop\прайс.xlsx сервер не видит. Файл нужно класть в сетевую папку с доступом для пользователя, под которым работает служба сервера 1С, или передавать его с клиента на сервер средствами самой обработки.

Автоматический запуск EPF из командной строки

Для задач по расписанию (ночная загрузка, выгрузка, обработка очереди) удобен параметр /Execute. Платформа запускает базу и сразу открывает указанную внешнюю обработку.

Файловая база:

"C:\Program Files\1cv8\common\1cestart.exe" ENTERPRISE /F"D:\Bases\Buh" /N"Робот" /P"пароль" /Execute"D:\Obr\zagruzka.epf"

Серверная база:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" ENTERPRISE /S"srv1c\buh" /N"Робот" /P"пароль" /Execute"D:\Obr\zagruzka.epf" /DisableStartupMessages

Что здесь что:

• ENTERPRISE — запуск в режиме 1С:Предприятие;
• /F — каталог файловой базы, /S — сервер и имя базы через обратный слеш;
• /N и /P — пользователь и пароль;
• /Execute — путь к .epf;
• /DisableStartupMessages — не показывать стартовые сообщения, которые остановят робота;
• /C"строка" — передать параметр, его читают в коде через ПараметрЗапуска.

Номер версии в пути 1cv8.exe замените на свой — посмотрите папку C:\Program Files\1cv8\.

Как сделать запуск полностью автоматическим

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

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

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