К статье
Практический материал

Разработка и Конфигурация · 9 мин

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

Как открыть внешнюю обработку EPF в 1С 8.3 через меню Файл, справочник дополнительных отчетов и обработок, а также решить ошибки доступа и безопасного режима.

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

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

Что такое EPF и когда его открывают

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

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

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

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

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

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

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

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

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

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

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

Способ 3: открытие в конфигураторе

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

Из конфигуратора обработку можно сразу отладить: поставить точки останова и запустить режим предприятия с отладкой. Это основной рабочий сценарий для разработчика. Также в конфигураторе можно сохранить обработку под другим именем или сравнить с другой версией файла.

Сравнение способов открытия

Меню Файл → Открыть

Подходит для разового запуска и тестирования; не сохраняет обработку в базе

Дополнительные отчеты и обработки

Для регулярной работы пользователей; требует функции СведенияОВнешнейОбработке в файле

Конфигуратор

Для просмотра и изменения кода, отладки; требует права на запуск конфигуратора

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

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

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

Типичные ошибки
01
Открытие файла в неподходящей конфигурации: обработка, написанная под конкретные объекты, выдаёт ошибки обращения к несуществующим реквизитам
02
Попытка открыть EPF, сохранённый в более новой версии платформы: файл не читается, обновите платформу или попросите пересохранить обработку
03
Запуск обработки сразу в рабочей базе без тестирования: некорректный код может массово изменить данные
04
Поиск обработки в списке дополнительных после подключения: обработка появляется только в разделах, указанных в её настройках размещения

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

Как проверить, что обработка открылась и работает правильно

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

Контрольные точки

Как проверить результат

Форма обработки
Норма

Форма открылась, элементы управления доступны, нет сообщений об ошибках

Тревожный признак

Окно ошибки компиляции или обращения к метаданным — обработка несовместима с базой

Версия платформы
Норма

Файл открывается на текущей версии платформы без предложения конвертации

Тревожный признак

Сообщение о невозможности прочитать файл — нужна другая версия платформы

Тестовое выполнение
Норма

Пробная операция на копии базы выполняется и даёт ожидаемый результат

Тревожный признак

Данные изменяются не так, как ожидалось — прекратите работу и восстановите копию

Рабочее правило: любую новую обработку сначала запускают на копии базы. Это особенно важно для обработок группового изменения данных, где одна ошибка в отборе затрагивает тысячи объектов.

Итог

Что важно запомнить

Разовый запуск EPF — через Файл → Открыть, постоянное использование — через «Дополнительные отчеты и обработки», редактирование — в конфигураторе. Перед запуском проверяйте источник файла, права пользователя и тестируйте обработку на копии базы.

Частые вопросы по открытию EPF в 1С 8.3

Чем открыть EPF-файл, если 1С не установлена?

Никак осмысленно: EPF — бинарный формат платформы 1С, сторонние программы его не исполняют. Без установленной платформы 1С:Предприятие 8.3 файл можно разве что распаковать специализированными инструментами разработчика для просмотра кода, но запустить обработку невозможно.

Почему при открытии EPF появляется окно «Предупреждение безопасности»?

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

Можно ли открыть EPF через веб-клиент?

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

Что делать, если пункт «Дополнительные отчеты и обработки» не виден?

Проверьте, что в разделе «Администрирование» → «Печатные формы, отчеты и обработки» включён соответствующий флажок. Если раздела нет вообще, у пользователя недостаточно прав или конфигурация не содержит этой подсистемы — тогда используйте открытие через меню «Файл».

Откроется ли внешний отчет ERF через те же действия?

Да, диалог открытия файла в 1С принимает и EPF (обработки), и ERF (внешние отчеты). В списке типов файлов выберите соответствующий формат или «Все файлы», дальнейшие действия идентичны.

Как открыть EPF, если у пользователя нет прав администратора?

Открытие через «Файл → Открыть» обычно доступно и обычным пользователям, если не включена защита от опасных действий. Если запуск заблокирован, обратитесь к администратору базы: он либо снимет ограничение, либо подключит обработку централизованно через дополнительные обработки с назначением прав.