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