Как установить обработку EPF в 1С 8.3

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

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

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

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

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

Типовые сценарии использования EPF: загрузка данных из Excel и CSV, групповое изменение реквизитов, свертка базы, поиск и удаление дублей, универсальные отчеты, выгрузка в банк-клиент. Многие такие инструменты поставляются на диске ИТС или публикуются разработчиками прикладных решений.

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

Самый быстрый вариант — открыть файл напрямую. В клиенте 1С выберите в главном меню «Файл» → «Открыть» (сочетание клавиш Ctrl+O), укажите путь к EPF-файлу и подтвердите открытие. Обработка запустится в отдельном окне и будет работать до его закрытия.

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

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

1. 1
   Сохраните EPF-файл в доступную папку на диске или сетевом ресурсе
2. 2
   В 1С откройте меню Файл → Открыть или нажмите Ctrl+O
3. 3
   Выберите файл и подтвердите предупреждение безопасности
4. 4
   Проверьте, что окно обработки открылось и форма отображается корректно
5. 5
   Выполните нужную операцию и закройте обработку

Способ 2. Подключение через дополнительные отчеты и обработки

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

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

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

1. 1
   Администрирование → Печатные формы, отчеты и обработки → включите флажок «Дополнительные отчеты и обработки»
2. 2
   Откройте список «Дополнительные отчеты и обработки» и нажмите «Создать»
3. 3
   Загрузите EPF-файл кнопкой выбора файла
4. 4
   Укажите название, разделы размещения и вариант запуска
5. 5
   Запишите карточку и выполните тестовый запуск
6. 6
   Настройте права доступа для нужных ролей пользователей

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

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

Требования к правам и настройкам безопасности

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

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

Сравнение способов подключения

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

Сравнение способов

Файл → Открыть

Подходит для разовых задач и тестирования. Не требует прав администратора, но обработка доступна только в текущем сеансе и только тому, кто её открыл.

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

Подходит для постоянной работы: обработка видна всем пользователям с нужными правами, поддерживает расписание и вызов из форм объектов. Требует конфигурации на БСП и прав на регистрацию.

Подключение через конфигуратор

EPF можно открыть в конфигураторе (Файл → Открыть) для просмотра и изменения кода. Это не установка в базу, а инструмент разработчика для доработки и проверки обработки.

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

После установки убедитесь, что обработка работает так, как задумано. Для разового открытия признак успеха — открывшаяся форма без сообщений об ошибках. Для зарегистрированной обработки проверьте, что команда видна в нужном разделе у пользователя с ограниченными правами, а не только у администратора.

Частая ошибка — «Метод объекта не обнаружен» или «Ошибка компиляции» при открытии. Обычно это означает, что обработка написана под другую конфигурацию или использует объекты, которых нет в вашей базе (например, обработка для «Управления торговлей» открывается в «Бухгалтерии»). Вторая типичная ситуация — обработка разработана под управляемые формы, а открывается в обычном приложении, или наоборот.

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

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

Открытие через Файл → Открыть

Норма

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

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

Сообщение об ошибке метода или пустое окно — обработка несовместима с конфигурацией

Видимость команды в интерфейсе

Норма

Команда появилась в выбранных разделах у пользователя с обычными правами

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

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

Выполнение основной функции

Норма

Обработка выполняет операцию на тестовых данных без ошибок

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

Ошибка при обращении к файлам или COM — работает безопасный режим профиля кластера

Часто задаваемые вопросы

Можно ли установить EPF-обработку в базовую версию 1С?

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

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

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

Почему обработка не открывается и выдаёт «Ошибка формата потока»?

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

Как запустить обработку по расписанию?

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

Безопасно ли отключать предупреждение «защита от опасных действий»?

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

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

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