Файл .epf в 1С 8.3: открыть из меню, командной строки, справочника и кода

Чтобы запустить внешнюю обработку 1С, откройте главное меню (кнопка с тремя полосками в левом верхнем углу окна), выберите Файл → Открыть или нажмите Ctrl+O и укажите файл .epf. Обработка откроется сразу, если у пользователя есть право на интерактивное открытие внешних обработок, а платформа не заблокирует файл предупреждением безопасности.

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

Какой способ запуска выбрать

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

💡 Для бухгалтера в типовой конфигурации на практике остаются два способа: меню «Файл» для разового запуска и справочник для постоянной работы. Командная строка и код — инструменты администратора и программиста.

Открываем внешнюю обработку через меню «Файл»

Это самый быстрый способ и единственный, который не требует подготовки со стороны администратора.

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

В окне выбора файла можно не искать файл по папкам, а вставить полный путь в поле имени файла: например, \\fileserver\1c\obrabotki\ZagruzkaIzExcel.epf. Так удобно, когда обработки лежат в общей сетевой папке, а путь записан в инструкции для сотрудников.

Предупреждение безопасности при открытии файла

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

Предупреждение управляется флажком «Защита от опасных действий» в карточке пользователя. Флажок есть в списке пользователей Конфигуратора (Администрирование → Пользователи), в конфигурациях на БСП его можно настроить и в карточке пользователя в режиме Предприятия.

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

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

Если пункт Файл → Открыть есть, а файл не открывается с сообщением о нарушении прав доступа, у пользователя нет права на интерактивное открытие внешних обработок.

В типовых конфигурациях на БСП это право выдаёт роль «Интерактивное открытие внешних отчетов и обработок». Порядок для БП 3.0, ЗУП 3.1, УТ 11 одинаковый:

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

💡 Хорошая практика — не выдавать эту роль всем. Пусть право открывать любые файлы будет у администратора и пары опытных бухгалтеров, а остальные работают через справочник дополнительных обработок: там обработку проверяют один раз, а запускают многие.

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

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

Платформа умеет открыть внешнюю обработку сразу после входа в базу. За это отвечает параметр /Execute у 1cv8.exe. Так делают ярлыки «одной кнопкой» и ночные задания в планировщике Windows.

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

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

Для клиент-серверной базы путь к базе задаётся через /S:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" ENTERPRISE /S"srv1c\buh" /N"Администратор" /P"пароль" /Execute"\\fileserver\1c\obrabotki\ZagruzkaIzExcel.epf"

Что важно в этих строках:

• 📁 Номер версии в пути к 1cv8.exe подставьте свой: посмотрите папку C:\Program Files\1cv8\ на компьютере.
• 🔑 Если в базе включена аутентификация Windows, /N и /P не нужны.
• 🧩 Параметр /C"строка" передаёт в базу произвольный текст. Внутри обработки его читают через глобальную переменную ПараметрЗапуска и, например, выбирают режим работы без участия пользователя.
• 🔇 /DisableStartupMessages убирает стартовые сообщения, которые мешают пакетному запуску.

Для фонового выполнения без участия человека сама обработка должна быть написана под такой запуск: выполнять действие при открытии формы и завершать работу системы командой ЗавершитьРаботуСистемы(Ложь). Обычную интерактивную обработку /Execute просто откроет и будет ждать нажатия кнопок.

Справочник дополнительных отчётов и обработок

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

Включаем справочник

В БП 3.0, ЗУП 3.1 и УТ 11 путь одинаковый: Администрирование → Печатные формы, отчеты и обработки. Установите флажок «Дополнительные отчеты и обработки». Рядом станет активной ссылка на одноимённый справочник.

Загружаем обработку

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

Где потом искать команду, зависит от вида обработки:

Почему файл не загружается в справочник

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

Если функции нет, справочник откажется принимать файл с сообщением, что обработка не поддерживает регистрацию. Такую обработку запускают через Файл → Открыть, либо программист дописывает ей регистрационные данные. Это 20–40 строк кода, шаблон есть в документации к БСП.

💡 У обработок из справочника есть важный плюс: для дополнительных обработок с серверными командами можно задать расписание. Тогда 1С сама выполнит обработку как регламентное задание, без bat-файлов и паролей в ярлыках.

Программный запуск внешней обработки из кода 1С

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

&НаКлиенте
Процедура ОткрытьВнешнююОбработку(Команда)
	Оповещение = Новый ОписаниеОповещения("ПослеПомещенияФайла", ЭтотОбъект);
	НачатьПомещениеФайла(Оповещение, , "", Истина, УникальныйИдентификатор);
КонецПроцедуры

&НаКлиенте
Процедура ПослеПомещенияФайла(Результат, Адрес, ВыбранноеИмяФайла, ДополнительныеПараметры) Экспорт
	Если Не Результат Тогда
		Возврат; // пользователь отменил выбор файла
	КонецЕсли;
	ИмяОбработки = ПодключитьНаСервере(Адрес);
	ОткрытьФорму("ВнешняяОбработка." + ИмяОбработки + ".Форма");
КонецПроцедуры

&НаСервереБезКонтекста
Функция ПодключитьНаСервере(Адрес)
	Возврат ВнешниеОбработки.Подключить(Адрес);
КонецФункции

Как это работает:

• 📤 НачатьПомещениеФайла с четвёртым параметром Истина показывает пользователю окно выбора файла и кладёт выбранный файл во временное хранилище.
• 🔌 ВнешниеОбработки.Подключить подключает обработку на сервере и возвращает её имя. По умолчанию обработка подключается в безопасном режиме: ей запрещены, например, запись файлов на сервере и работа с внешними компонентами.
• 🪟 ОткрытьФорму("ВнешняяОбработка.<Имя>.Форма") открывает основную форму. Другую форму открывают по её имени из обработки.

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

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

Диагностика ошибок при запуске обработки

Большая часть проблем укладывается в пять сценариев. Выберите свой симптом.

Если ни один сценарий не подошёл, откройте журнал регистрации: Администрирование → Обслуживание → Журнал регистрации, отбор по пользователю и времени запуска. Там видно полный текст ошибки и модуль, в котором она возникла. Этот текст стоит отправить автору обработки целиком, со строкой и номером модуля.

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