Загрузка внешней обработки EPF в 1С 8.3: три способа и права

Загрузить EPF -файл в 1С можно за полминуты: в режиме «1С:Предприятие» нажмите Ctrl+O, выберите файл и откройте его. Но так обработка живёт только пока открыто окно, и у обычного пользователя такой возможности часто нет. Чтобы обработка осталась в базе, её подключают через справочник дополнительных отчётов и обработок.

Частое заблуждение: «закинул файл в папку с базой, и он появится». Не появится. Файл EPF сам по себе ничего не делает, 1С должна его открыть или зарегистрировать в базе. Ниже три рабочих способа, права доступа и разбор ошибок.

Что такое EPF и чем он отличается от ERF

EPF — файл внешней обработки. Это отдельный модуль с формами и кодом, который работает поверх вашей конфигурации, но не входит в неё. Рядом встречается ERF — внешний отчёт. Загружаются они одинаково, различие только в назначении.

Что обычно лежит в EPF:

• 🖨 внешние печатные формы (акт, счёт, накладная по своему шаблону);
• 📥 загрузка данных из Excel , банковских выписок, прайсов;
• 🧹 сервисные операции: групповое изменение реквизитов, удаление дублей, очистка;
• 📊 нестандартные отчёты и выгрузки.

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

Что проверить до загрузки файла

Пять минут подготовки сэкономят вечер разбирательств.

1. Источник. Файл получен от разработчика, коллеги или с доверенного ресурса? Если нет, не открывайте его в рабочей базе.
2. Версия платформы и конфигурации. Обработку, написанную под Бухгалтерию 3.0, иногда нельзя запустить в ЗУП: она ссылается на объекты, которых там нет. Спросите у автора, под что она сделана.
3. Режим работы. Базу ведёте на своём ПК, в локальной сети или в облаке? В облачных сервисах загрузка внешних файлов часто закрыта настройками провайдера.
4. Копия базы. Если обработка пишет данные, сделайте выгрузку информационной базы (Администрирование в Конфигураторе → Выгрузить информационную базу) или резервную копию средствами СУБД.
5. Права. Узнайте, под какой ролью вы зашли. Ниже есть отдельный раздел.

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

Самый быстрый путь, подходит для проверки обработки и разовой работы.

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

Закроете окно, и обработка пропадёт. При следующей работе файл придётся открывать заново. Сам файл должен лежать там, куда у пользователя есть доступ: на локальном диске или в сетевой папке.

💡 Если пункта Открыть в меню нет или он серый, это не поломка. Роль пользователя не разрешает открывать внешние файлы. Как это исправить, читайте в разделе про права.

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

Это штатный способ для постоянной работы. Обработка записывается в базу, и любой пользователь с правом запускает её без файла на диске.

Включите раздел в настройках

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

Если раздела нет, конфигурация не использует БСП в нужной части. Тогда остаётся способ 1 или доработка в Конфигураторе.

Добавьте файл

1. Откройте справочник дополнительных отчётов и обработок.
2. Нажмите «Создать». В некоторых версиях сразу предложат выбрать файл, в других нужно нажать «Загрузить из файла».
3. Укажите EPF. 1С прочитает название, версию и вид обработки из самого файла.
4. Проверьте поле «Вид». От него зависит, где обработка появится:

5. Для печатных форм и заполнения укажите, в каких документах показывать команду. Без этого вы её не увидите.
6. Для обработок и отчётов задайте размещение: в каком разделе меню будет ссылка.
7. Нажмите «Записать и закрыть».

Включите быстрый запуск и проверьте результат

Отметьте нужные команды («Быстрый доступ» в карточке) и дайте право конкретным пользователям или группе. Затем зайдите под обычным пользователем и найдите команду. Если нет, смотрите размещение и право доступа.

Безопасный режим

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

Что делать:

• обработка простая, из надёжного источника, нужны только данные базы: оставьте безопасный режим включённым;
• обработка не запускается и пишет об ограничении: отключайте режим только если доверяете автору, и записывайте это решение в регламент;
• обработка чужая и непроверенная: не запускайте вовсе.

Не снимайте безопасный режим «чтобы заработало», не прочитав, что делает код.

Способ 3. Установка через Конфигуратор

Конфигуратор нужен в двух случаях: вы редактируете обработку или хотите встроить её в конфигурацию.

Открыть EPF для правки

1. Запустите базу в режиме «Конфигуратор».
2. Файл → Открыть и выберите EPF. Откроется дерево с формами, макетами и модулями.
3. После правок сохраните файл (Ctrl+S), а затем перезагрузите его в справочник, как в способе 2.

Встроить в конфигурацию

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

Минус здесь большой. Конфигурация уходит с типовой поддержки, и при обновлении релиза придётся сравнивать и объединять изменения вручную. Для типовой Бухгалтерии на поддержке такой путь обычно не оправдан. Хватает справочника дополнительных обработок.

Права доступа и видимость в интерфейсе

Чаще всего «не получается загрузить» означает «нет права». Разберём по шагам.

Открытие через меню «Файл»

Пункт доступен, если у пользователя есть право интерактивного открытия внешних обработок и отчётов. В типовых профилях БСП его даёт отдельная роль. Её выдаёт администратор в списке пользователей (Администрирование → Настройки пользователей и прав → Группы доступа или напрямую в Конфигураторе через Администрирование → Пользователи).

Запуск подключённой обработки

В справочнике дополнительных отчётов и обработок у каждой записи есть список «Быстрый доступ» и список пользователей. Вносите туда людей или группы. Без этого обработка видна только администратору.

Для документов с командами «Печать» и «Заполнить» работает иное условие: команда видна там, где задано размещение, и у пользователя есть право на сам документ.

Если нужная кнопка не появилась

Проверьте по списку:

• ✅ обработка записана и не помечена на удаление;
• ✅ в карточке указан нужный объект (документ или справочник);
• ✅ у пользователя есть доступ к команде;
• ✅ сеанс перезапущен: закройте 1С и откройте снова, а не просто смените окно.

Ошибки при загрузке EPF и что с ними делать

Веб-клиент и облако

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

Когда EPF загружать не нужно и что сделать перед запуском

• Нужна функция, которая есть в типовой конфигурации. Часто то, что делает обработка, умеет и сам документ или регламентная операция .
• Файл пришёл без объяснений и от непонятного отправителя.
• База «боевая», а вы не проверяли обработку на копии.
• Обработка делает массовые изменения, а откатить их нечем. Групповое перепроведение, удаление помеченных, смена реквизитов в тысячах записей: после запуска вернуть всё назад без копии не получится.

Сначала спросите себя, нельзя ли решить задачу штатной командой 1С. Если нельзя, запускайте обработку на копии, сравните результат с ожидаемым на 5-10 записях, и только после этого повторяйте в рабочей базе.

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

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