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