Как открыть EPF-файл в 1С

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

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

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

Что такое EPF-файл и когда он нужен

EPF (External Processing File) — скомпилированный контейнер внешней обработки. Внутри находятся программный код на встроенном языке 1С, формы диалогов, макеты печатных форм и табличных документов. Файл запускается платформой напрямую и не требует установки или регистрации в конфигурации.

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

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

Открытие через меню «Файл» в режиме предприятия

Базовый способ, который работает в любой конфигурации и на любом клиенте — толстом, тонком и веб-клиенте. Запустите информационную базу в режиме 1С:Предприятие, затем откройте главное меню и выберите пункт «Файл → Открыть» либо нажмите сочетание клавиш Ctrl+O.

В диалоге выбора файла укажите тип «Внешние обработки (*.epf)» или «Все файлы», найдите нужный файл на диске и подтвердите выбор. Если файл корректный, платформа загрузит его и отобразит главную форму обработки. Если у обработки нет формы, код выполнится сразу, без визуального интерфейса.

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

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

Работа с предупреждением безопасности

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

Если файл получен из доверенного источника — от вашего разработчика, с официального диска ИТС или из внутреннего хранилища компании — нажмите «Да» и продолжите работу. Если происхождение файла неизвестно, безопаснее отказаться от открытия и сначала проверить его содержимое.

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

Открытие EPF в конфигураторе для просмотра кода

Если нужно не запустить обработку, а изучить или изменить её код, откройте файл в конфигураторе. Запустите конфигуратор любой базы (даже пустой), выберите «Файл → Открыть» и укажите EPF-файл. Платформа покажет структуру обработки: формы, макеты, модуль объекта.

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

Учтите, что обработка может быть поставлена с паролем на модуль. В этом случае код недоступен для просмотра, и без пароля изменить её невозможно. Пароль запрашивается у автора обработки; обход защиты сторонними средствами нарушает условия лицензирования чужой разработки.

Подключение EPF через дополнительные отчеты и обработки

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

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

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

Программное открытие EPF

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

Обработка = ВнешниеОбработки.Создать("C:\Обработки\МояОбработка.epf", Ложь);
Обработка.ВыполнитьКоманду();

// Открытие формы обработки:
Форма = ВнешниеОбработки.ПолучитьФорму("C:\Обработки\МояОбработка.epf");
Форма.Открыть();

Второй параметр метода Создать определяет использование безопасного режима. Значение Ложь отключает безопасный режим и даёт обработке полный доступ к системе — передавайте его только для доверенных файлов. Для непроверенных обработок оставляйте безопасный режим включённым.

На сервере 1С путь к файлу должен быть доступен с сервера, а не с клиентской машины. Частая ошибка — указание локального пути C:\ в серверном вызове: сервер не видит диск пользователя, и вызов завершается ошибкой «Файл не обнаружен».

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

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

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

Ошибка «Нарушение прав доступа» означает, что у пользователя нет права «Интерактивное открытие внешних отчетов и обработок». Это право назначается администратором в ролях пользователя. В файловой базе с простым набором ролей достаточно роли с административными правами.

Проверка результата и контрольные точки

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

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

Часто задаваемые вопросы