Как запустить EPF-файл в 1С: пошаговая инструкция

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

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

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

Что такое EPF-файл и когда его запускают

EPF (External Data Processor) — скомпилированная внешняя обработка платформы «1С:Предприятие». Внутри файла находится программный код на встроенном языке 1С, формы и макеты. При открытии платформа загружает обработку в память сеанса и даёт ей доступ к данным текущей информационной базы.

Типичные сценарии использования EPF: групповое изменение реквизитов, загрузка данных из Excel, поиск и удаление дублей, универсальные отчёты, консоль запросов, обмен данными между базами. Часто такие обработки поставляются франчайзи 1С, скачиваются с портала 1С или пишутся штатным разработчиком.

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

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

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

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

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

Закрывается обработка как обычное окно. Сам EPF-файл при этом никуда не копируется в базу: при следующем запуске его нужно будет открыть заново с диска.

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

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

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

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

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

Запуск в обычном и управляемом приложении

Обработки пишутся под конкретный тип клиента. Если EPF создана под обычные формы, а ваша база работает в управляемом приложении (интерфейс «такси»), при открытии вы увидите ошибку или пустое окно. Обратная ситуация тоже возможна.

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

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

Запуск EPF из командной строки и программно

Для автоматизации (например, регламентных операций по расписанию) внешнюю обработку можно запустить при старте сеанса через параметр командной строки /Execute:

"C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" ENTERPRISE /F"D:\Bases\Trade" /N"Администратор" /Execute"D:\Utils\MyProcessing.epf"

Ключи: ENTERPRISE — режим запуска, /F — путь к файловой базе (для серверной используется /S с адресом сервера и именем базы), /N и /P — имя пользователя и пароль, /Execute — путь к EPF-файлу. После выполнения обработки сеанс можно завершить программно из кода обработки.

Программно открыть обработку из другого кода можно методом ВнешниеОбработки.Создать("путь_к_файлу.epf") — так делают, когда одна обработка вызывает другую как библиотеку функций без показа формы.

Безопасность: что проверить перед запуском

EPF-файл исполняется с правами текущего пользователя и может читать и изменять любые доступные этому пользователю данные. Обработка «под администратором» фактически получает полный контроль над базой, включая возможность удалить документы или справочники.

Поэтому действует простое правило: неизвестный файл сначала открывают на копии базы. Копию файловой базы можно сделать простым копированием папки с файлом 1Cv8.1CD, серверной — через выгрузку в dt или средствами СУБД.

Если в компании есть штатный или приходящий разработчик 1С, полезно показать ему код обработки: EPF можно декомпилировать и открыть в конфигураторе («Файл → Открыть» в конфигураторе), чтобы увидеть встроенный код и убедиться в отсутствии деструктивных операций.

Типичные ошибки при запуске и их решение

Чаще всего запуск EPF сопровождается несколькими повторяющимися проблемами. Ниже — признаки и способы их устранения.

Отдельный случай — сообщение «Ошибка формата потока» или невозможность открыть файл вообще. Обычно это означает, что файл повреждён при скачивании или сохранён не полностью. Решение — получить файл заново из первоисточника.

Если обработка открылась, но выдаёт ошибки вида «Метаданные не найдены» при обращении к документам или справочникам, значит она рассчитана на другую конфигурацию (например, обработка для «Управления торговлей» запущена в «Бухгалтерии»). В этом случае нужна адаптация кода под вашу конфигурацию.

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