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

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

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

Что проверить до установки обработки

Файл с расширением .epf — это внешняя обработка, .erf — внешний отчёт. Ставятся они одинаково. Но обработка, написанная под одну конфигурацию, в другой может не заработать. Поэтому начните с проверки.

📌 Что выяснить у разработчика или в описании файла:

• 🧩 Под какую конфигурацию и редакцию написана обработка: БП 3.0, ЗУП 3.1, УТ 11, КА 2. Обработка для БП 3.0 обращается к справочникам и документам этой конфигурации, в ЗУП их нет.
• 🔢 Минимальный релиз конфигурации и номер платформы — не ниже какого работает.
• 🖥 Тип форм. Обработки с обычными формами (старые, из 8.2) в тонком клиенте и веб-клиенте не открываются. Для «Такси» нужны управляемые формы.
• 📝 Поддерживает ли файл регистрацию в справочнике дополнительных обработок. Об этом ниже — без этого его можно только открыть разово.
• 🔐 Что делает обработка: меняет данные, обращается к файлам на диске, к интернету, к внешним программам.

Проверить номер своей конфигурации и платформы можно в главном меню: ≡ → Справка → О программе.

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

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

Разовое открытие — самый быстрый путь. Подходит, чтобы проверить файл, выполнить загрузку из Excel один раз или запустить сервисную обработку.

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

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

Почему при открытии появляется предупреждение

У пользователя 1С есть свойство «Защита от опасных действий». Когда оно включено, при открытии внешнего файла платформа предупреждает, что файл может навредить, и спрашивает подтверждение. Это нормально: предупреждение защищает от случайного запуска чужого кода.

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

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

Пункт может быть недоступен или выдавать ошибку прав, если у пользователя нет права интерактивно открывать внешние обработки. В типовых конфигурациях на базе БСП его даёт роль «Интерактивное открытие внешних отчетов и обработок». Как её выдать — в разделе про права.

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

Постоянная установка идёт через справочник «Дополнительные отчеты и обработки». Файл сохраняется внутри базы. Поэтому он доступен всем, кому вы его назначите, с любого компьютера, в том числе через веб-клиент и на сервере.

Шаг 1. Включите дополнительные обработки

Путь в типовых конфигурациях:

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

Шаг 2. Загрузите файл в справочник

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

Вид обработки определяет, где появится её команда:

Вид меняет не пользователь — его задаёт разработчик внутри файла.

Шаг 3. Настройте размещение и пользователей

Для дополнительной обработки или отчёта откройте поле «Размещение» и отметьте разделы, где она нужна: например, «Банк и касса» или «Зарплата и кадры».

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

Дальше на закладке команд можно настроить быстрый доступ: выбрать пользователей, у которых команда будет видна сразу, без поиска в списке.

Шаг 4. Включите публикацию и запишите

Поле «Публикация» принимает три значения:

• ✅ Используется — обработка работает у всех, кому доступна.
• 🧪 Режим отладки — видна только администраторам. Удобно для проверки перед запуском в работу.
• ⛔ Отключена — хранится в базе, но не запускается.

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

Как обновить обработку до новой версии

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

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

Как сделать EPF пригодным для регистрации

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

Если доступ к Конфигуратору есть, функцию можно добавить самостоятельно.

1. Откройте Конфигуратор и выберите Файл → Открыть, укажите файл .epf.
2. Откройте модуль объекта обработки.
3. Добавьте функцию регистрации. Минимальный пример для обработки, которая просто открывает свою форму:

Функция СведенияОВнешнейОбработке() Экспорт

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

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

	Возврат ПараметрыРегистрации;

КонецФункции

4. Сохраните файл и снова загрузите его в справочник.

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

Права доступа и безопасный режим

Установка обработки упирается в права двух уровней: кто может её загрузить и кто может запускать.

Кто может загружать и открывать

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

1. Откройте Администрирование → Пользователи и права → Группы доступа (в УТ 11 — через НСИ и администрирование → Настройки пользователей и прав).
2. Найдите или создайте группу доступа, в профиле которой есть нужная роль.
3. Добавьте в группу пользователя и запишите.

Изменения применятся при следующем входе пользователя в программу.

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

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

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

• 🔓 Снять флажок безопасного режима — только для обработок, в которых вы уверены.
• 🛡 Разрешить конкретные ресурсы через профили безопасности. Если в кластере серверов 1С включено их использование, программа при регистрации покажет, какие внешние ресурсы просит обработка, и попросит подтвердить разрешения.

Второй вариант точнее: обработка получает доступ только к тому, что ей действительно нужно.

Облачные сервисы

В облачных базах (1С:Фреш, сервисы на его основе) загрузить произвольный EPF обычно нельзя. Обработки там проходят проверку у поставщика сервиса. Порядок уточняйте в поддержке своего облака.

Запуск обработки из командной строки

Обработку можно запустить сразу при входе в базу — без меню и щелчков. Для этого у исполняемого файла 1cv8.exe есть параметр /Execute.

Пример ярлыка или bat-файла для файловой базы:

@echo off
"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" ENTERPRISE ^
  /F"D:\Bases\Buh" ^
  /N"Администратор" /P"пароль" ^
  /Execute"D:\Obrabotki\zagruzka.epf"

Для клиент-серверной базы вместо /F указывают /S"сервер\имя_базы". Номер версии в пути замените на свой — он виден в папке C:\Program Files\1cv8\.

Полезные дополнения:

• /C"строка" — передаёт параметр запуска. Обработка может прочитать его через ПараметрЗапуска и, например, сразу выполнить загрузку.
• /DisableStartupMessages — не показывать стартовые сообщения, которые остановят скрипт.

Запуск по расписанию без командной строки

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

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

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

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