Администрирование · 9 мин
Как загрузить EPF-файл в 1С: подробная инструкция
Как открыть и загрузить EPF-файл (внешнюю обработку) в 1С: через меню Файл, в управляемом приложении, в типовых конфигурациях. Решение ошибок и частые вопросы.
EPF-файл — это внешняя обработка платформы 1С:Предприятие. Такие файлы распространяют разработчики, вендоры и порталы вроде Инфостарта: внутри может быть печатная форма, загрузка данных из Excel, свёртка базы или любой другой инструмент. Чтобы обработка заработала, её нужно либо просто открыть в текущем сеансе, либо зарегистрировать в базе как дополнительный отчёт или обработку.
Способ загрузки зависит от задачи. Если файл нужен один раз — например, запустить обработку очистки данных — достаточно открыть его через меню «Файл». Если обработку должны видеть все пользователи в разделе «Дополнительные отчеты и обработки», её регистрируют в справочнике дополнительных обработок. Оба сценария разберём ниже по шагам.
Перед загрузкой важно понимать, что EPF — это исполняемый код. Обработка из непроверенного источника может изменить или удалить данные в базе, поэтому запускать её стоит только после проверки и желательно на копии информационной базы.
Что такое EPF-файл и когда он нужен
EPF (External Data Processor) — скомпилированная внешняя обработка, которую платформа 1С выполняет вне основной конфигурации. В отличие от встроенных объектов, внешняя обработка не требует изменения конфигурации и обновления базы: её можно открыть и запустить в любой момент.
Типичные сценарии использования EPF-файлов: загрузка прайсов и номенклатуры из Excel, групповое изменение реквизитов, универсальные отчёты, внешние печатные формы, обмен данными между базами, сервисные обработки для администраторов (свертка, поиск и удаление дублей, тестирование и исправление).
Рядом с EPF иногда встречается расширение ERF — это внешний отчёт. Механика открытия у них одинаковая, поэтому всё описанное ниже применимо и к ERF-файлам. Отличие только в назначении: отчёт формирует табличный документ, а обработка обычно выполняет действия с данными.
Подготовка: права и резервная копия
Для открытия внешней обработки пользователю нужно право «Интерактивное открытие внешних обработок» (и аналогичное для отчётов). В типовых конфигурациях оно обычно есть у полных прав и у администратора. Если меню открытия недоступно или появляется сообщение о нарушении прав — обратитесь к администратору базы.
Перед запуском обработки, которая что-то меняет в данных (загрузка, групповая обработка, свёртка), создайте резервную копию. Для файловой базы достаточно скопировать файл 1Cv8.1CD в отдельную папку при отсутствии активных сеансов. Для серверной базы используйте выгрузку через конфигуратор (Администрирование → Выгрузить информационную базу) или штатные средства СУБД.
Способ 1. Открыть EPF через меню «Файл»
Это самый быстрый способ для разового запуска. Запустите 1С в режиме «Предприятие», выберите в главном меню пункт «Файл» → «Открыть» и укажите путь к EPF-файлу. В обычном приложении команда находится там же — в меню «Файл» главного окна.
После выбора файла обработка откроется в отдельном окне, и с ней можно работать как со штатным инструментом. Закрытие окна завершает выполнение обработки: при следующем запуске файл нужно открывать заново, поэтому удобно хранить часто используемые EPF в отдельной папке с понятными именами.
В управляемом приложении платформа может показать предупреждение безопасности «Открывается файл из внешнего источника». Это штатная защита: подтверждайте открытие только если доверяете источнику файла.
- 1Откройте 1С в режиме «Предприятие» под пользователем с нужными правами
- 2Выберите Файл → Открыть и укажите EPF-файл
- 3Подтвердите открытие при появлении предупреждения безопасности
- 4Выполните нужные действия в форме обработки
- 5Проверьте результат по данным базы до закрытия сеанса
Способ 2. Зарегистрировать обработку в типовой конфигурации
Если обработкой пользуются регулярно, её добавляют в справочник дополнительных отчётов и обработок. Сначала включите сам механизм: «Администрирование» → «Печатные формы, отчеты и обработки» → установите флаг «Дополнительные отчеты и обработки». Без этого флага соответствующий раздел в интерфейсе не появится.
Затем перейдите по появившейся ссылке «Дополнительные отчеты и обработки», нажмите «Создать» (или «Добавить из файла») и выберите EPF-файл. Платформа прочитает сведения из обработки: название, версию, безопасный режим, назначение. Если обработка написана по стандарту БСП, она сама сообщит, в каких разделах её показывать.
После записи обработка станет доступна пользователям в интерфейсе — например, в разделе «Дополнительные обработки» соответствующего подраздела. Доступ можно ограничить: в карточке обработки настраивается, кому она видна.
Если обработка не регистрируется
Частая ситуация: при добавлении появляется ошибка «обработка не содержит сведений о регистрации» или подобная. Это значит, что файл написан без поддержки БСП и не умеет сам сообщать параметры регистрации. Такой файл можно открыть через «Файл → Открыть», но в справочник дополнительных обработок без доработки он не добавится.
Загрузка EPF в конфигураторе
Разработчику иногда нужно не запустить обработку, а посмотреть или изменить её код. Для этого EPF открывают в конфигураторе: «Файл» → «Открыть» → выбрать файл. Модуль объекта, формы и макеты станут доступны для редактирования.
Чтобы сохранить изменения, используйте «Файл» → «Сохранить». Если нужно перенести обработку в состав конфигурации, в дереве конфигурации выберите ветку «Обработки» → «Вставить внешнюю обработку» (в новых версиях — через контекстное меню «Добавить» → «Внешняя обработка»).
Частые ошибки и их решение
Сообщение «Нарушение прав доступа» означает, что у пользователя нет права интерактивного открытия внешних обработок — его добавляет администратор в ролях или профилях групп доступа. Ошибка формата файла обычно говорит о несовместимости версий платформы или о том, что файл повреждён при скачивании — скачайте его заново.
Если обработка открылась, но при выполнении выдаёт ошибку вида «Метод объекта не обнаружен» или «Поле объекта не обнаружено», причина почти всегда в несовместимости с вашей конфигурацией: обработка писалась под другую версию или другую конфигурацию. Здесь поможет только поиск подходящей версии обработки или её доработка.
Проверка результата после загрузки
После открытия обработки убедитесь, что она работает корректно: форма открывается без ошибок, команды выполняются, результат соответствует ожиданиям. Если обработка изменяла данные, проверьте несколько затронутых объектов вручную — например, откройте документы или элементы справочника, которые должны были измениться.
Для зарегистрированной обработки проверьте, что она видна пользователям в нужном разделе и что настройки доступа работают: зайдите под обычным пользователем и убедитесь, что обработка открывается и выполняется без ошибок прав.
Как проверить результат
Форма обработки открылась без сообщений об ошибках
Ошибка формата, нарушение прав или пустое окно
Команды отрабатывают, данные изменяются как ожидалось
Ошибки вида «метод не обнаружен», данные не меняются
Обработка видна в разделе дополнительных обработок у нужных пользователей
Обработка не отображается или недоступна по правам
FAQ
Чем EPF отличается от расширения конфигурации (CFE)?
EPF — отдельный исполняемый файл, который открывается вручную или регистрируется как дополнительная обработка. CFE-расширение подключается к конфигурации через «Администрирование» → «Печатные формы, отчеты и обработки» → «Расширения» и меняет поведение самой конфигурации. Для разовых задач удобнее EPF, для постоянной доработки типовых механизмов — расширение.
Можно ли открыть EPF в веб-клиенте?
Да, но с ограничениями: в веб-клиенте открытие внешних файлов зависит от настроек браузера и модальных окон, а часть обработок с файловыми операциями на клиенте может не работать. Надёжнее использовать тонкий клиент.
Почему при открытии появляется окно «Предупреждение безопасности»?
Это штатный механизм платформы: она предупреждает, что запускается код из внешнего файла. Если файл получен из надёжного источника, подтвердите открытие. Если источник вызывает сомнения — откажитесь и проверьте файл на копии базы.
Как открыть EPF, если нет прав администратора?
Для интерактивного открытия нужно право «Интерактивное открытие внешних обработок», оно не требует полных прав. Попросите администратора добавить это право в ваш профиль либо зарегистрировать обработку в справочнике дополнительных обработок с доступом для вашей роли.
Обработка просит отключить безопасный режим — это опасно?
Безопасный режим ограничивает доступ обработки к файловой системе и COM-объектам. Отключать его стоит только для проверенных обработок: без защиты код получает полный доступ к компьютеру пользователя. Для файлов из непроверенных источников безопасный режим лучше оставить включённым.
Можно ли запустить EPF по расписанию?
Да, если обработка зарегистрирована в справочнике дополнительных отчётов и обработок и поддерживает выполнение по расписанию (это зависит от её кода). Альтернатива — запуск через командную строку пакетного режима с параметром /Execute, но это требует аккуратной настройки и тестирования.
Что важно запомнить
Разовый запуск — через Файл → Открыть, постоянное использование — через регистрацию в дополнительных отчетах и обработках. Проверяйте источник файла, делайте резервную копию перед обработками, меняющими данные, и убедитесь, что у пользователя есть право интерактивного открытия внешних обработок.