Внешняя обработка EPF в 1С 8.3: разовый запуск, подключение в базу и права

Файл EPF в 1С 8.3 можно установить двумя способами. Для разового запуска откройте его через Главное меню → Файл → Открыть (или Ctrl+O). Для постоянной работы зарегистрируйте его в базе: Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки → Добавить из файла....

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

Что такое EPF и какой способ подключения выбрать

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

Не путайте EPF с другими форматами:

• 📄 .epf — внешняя обработка (загрузка данных, групповое изменение, печатная форма, заполнение документа);
• 📊 .erf — внешний отчёт;
• 🧩 .cfe — расширение конфигурации , ставится через Администрирование → Печатные формы, отчеты и обработки → Расширения;
• 📦 .cf и .cfu — сама конфигурация и её обновление, ставятся через Конфигуратор.

Выбор способа зависит от задачи:

Проверка файла EPF перед установкой в 1С

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

Что выяснить у разработчика

• 🏷️ для какой конфигурации и редакции написана обработка: БП 3.0, ЗУП 3.1, УТ 11 или другой;
• 🔢 на каком релизе её проверяли — после крупного обновления типовой обработка может перестать работать;
• 🖥️ в какой версии платформы сохранён файл: открыть его можно только платформой с номером не ниже этой;
• 🔐 поддерживает ли она регистрацию в базе и работу в безопасном режиме.

Как заглянуть внутрь

Откройте Конфигуратор той же базы, затем Файл → Открыть и выберите EPF. Файл откроется в отдельном окне дерева объектов, конфигурацию это не затрагивает.

1. Раскройте корень обработки и откройте модуль объекта.
2. Найдите экспортную функцию СведенияОВнешнейОбработке(). Есть — обработку можно регистрировать в базе. Нет — работает только через Файл → Открыть.
3. Просмотрите код на подозрительные вызовы: COMОбъект, HTTPСоединение, ЗапуститьПриложение, УдалитьФайлы, массовое Удалить() объектов.
4. Закройте окно обработки без сохранения.

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

Функция СведенияОВнешнейОбработке() Экспорт
	ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.2.1");
	ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиДополнительнаяОбработка();
	ПараметрыРегистрации.Версия = "1.0";
	ПараметрыРегистрации.БезопасныйРежим = Истина;

	Команда = ПараметрыРегистрации.Команды.Добавить();
	Команда.Представление = "Загрузка цен из файла";
	Команда.Идентификатор = "ОткрытьФорму";
	Команда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыОткрытиеФормы();
	Команда.ПоказыватьОповещение = Ложь;

	Возврат ПараметрыРегистрации;
КонецФункции

Из неё видно главное: вид обработки, версию, безопасный режим и список команд. Именно эти данные 1С покажет в карточке после загрузки.

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

Это самый короткий путь. В интерфейсе «Такси»:

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

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

Когда меню «Файл → Открыть» не работает

• 🚫 появляется «Нарушение прав доступа!» — у пользователя нет права на интерактивное открытие внешних обработок (см. раздел про права);
• 🛑 открытие блокирует сама конфигурация — в свежих релизах типовых решений администратор может запретить запуск внешних файлов в обход регистрации;
• ☁️ база в облачном сервисе — там внешние обработки обычно разрешены только после проверки провайдером, уточните порядок у своего сервиса.

Установка EPF в базу через «Дополнительные отчёты и обработки»

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

Шаг 1. Включите функциональность

Путь к настройке одинаков по смыслу, но раздел называется по-разному:

Установите флажок «Дополнительные отчеты и обработки». Рядом станет активной одноимённая ссылка — перейдите по ней.

Шаг 2. Загрузите файл

1. В списке нажмите «Добавить из файла…».
2. Подтвердите предупреждение безопасности.
3. Выберите файл .epf (или .erf).
4. 1С прочитает регистрационные данные и откроет карточку.

Шаг 3. Проверьте карточку

В карточке уже заполнены наименование, вид, версия и список команд. Проверьте поля:

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

Нажмите «Записать и закрыть». Обработка установлена.

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

Здесь два разных права, и их часто путают.

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

Быстрый доступ к команде

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

Защита от опасных действий

В платформе 8.3 у пользователя информационной базы есть флажок «Защита от опасных действий». Он настраивается в Конфигураторе: Администрирование → Пользователи, карточка пользователя. Пока флажок стоит, при открытии внешнего файла платформа показывает предупреждение. Снимать флажок ради удобства не стоит — это последний барьер против случайного запуска вредного кода.

Где найти установленную обработку в интерфейсе

Место зависит от вида обработки, который задал разработчик:

• 🗂️ Дополнительная обработка — в разделе из поля «Размещение», в панели действий раздела по команде «Дополнительные обработки» (в БП 3.0 обычно в группе «Сервис»);
• 📊 Дополнительный отчёт — там же, по команде «Дополнительные отчеты»;
• 🖨️ Печатная форма — в меню «Печать» документа или справочника из размещения;
• 📝 Заполнение объекта — в форме документа, в подменю заполнения;
• 🔗 Создание связанных объектов — в подменю создания на основании.

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

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

Большая часть сбоев сводится к несовместимости файла с базой или платформой и к нехватке прав.

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

Как обновить файл EPF в 1С 8.3

Новую версию обработки не нужно добавлять отдельной строкой. Так в базе появятся два экземпляра с одинаковыми командами, и пользователи будут путаться.

Порядок обновления

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

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

• 📁 храните все EPF в одной папке с версией в имени файла: zagruzka-cen_1.3.epf;
• 🧪 после каждого обновления конфигурации прогоняйте обработки в копии базы;
• 📝 ведите короткий реестр: кто разработчик, для какого релиза, кто пользуется;
• 🔄 для крупных доработок, которые ломаются при каждом релизе, рассмотрите переход на расширение конфигурации.

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

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