Файлы epf и erf: правка в Конфигураторе, запуск и отладка в 1С:Предприятии

Внешнюю обработку в Конфигураторе 1С открывают через Файл → Открыть (или Ctrl+O): в диалоге выбираете файл .epf (обработка) или .erf (отчёт), и он раскрывается отдельным окном с деревом реквизитов, форм, макетов и модулем объекта. Запустить её прямо из Конфигуратора нельзя — для работы и проверки нужна база в режиме 1С:Предприятие, где файл открывают тем же Файл → Открыть из главного меню.

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

Конфигуратор или Предприятие: где что делают с файлом epf и erf

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

Два расширения:

• 📄 .epf — внешняя обработка: загрузка данных, групповые изменения, печать, сервисные операции.
• 📊 .erf — внешний отчёт: обычно на системе компоновки данных, с настройками и вариантами.

Что можно сделать в каждом режиме:

Что подготовить до открытия внешней обработки

Большинство отказов при открытии связано не с файлом, а с правами пользователя и версией платформы.

Права в конфигурации

Открытие файла через меню регулируют два права корня конфигурации:

• 🔑 «Интерактивное открытие внешних обработок»;
• 🔑 «Интерактивное открытие внешних отчетов».

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

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

Версия платформы

Файл, сохранённый в более новой платформе, может не открыться в старой. Проверьте номер версии в Справка → О программе в обоих местах: там, где файл создавали, и там, где его открываете. Номер платформы у вас должен быть не ниже, чем у автора файла.

Резервная копия

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

Открытие внешней обработки в Конфигураторе: порядок действий

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

После правок проверьте синтаксис: в открытом модуле нажмите Ctrl+F7. Ошибки появятся в окне сообщений внизу, двойной щелчок переносит к строке.

Создать новую обработку

Если файла ещё нет, выберите Файл → Новый и в списке — «Внешняя обработка» или «Внешний отчет ». Задайте имя в свойствах корневого объекта, добавьте форму и сохраните файл на диск. Имя объекта — это не имя файла: под ним обработка будет видна в коде и в справочнике дополнительных обработок.

Запуск и отладка в режиме 1С:Предприятие

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

Обычный запуск

• В интерфейсе «Такси» откройте главное меню (кнопка с тремя полосками в левом верхнем углу) и выберите Файл → Открыть. Работает и Ctrl+O.
• Укажите файл .epf или .erf и нажмите Открыть.
• Откроется основная форма обработки. Если у обработки нет формы, платформа сообщит об этом — такой файл рассчитан на запуск из кода или из справочника дополнительных обработок.

Отладка по шагам

1. Откройте файл в Конфигураторе и поставьте точку останова в нужной строке модуля: F9 или двойной щелчок по левому полю.
2. Запустите Предприятие из Конфигуратора: Отладка → Начать отладку (F5) или выберите конкретный клиент в том же меню.
3. В открывшемся Предприятии откройте тот же самый файл через Файл → Открыть.
4. Выполните действие, которое вызывает нужный код. Выполнение остановится, Конфигуратор выйдет на передний план.
5. Дальше F11 — шаг с заходом в процедуру, F10 — шаг без захода, F5 — продолжить до следующей точки.

Точки останова срабатывают, только если в Предприятии открыт файл по тому же пути, что и в Конфигураторе. Скопировали файл в другую папку — отладчик его не узнает.

Постоянное подключение через справочник

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

1. Включите функциональность: Администрирование → Печатные формы, отчеты и обработки, флажок «Дополнительные отчеты и обработки».
2. Перейдите по ссылке «Дополнительные отчеты и обработки» и нажмите Добавить из файла.
3. Укажите файл и разместите обработку в нужном разделе.

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

Предупреждение безопасности и «Защита от опасных действий»

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

Откуда берётся окно и как с ним работать:

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

Безопасный режим при программном подключении

Если обработку подключают из кода, платформа по умолчанию выполняет её в безопасном режиме — без доступа к файлам, COM-объектам и внешним компонентам. Пример подключения в клиент-серверной базе:

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

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

&НаСервере
Функция ПодключитьНаСервере(Адрес)
    // Третий параметр — безопасный режим; Истина ограничивает возможности обработки
    Возврат ВнешниеОбработки.Подключить(Адрес, , Истина);
КонецФункции

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

Как посмотреть код и состав метаданных обработки

Иногда обработку открывают не ради запуска, а чтобы понять, что она делает: какие объекты меняет, куда пишет данные.

Быстрый осмотр в Конфигураторе

• 🔍 Дерево объекта показывает реквизиты, табличные части, формы и макеты. Свойства каждого элемента — Alt+Enter.
• 🔍 Поиск по модулям: Ctrl+F внутри модуля — ищите по ключевым словам, перечисленным ниже.
• 🔍 Ищите в коде обращения Записать(), Удалить(), УстановитьПометкуУдаления, Новый COMОбъект, КомандаСистемы, ЗапуститьПриложение — это места, где обработка меняет данные или выходит за пределы базы.

Выгрузка в XML через командную строку

Для сравнения версий или хранения в Git обработку разбирают на XML-файлы. Платформа умеет это в пакетном режиме Конфигуратора:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F "D:\Bases\Test" /N "Администратор" /P "" ^
  /DumpExternalDataProcessorOrReportToFiles "D:\src\Zagruzka.xml" "D:\epf\Zagruzka.epf" ^
  /Out "D:\src\dump.log"

Обратная сборка из XML в файл — ключ /LoadExternalDataProcessorOrReportFromFiles с теми же двумя путями в обратном порядке: сначала XML, затем итоговый .epf. Путь к 1cv8.exe замените на свой: номер версии в каталоге у каждого свой.

Если исходного кода нет

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

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

Если обработка так и не открылась

Когда ни права, ни повторная загрузка файла не помогли, проверьте по очереди:

1. Совпадение конфигурации. Обработка для Бухгалтерии 3.0 почти никогда не заработает в УТ 11 и наоборот: имена справочников и реквизитов отличаются.
2. Путь к файлу. Слишком длинный путь или сетевой диск с ограниченным доступом мешают выбрать файл. Скопируйте его в короткий локальный путь, например C:\epf\.
3. Тип клиента. Обработка с обычными формами создавалась для толстого клиента. В тонком клиенте и веб-клиенте управляемого интерфейса такая форма не откроется. Нужна версия с управляемыми формами или запуск в толстом клиенте.
4. Пересохранение. Откройте файл в Конфигураторе своей базы, выполните Ctrl+F7, исправьте ошибки и сохраните под новым именем через Файл → Сохранить как.

Если и после этого ничего не вышло, обратитесь к разработчику обработки: передайте ему номер платформы, название и релиз конфигурации из Справка → О программе и полный текст ошибки.

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