Как добавить файл EPF в 1С и подключить внешнюю обработку

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

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

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

Что такое файл EPF и когда он нужен

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

Типичные сценарии использования EPF: загрузка прайсов и выписок из Excel, универсальные отчёты, групповое изменение реквизитов, подключаемые печатные формы, обмен данными между базами, сервисные утилиты вроде поиска и удаления дублей. Многие конфигурации на управляемых формах (УТ 11, ERP, Бухгалтерия 3.0, ЗУП 3.1) поддерживают стандарт подключения таких файлов через библиотеку стандартных подсистем.

Подготовка: проверка файла и резервная копия

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

Если обработка будет изменять данные (а не только формировать отчёт), сделайте резервную копию информационной базы. Для файловой базы достаточно скопировать каталог с файлом 1Cv8.1CD в отдельную папку. Для клиент-серверной базы используйте выгрузку через конфигуратор (Администрирование → Выгрузить информационную базу) или штатные средства СУБД.

Проверьте файл антивирусом и, если есть возможность, откройте его в конфигураторе (Файл → Открыть), чтобы просмотреть код модуля. Подозрительные конструкции — обращения к внешним адресам, чтение файлов с диска, работа с OLE/COM-объектами без явной необходимости — повод отказаться от использования.

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

Самый быстрый вариант подходит для одноразового запуска. В режиме 1С:Предприятие откройте главное меню (кнопка с треугольником в левом верхнем углу или меню «Файл» в тонком клиенте) и выберите пункт «Открыть». Укажите путь к файлу с расширением .epf и подтвердите открытие. Форма обработки появится на экране, и с ней можно работать.

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

У разового открытия есть ограничение: после закрытия окна обработку придётся открывать заново, а другие пользователи базы её не увидят. Для регулярной работы используйте регистрацию в базе.

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

Способ 2: регистрация в «Дополнительных отчетах и обработках»

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

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

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

Настройка прав доступа и публикация для пользователей

Работа с дополнительными обработками требует права «Добавление дополнительных отчетов и обработок» — обычно оно есть у администратора. Обычным пользователям для запуска уже подключённых обработок достаточно права «Использование дополнительных отчетов и обработок», которое включается в профиле группы доступа.

В карточке обработки можно ограничить доступ по пользователям или по разделам. Если обработка содержит команды типа «ВызовСерверногоМетода» или «ИзменениеДанных», убедитесь, что она запускается только теми сотрудниками, которые понимают последствия. Для обработок с расписанием (фоновое выполнение) настройте расписание на закладке соответствующей команды и убедитесь, что в базе работает регламентное задание обработки очереди.

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

Типичные ошибки при добавлении EPF и их решение

Ошибка «Ошибка формата потока» при открытии означает повреждённый или несовместимый файл. Скачайте файл заново, убедитесь, что он не распакован из архива частично, и что версия платформы не старше той, в которой файл сохранён.

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

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

Проверка результата и безопасная эксплуатация

После подключения откройте раздел, в котором размещена обработка, и убедитесь, что команда видна и запускается. Для обработок, изменяющих данные, первый запуск выполните на тестовом пакете: одном документе или одном элементе справочника, а результат сверьте вручную.

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

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

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

Команда обработки в интерфейсе

Норма

Команда видна в указанном разделе и открывает форму

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

Команды нет — проверьте включение элемента, размещение и права

Результат работы обработки

Норма

Данные изменены или отчёт сформирован как ожидалось на тестовом примере

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

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

Поведение после обновления конфигурации

Норма

Обработка остаётся включённой и работает

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

Обработка отключена или выдаёт ошибки — нужна адаптация под новый релиз

FAQ: частые вопросы о файлах EPF

Чем EPF отличается от расширения конфигурации (CFE)?

EPF — самостоятельная обработка, которая запускается пользователем и не меняет конфигурацию. Расширение CFE подключается через конфигуратор или раздел «Расширения конфигурации» и модифицирует поведение типовых объектов: форм, модулей, ролей. Для разовых утилит используют EPF, для постоянной доработки поведения — расширения.

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

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

Почему конфигурация не принимает мой EPF при регистрации?

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

Опасно ли открывать EPF, скачанный из интернета?

Да, потенциально опасно. Код обработки выполняется с правами пользователя и имеет полный доступ к данным базы. Запускайте такие файлы только на копии базы, предварительно просмотрев код в конфигураторе и проверив файл антивирусом.

Как обновить уже подключённую обработку на новую версию?

Откройте карточку обработки в списке «Дополнительные отчеты и обработки», нажмите «Загрузить из файла» и выберите новый EPF. Старая версия сохранится в истории, и при проблемах её можно вернуть.

Нужны ли права администратора, чтобы добавить EPF?

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