Подключение внешних обработок .epf в 1С 8.3

Файл с расширением .epf — это внешняя обработка 1С. Чтобы запустить её разово, откройте базу в режиме 1С:Предприятие и выберите Файл → Открыть. Чтобы обработка была постоянно доступна пользователям — загрузите её в разделе Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки. Третий путь, для разработчиков, — встроить объект в конфигурацию через Конфигуратор.

Какой способ выбрать, зависит от задачи: один раз прогнать служебную обработку, дать её всему отделу или навсегда зашить в типовую базу. Ниже — все три варианта с точными путями меню, настройка прав и разбор ошибок, из-за которых .epf не запускается.

Внешняя обработка (.epf) и внешний отчёт (.erf) подключаются одинаково — разница только в типе объекта внутри файла. Всё, что написано про .epf, применимо и к .erf.

Чем внешняя обработка отличается от встроенной

Внешняя обработка хранится в отдельном файле .epf и не входит в конфигурацию. Её можно передать коллеге, запустить в любой совместимой базе, обновить, не трогая саму конфигурацию. Встроенная обработка лежит в дереве конфигурации и обновляется только вместе с ней.

Файл .epf содержит произвольный код на встроенном языке. Поэтому платформа относится к нему как к потенциально опасному: при открытии показывает предупреждение, а в клиент-серверной базе запуск может быть вовсе запрещён профилем безопасности. Это нормальное поведение, а не ошибка — к нему вернёмся в разделе про безопасность.

Три способа подключения решают разные задачи. Коротко, что выбрать:

Дальше — каждый способ по шагам.

Разовый запуск через меню «Файл»

Самый быстрый способ — когда обработку нужно выполнить один-два раза.

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

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

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

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

Чтобы пункт Файл → Открыть вообще отработал, у пользователя должно быть право на интерактивное открытие внешних обработок. В типовых базах это право есть у администратора и у ролей с полными правами; у рядового пользователя пункт может не сработать. Если запуск заблокирован на уровне кластера — ни клиент, ни права роли не помогут, нужно менять профиль безопасности (см. ниже).

Постоянный доступ через «Дополнительные обработки»

Если обработкой будут пользоваться регулярно и не вы один, загрузите её в подсистему «Дополнительные отчёты и обработки». Она есть во всех типовых конфигурациях на базе БСП — Бухгалтерия 3.0, ЗУП 3.1, УТ 11, ERP, УНФ, Розница. Файл при этом сохраняется внутри информационной базы, отдельная сетевая папка не нужна.

Шаг 1. Включите механизм. Откройте Администрирование → Печатные формы, отчёты и обработки и установите флажок Дополнительные отчёты и обработки.

Шаг 2. Загрузите файл. В том же разделе появится ссылка Дополнительные отчёты и обработки. Откройте список → Создать → подтвердите загрузку из файла → выберите .epf.

Шаг 3. Настройте карточку. После загрузки задайте параметры:

• Наименование — как обработка будет называться для пользователей.
• Размещение — разделы (Продажи, Зарплата, Банк и касса и т. д.), в которых обработка станет доступна. Без размещения её никто не найдёт.
• Быстрый доступ — список пользователей, у которых обработка появится прямо на панели раздела, а не только в общем списке.
• Безопасный режим — флажок, ограничивающий права обработки. По умолчанию включён, снимать без необходимости не стоит.

Шаг 4. Запишите карточку. После этого пользователи с доступом к нужному разделу откроют обработку через команду Дополнительные обработки в панели этого раздела.

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

Встраивание в конфигурацию через Конфигуратор

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

1. Откройте базу в Конфигураторе.
2. Файл → Открыть → выберите .epf. Обработка откроется для редактирования как самостоятельный объект.
3. Чтобы перенести её в конфигурацию, скопируйте объект обработки в ветку Обработки дерева конфигурации (перетаскиванием или через буфер обмена).
4. Сохраните изменения и выполните Обновить конфигурацию базы данных (F7).

Если конфигурация типовая и стоит на поддержке, прямое добавление объектов снимает её с полной поддержки и усложнит будущие обновления. Чаще правильнее использовать расширение конфигурации (доступно с платформы 8.3.6): обработка добавляется в расширение, основная конфигурация остаётся нетронутой.

Расширение подключают в режиме предприятия: Администрирование → Печатные формы, отчёты и обработки → Расширения (или раздел Администрирование → Обслуживание в зависимости от конфигурации) → загрузить файл .cfe. Загрузка расширения и обновление конфигурации базы данных — два отдельных действия; платформа предложит подтвердить второе.

Коротко, чем встраивание отличается от расширения:

• Копирование объекта в конфигурацию — обработка становится неотъемлемой частью базы, но типовая конфигурация снимается с полной поддержки, и каждое обновление от вендора придётся объединять вручную.
• Расширение .cfe — обработка живёт в отдельном «слое» поверх конфигурации. Типовую можно обновлять как обычно, а расширение при несовместимости просто отключается. Для большинства задач это предпочтительный вариант.

Права доступа и профили безопасности

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

В клиент-серверной базе добавляется ещё один уровень — профили безопасности кластера. Если для информационной базы назначен профиль безопасности, в котором открытие внешних обработок запрещено, то Файл → Открыть не сработает ни у кого, включая администратора базы. Разрешение настраивается администратором кластера в свойствах профиля безопасности (через консоль администрирования серверов или утилиту rac). Если не уверены, какие команды rac нужны, посмотрите справку командой rac help.

Отдельно действует безопасный режим выполнения. В нём обработке запрещены потенциально опасные операции: доступ к файловой системе сервера, запуск внешних приложений, работа с COM. Снимать безопасный режим стоит только для обработок из доверенного источника, код которых вы проверили.

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

Почему EPF не открывается: разбор ошибок

Отдельно про несовместимость: обработка, написанная под обычные формы (версия 8.1–8.2), может не открыться или открыться с ошибками в современном интерфейсе «Такси». В этом случае её переделывают под управляемые формы — быстрого способа «подружить» старый файл с новой платформой нет.

Безопасность и контроль внешних обработок

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

Что снижает риск:

• 🔒 Не снимайте безопасный режим без причины — он блокирует доступ к файловой системе и запуску приложений.
• 👤 Ограничивайте круг пользователей через Быстрый доступ и роли: обработка нужна не всем.
• 🧾 Журнал регистрации фиксирует запуск дополнительных обработок — через него видно, кто и когда выполнял обработку.
• 📋 В списке «Дополнительные отчёты и обработки» видно, кто загрузил файл и когда. Не держите в базе обработки неизвестного происхождения.
• 🖥 В клиент-серверной базе используйте профили безопасности кластера — это единая точка запрета для всей базы.

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

Частые вопросы