Как добавить EPF-обработку в 1С

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

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

Ниже разобраны оба сценария для управляемого приложения (конфигурации на БСП: «1С:Бухгалтерия 3.0», «Управление торговлей 11», «ERP», «ЗУП 3.1»), а также вопросы безопасности, прав и типичные ошибки при подключении.

Что такое EPF и когда его подключают

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

Типичные сценарии использования EPF:

• нестандартные печатные формы и этикетки;
• загрузка прайсов, выписок, номенклатуры из Excel или CSV;
• групповое изменение реквизитов, перепроведение документов;
• внешние отчёты, которых нет в типовой конфигурации;
• сервисные инструменты администратора: поиск дублей, анализ прав, очистка данных.

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

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

Перед добавлением убедитесь, что файл действительно предназначен для вашей версии платформы и конфигурации. Обработка, написанная под «Управление торговлей 10.3» (обычные формы), не откроется корректно в управляемом приложении, а обращения к несуществующим объектам вызовут ошибки. Обычно разработчик указывает совместимость в описании файла.

Практический минимум перед подключением в рабочую базу:

1. Сделайте резервную копию: «Администрирование → Обслуживание → Резервное копирование» либо выгрузка в dt через конфигуратор.
2. Проверьте файл антивирусом и уточните источник: официальный портал 1С, диск ИТС, известный разработчик.
3. При возможности откройте EPF в конфигураторе и просмотрите код на предмет опасных операций — удаления объектов, отправки данных по сети, запуска внешних программ.
4. Протестируйте обработку в копии базы.

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

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

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

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

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

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

Это штатный механизм библиотеки стандартных подсистем (БСП), встроенный в большинство типовых конфигураций. Обработка сохраняется внутри информационной базы, появляется в интерфейсе пользователей в выбранных разделах, а доступ к ней регулируется правами.

Включение функциональной опции

Сначала проверьте, что механизм активен. Перейдите в «Администрирование → Печатные формы, отчеты и обработки» и установите флаг «Дополнительные отчеты и обработки». Без этого флага одноимённый справочник в интерфейсе не отображается. В некоторых конфигурациях путь отличается: например, «НСИ и администрирование → Администрирование → Печатные формы, отчеты и обработки».

Добавление файла в справочник

Откройте «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки» и нажмите «Создать» или «Добавить из файла». Укажите EPF-файл — программа попытается прочитать из него сведения о регистрации: наименование, версию, вид (дополнительная обработка, дополнительный отчёт, заполнение объекта, печатная форма, создание связанных объектов).

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

После записи элемента обработка появляется в выбранных разделах: дополнительные отчёты и обработки доступны из команд «Дополнительные обработки» / «Дополнительные отчеты» в шапке раздела, печатные формы — из кнопки «Печать» соответствующих документов, обработки заполнения — из кнопки «Заполнить».

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

Настройка прав и безопасного режима

Доступ к дополнительным обработкам регулируется на двух уровнях. Первый — роль «Использование дополнительных отчетов и обработок» (и смежные роли добавления/изменения), без неё пользователь вообще не увидит механизм. Второй — права на конкретный элемент справочника: в карточке обработки можно указать, кому она доступна.

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

Проверка результата и типичные проблемы

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

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

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

Видимость команды в разделе

Норма

Обработка есть в списке «Дополнительные обработки» нужного раздела

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

Команды нет — проверьте размещение и права пользователя

Запуск обработки

Норма

Форма открывается, операции выполняются без ошибок

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

Ошибка компиляции или «Метод не обнаружен» — файл несовместим с конфигурацией

Печатная форма

Норма

Форма доступна из кнопки «Печать» целевого документа

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

В списке печати её нет — неверно указан вид или не назначены типы объектов

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

Если обработка работала, а после обновления конфигурации перестала — вероятно, разработчики переименовали объекты метаданных, к которым она обращалась. В этом случае нужна актуальная версия EPF от разработчика либо доработка кода в конфигураторе.

Альтернативы EPF: расширения конфигурации

Если доработка должна тесно интегрироваться с конфигурацией — добавлять реквизиты, изменять формы документов, работать в фоновых заданиях по расписанию, — рассмотрите расширение конфигурации (файл CFE) вместо внешней обработки. Расширения подключаются через «Администрирование → Печатные формы, отчеты и обработки → Расширения» (в ряде конфигураций — отдельный пункт «Расширения») и тоже не снимают конфигурацию с поддержки.

Сравнение вариантов

Разовое открытие EPF

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

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

Постоянное использование, права, размещение в разделах, автозапуск по расписанию для фоновых команд. Ограничение: нельзя менять формы и метаданные конфигурации.

Расширение конфигурации (CFE)

Изменение форм, ролей, подписок на события, регламентных заданий. Ограничение: требует аккуратного контроля совместимости при обновлениях.

Изменение конфигурации

Максимальная гибкость. Ограничение: частичный или полный снятие с поддержки, сложные обновления — применять в последнюю очередь.

FAQ

Можно ли добавить EPF в 1С:Бухгалтерию 8.3 без прав администратора?

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

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

Платформа предупреждает, что файл содержит исполняемый код и его источник не проверен. Это нормальное поведение для любого EPF. Подтверждайте открытие только для файлов из доверенных источников; полностью отключить предупреждение можно в настройках пользователя, но делать это не рекомендуется.

Обработка добавлена, но пользователи её не видят. Что проверить?

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

Можно ли запускать дополнительную обработку по расписанию?

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

Чем открыть и отредактировать EPF-файл?

Только конфигуратором 1С: «Файл → Открыть» в режиме конфигуратора покажет структуру обработки — формы, модули, макеты. Текстовыми редакторами EPF не редактируется, это бинарный контейнер.

Опасно ли добавлять EPF в клиент-серверную базу?

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