Как открыть EPF-файл в 1С: все способы и решение проблем

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

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

Что такое EPF и чем он отличается от других файлов 1С

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

Важно не путать EPF с похожими форматами: ERF — внешний отчёт, открывается аналогично, но предназначен для вывода данных; CF и CFU — файлы конфигурации и обновления, их нельзя открыть через «Файл → Открыть» в режиме предприятия; DT — выгрузка информационной базы. Если файл с расширением EPF не открывается, стоит сначала убедиться, что это действительно обработка, а не переименованный файл другого типа.

Стандартный способ: открытие через меню «Файл»

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

1. 1
   Запустите 1С в режиме предприятия под пользователем с нужными правами
2. 2
   Откройте меню «Файл» и выберите пункт «Открыть» (или нажмите Ctrl+O)
3. 3
   Укажите путь к EPF-файлу и подтвердите выбор
4. 4
   При появлении предупреждения безопасности нажмите «Да» / «Открыть»
5. 5
   Дождитесь появления формы обработки и проверьте её работоспособность

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

Открытие EPF в конфигураторе

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

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

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

Программное открытие обработки из кода

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

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

Второй параметр метода Создать() отвечает за безопасный режим: значение Ложь отключает безопасный режим, Истина — включает. В управляемых формах создание объекта возможно только на сервере, поэтому код размещают в серверной процедуре, а форму открывают уже на клиенте.

В типовых конфигурациях на БСП (Библиотека стандартных подсистем) вместо прямого открытия файлов рекомендуется использовать подсистему «Дополнительные отчеты и обработки»: обработка регистрируется в справочнике и запускается штатными средствами, что корректнее с точки зрения прав и обновлений.

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

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

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

Ошибка несовместимости версий платформы

Характерное сообщение: «Нарушение целостности структуры файла» или «Файл не является внешней обработкой либо создан в несовместимой версии». Причины две: файл повреждён (недокачан, передан архивом с ошибкой) или создан в существенно другой версии платформы.

При конвертации старой обработки в конфигураторе сохраните копию исходного файла: после пересохранения в новом формате обратного открытия на старой платформе уже не будет.

Открытие EPF в веб-клиенте и на сервере

В веб-клиенте открытие внешних обработок поддерживается, но с ограничениями: браузер должен разрешить работу с файловой системой (в Chrome и Edge это расширение для работы с файлами 1С, в Firefox — настройки доступа). Если кнопка обзора не реагирует, проверьте, установлено ли расширение платформы для браузера.

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

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

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

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

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