Внешняя обработка .epf: разовый запуск, подключение к базе и проверка кода
Содержание
Установить EPF в 1С можно двумя путями. Для разового запуска откройте главное меню (кнопка с тремя полосками слева вверху) и выберите Файл → Открыть или нажмите Ctrl+O, укажите файл .epf. Чтобы обработка постоянно жила в базе и была доступна пользователям из меню, загрузите её в справочник: Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки → Создать.
Первый способ подходит для любой внешней обработки. Второй работает только с файлами, которые автор подготовил под подключение к типовой конфигурации. Ниже по шагам оба варианта, плюс что делать администратору в Конфигураторе.
Что за файл .epf и чем он отличается от .erf
EPF (External Processing File) — внешняя обработка 1С:Предприятия 8. Это отдельный файл с кодом, формами и макетами, который запускается в базе, но не входит в конфигурацию. Типовую конфигурацию при этом снимать с поддержки не нужно.
Чем обычно оказывается такой файл:
- 🖨️ печатная форма — свой бланк счёта, накладной или договора;
- 📥 загрузка данных — номенклатура из Excel, выписки, остатки;
- 🧹 групповая обработка — перепровести, заменить реквизит, почистить справочник;
- 🧾 заполнение табличной части документа по своим правилам;
- 🔧 служебный инструмент — консоль запросов, поиск ссылок, выгрузка.
Рядом часто лежит файл .erf — это внешний отчёт. Устанавливается он точно так же, разница только в назначении: отчёт показывает данные, обработка их меняет или загружает.
Если файл пришёл в архиве .zip или .rar, сначала распакуйте его в обычную папку. Открыть .epf прямо из архива можно, но при повторном запуске 1С будет искать файл во временном каталоге, которого уже нет.
Что проверить перед установкой обработки
Пять минут подготовки снимают большую часть проблем при установке EPF.
Для какой конфигурации написан файл
Внешняя обработка обращается к справочникам, документам и регистрам конкретной конфигурации. Файл, сделанный для 1С:Бухгалтерии 3.0, в ЗУП 3.1 почти наверняка упадёт с ошибкой. Уточните у автора конфигурацию и желательно релиз, на котором обработку проверяли.
Обычные или управляемые формы
Обработки для старых конфигураций (Бухгалтерия 2.0, УТ 10.3) написаны на обычных формах. Современные типовые решения работают в управляемом приложении и тонком клиенте. Обычную форму тонкий клиент не покажет, а главное — код такой обработки ссылается на объекты старой конфигурации. Для БП 3.0, ЗУП 3.1 и УТ 11 нужен файл на управляемых формах.
Версия платформы
Если обработку сохраняли в более новой версии платформы, старая может её не открыть. Номер своей версии смотрите в главном меню: Справка → О программе. Номер платформы у вас должен быть не ниже, чем у автора, иначе попросите у него файл под вашу версию.
Права пользователя
Открыть внешнюю обработку
может не каждый. В типовых конфигурациях на БСП для этого нужна роль «Интерактивное открытие внешних отчетов и обработок». Она входит в профиль администратора, а обычному бухгалтеру её выдают отдельно через Администрирование → Настройки пользователей и прав → Группы доступа.
Способ 1. Разовый запуск EPF через меню «Файл»
Так проверяют новую обработку или запускают служебный инструмент, который нужен раз в месяц. В базу ничего не записывается.
- Запустите 1С в режиме «1С:Предприятие».
- Откройте главное меню — кнопка с тремя полосками в левом верхнем углу окна.
- Выберите
Файл → Открытьили нажмитеCtrl+O. - Укажите файл .epf и нажмите «Открыть».
- Если появится предупреждение безопасности, прочитайте его и подтвердите открытие, только если доверяете источнику файла.
- Откроется форма обработки — дальше работайте по инструкции автора.
Второй вариант того же действия — перетащить файл мышью из Проводника прямо в окно 1С.
В конфигурациях на обычных формах (БП 2.0, УТ 10.3) команда та же: верхнее меню Файл → Открыть в толстом клиенте.
Почему появляется предупреждение безопасности
В платформе 8.3 у пользователя есть флажок «Защита от опасных действий». Когда он включён, при открытии внешней обработки 1С спрашивает подтверждение: файл может выполнять любой код. Флажок ставит администратор в Конфигураторе: Администрирование → Пользователи, карточка пользователя.
Не снимайте защиту «чтобы не мешала». Предупреждение — последний барьер перед запуском чужого кода в рабочей базе.
Способ 2. Подключение EPF к базе как дополнительной обработки
Так ставят печатные формы и обработки, которыми пользуются постоянно. Файл сохраняется внутри информационной базы, поэтому доступен всем пользователям и на всех компьютерах, включая работу через RDP.
Включите использование дополнительных обработок
В типовых конфигурациях механизм по умолчанию может быть выключен. Путь к настройке:
| Конфигурация | Где включить и открыть список |
|---|---|
| Бухгалтерия предприятия 3.0 | Администрирование → Печатные формы, отчеты и обработки |
| ЗУП 3.1 | Администрирование → Печатные формы, отчеты и обработки |
| Управление торговлей 11 | НСИ и администрирование → Печатные формы, отчеты и обработки |
На этой странице поставьте флажок «Дополнительные отчеты и обработки». Рядом станет активна одноимённая ссылка — по ней открывается список.
Загрузите файл
- В списке дополнительных отчётов и обработок нажмите «Создать».
- Выберите файл .epf на диске. Если файл не предлагается сразу, нажмите в карточке «Загрузить из файла».
- Подтвердите предупреждение о безопасности.
- Карточка заполнится сама: наименование, версия, вид обработки и список команд берутся из файла.
Настройте размещение и доступ
От вида обработки зависит, где она появится:
| Вид в карточке | Где искать после установки |
|---|---|
| Печатная форма | Кнопка «Печать» в документе или списке, для которого она сделана |
| Заполнение объекта | Кнопка «Заполнить» в форме документа |
| Дополнительная обработка | Команда «Дополнительные обработки» в выбранном разделе |
| Дополнительный отчёт | Команда «Дополнительные отчеты» в выбранном разделе |
| Создание связанных объектов | Кнопка «Создать на основании» |
Для дополнительной обработки и отчёта откройте в карточке настройку размещения и отметьте разделы, например «Продажи» или «Банк и касса». Для печатных форм объекты назначения обычно уже указаны автором.
В таблице команд укажите, кому нужен быстрый доступ. Если пользователей не отметить, команда может не появиться в разделе, хотя обработка загружена.
Нажмите «Записать и закрыть». Перезапускать программу не нужно.
Как запустить установленную обработку
- 🖨️ печатная форма — откройте документ, нажмите «Печать» и выберите новую форму;
- 📂 дополнительная обработка — зайдите в раздел, откройте «Дополнительные обработки», выделите строку и нажмите «Выполнить».
Поле «Публикация» в карточке позволяет временно отключить обработку, не удаляя её. Удобно, если после обновления конфигурации она начала сбоить.
Если файл не загружается в справочник
Справочник принимает только обработки со служебной экспортной функцией СведенияОВнешнейОбработке() в модуле объекта. Через неё 1С узнаёт вид, версию и команды. Обычная «самописная» обработка без этой функции в список не встанет — её запускают способом 1 или просят автора доработать.
Способ 3. Работа с EPF в Конфигураторе и из командной строки
Этот путь нужен администраторам и программистам. Пользователю для установки обработки Конфигуратор не нужен.
Открыть и посмотреть код
- Запустите базу в режиме «Конфигуратор».
- Выберите
Файл → Открытьи укажите .epf. - Откроется дерево обработки: реквизиты, табличные части, формы, макеты.
- Модуль объекта откройте через контекстное меню корня дерева: «Открыть модуль объекта».
Здесь можно поправить код, сохранить файл
и проверить его в пользовательском режиме. Отладка запускается из Конфигуратора обычным порядком, а обработка открывается в запущенном клиенте через Файл → Открыть. Монопольный доступ к базе для этого не нужен.
Встроить в конфигурацию
Внешнюю обработку можно перенести внутрь конфигурации: в дереве метаданных, на ветке «Обработки», есть команда вставки внешней обработки. Для типовой конфигурации на поддержке это плохая идея: придётся включать возможность изменения, и каждое обновление станет сложнее. Если обработка нужна в составе программы, правильнее оформить её в расширении конфигурации (.cfe).
Запуск из командной строки
Обработку можно открыть сразу при старте базы ключом /Execute. Это удобно для ярлыка на рабочем столе или регламентной загрузки:
"C:\Program Files\1cv8\8.3.XX.XXXX\bin\1cv8.exe" ENTERPRISE /F "D:\Bases\Buh" /N "Администратор" /P "пароль" /Execute "D:\Обработки\ZagruzkaPrice.epf"
Для серверной базы вместо /F используют /S "сервер\имя_базы". Путь к 1cv8.exe подставьте свой — он зависит от установленной версии платформы.
Не храните пароль администратора в ярлыке на общем компьютере. Для автоматических задач заведите отдельного пользователя с минимальными правами.
Как проверить внешнюю обработку на безопасность
EPF выполняется с правами того, кто её запустил. Обработка от администратора может удалить документы, выгрузить базу или запустить программу на компьютере. Поэтому файл из интернета или от незнакомого подрядчика сначала проверяют.
Где брать обработки
- ✅ от внедренца, с которым у вас договор и который отвечает за результат;
- ✅ от своего штатного программиста, с исходником в системе хранения;
- ⚠️ с форумов и файлообменников — только после проверки кода;
- ❌ файлы с закрытым кодом «без исходников» от неизвестных авторов.
Что искать в модуле
Откройте обработку в Конфигураторе (способ 3) и поищите по модулю объекта и модулям форм (Ctrl+F):
| Что в коде | Чем опасно |
|---|---|
УдалитьФайлы, КопироватьФайл, ПереместитьФайл | Работа с файлами на диске |
ЗапуститьПриложение, КомандаСистемы | Запуск программ на компьютере или сервере |
HTTPСоединение, FTPСоединение, ИнтернетПочта | Отправка данных наружу |
Новый COMОбъект | Управление другими программами |
Выполнить(, Вычислить( | Код, который приходит строкой и не виден при чтении |
.Удалить(), УстановитьПривилегированныйРежим | Удаление объектов и обход прав |
Сами по себе эти слова не значат, что файл вредный. Загрузка из Excel законно работает с файлами, а обмен — с интернетом. Вопрос в том, совпадает ли поведение с заявленным назначением. Печатная форма, которая отправляет что-то по HTTP, — повод остановиться.
Если модули пустые, а вся логика спрятана, значит код защищён паролем или поставлен без исходных текстов. Такой файл проверить нельзя.
Первый запуск — не в рабочей базе
Перед запуском обработки, которая меняет данные, сделайте резервную копию базы
. Ещё лучше — выгрузите копию через Администрирование → Выгрузить информационную базу в Конфигураторе, разверните её как отдельную базу и прогоните обработку там. Сравните результат и только потом запускайте в рабочей.