Внешняя обработка .epf: правка в Конфигураторе без поломок

Обновлено 07.10.2026 · 9 мин

Содержание

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

Главное правило: редактируйте копию, а не единственный экземпляр файла. Обработка с ошибкой в модуле может не открыться совсем, а версия «как было вчера» нужна чаще, чем кажется. Ниже описано, как открыть и отредактировать файл, как обновить обработку, подключённую к базе, и что делать, если файл не открывается.

Что лежит внутри EPF-файла и где он используется

EPF (External Processing File) — внешняя обработка 1С:Предприятия 8. Рядом с ней существует ERF — внешний отчёт. Устроены они одинаково, отличаются назначением и набором свойств.

Внутри файла хранятся:

📦 реквизиты и табличные части обработки;
🧩 формы (управляемые и/или обычные);
📝 модуль объекта и модули форм;
🖨 макеты — например, табличные документы для печатных форм.

Где EPF встречается на практике:

Сценарий	Как подключается	Кто обычно правит
Разовая обработка (загрузка, исправление данных)	Открывают файлом вручную	Программист, админ
Дополнительная печатная форма	Регистрируется в справочнике дополнительных обработок	Программист
Заполнение табличной части документа	Тот же справочник, назначение на объект	Программист
Регламентная операция по расписанию	Тот же справочник, команда с расписанием	Программист, админ

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

Открыть EPF-файл: в пользовательском режиме и в Конфигураторе

Способ зависит от цели. Чтобы запустить обработку и поработать с ней, нужен режим 1С:Предприятие. Чтобы посмотреть код или изменить её — Конфигуратор.

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

Откройте базу, в которой будете работать с обработкой.
Нажмите Главное меню → Файл → Открыть или Ctrl+O.
Выберите файл .epf и нажмите «Открыть».
Если платформа покажет предупреждение безопасности, прочитайте, откуда файл, и только потом подтвердите открытие.

Для открытия нужны права. У пользователя должно быть право интерактивного открытия внешних обработок (в метаданных оно называется ИнтерактивноеОткрытиеВнешнихОбработок). В типовых конфигурациях его дают профили групп доступа, а у полноправного администратора оно есть всегда.

Если команды Файл → Открыть нет или файл не открывается из-за прав, это не поломка. Администратор базы выдал пользователю ограниченный профиль. Правильный путь — зарегистрировать обработку в справочнике дополнительных обработок, а не расширять права всем подряд.

Открытие в Конфигураторе

Запустите базу в режиме Конфигуратор. Подойдёт любая база, в том числе пустая учебная.
Файл → Открыть, выберите .epf.
Откроется отдельное окно с деревом объекта: реквизиты, табличные части, формы, макеты.
Двойной щелчок по корню дерева — модуль объекта. Двойной щелчок по форме — редактор формы с вкладкой «Модуль».

Открывать конфигурацию базы (Конфигурация → Открыть конфигурацию) для этого не требуется. Но если обработка обращается к справочникам и документам, проверять её надо в базе с той же конфигурацией, для которой она писалась.

Как отредактировать внешнюю обработку по шагам

Порядок одинаков для любой правки: код, форма, макет печатной формы.

Шаг 1. Сделайте копию

Скопируйте файл рядом с припиской даты: ЗагрузкаЦен_2026-10-07.epf. Если обработка зарегистрирована в базе, сначала выгрузите её оттуда (как — ниже, в разделе про справочник).

Шаг 2. Внесите изменения

Код. Правьте модуль объекта или модуль формы. После правки нажмите Ctrl+F7 — это проверка синтаксиса модуля. Ошибки покажет окно служебных сообщений.
Форма. Добавьте реквизит в обработку или форму, перетащите его в дерево элементов. Для команды создайте её на вкладке «Команды» формы и назначьте обработчик.
Макет печатной формы. Откройте макет, правьте ячейки и области. Имена именованных областей не меняйте: модуль ищет их по имени.

Шаг 3. Сохраните и проверьте

Файл → Сохранить или Ctrl+S. Сохраняется сам .epf, база не меняется.
В пользовательском режиме закройте форму обработки, если она была открыта, и откройте файл заново.
Проверьте результат на тестовых данных или на копии базы, если обработка что-то записывает.

Обработка, которая записывает или удаляет данные, при ошибке испортит рабочую базу. Первый прогон после правки делайте в копии базы. Резервную копию рабочей базы — перед первым запуском на ней.

Перед тем как отдавать исправленную обработку

Синтаксис проверен без ошибок
Файл открывается в пользовательском режиме
Проверен прогон на копии базы
Старая версия файла сохранена
Если обработка в справочнике — новая версия загружена туда

Выполнено: 0 / 5

Обработка подключена к базе: правка через справочник

Если обработка зарегистрирована в базе на БСП (БП 3.0, ЗУП 3.1, УТ 11 и другие типовые), правка файла на диске ничего не изменит. База хранит свою копию внутри справочника.

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

Порядок такой:

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

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

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

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

Другие способы редактирования: XML, EDT, командная строка

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

Способ	Когда удобен	Ограничения
Конфигуратор	Разовая правка, отладка	Бинарный файл, история изменений не видна
Выгрузка в XML-файлы	Хранение в Git, сравнение версий	Обратно собирать тоже Конфигуратором
1C:EDT	Командная разработка, много обработок	Отдельная среда, нужно время на освоение
Сторонние распаковщики	Посмотреть содержимое без платформы	Не для правки рабочих файлов

Выгрузка обработки в файлы

В Конфигураторе, когда обработка открыта, щёлкните правой кнопкой по корню её дерева и выберите выгрузку в файлы. Получится каталог с XML-описанием и текстами модулей. Их можно положить в Git и сравнивать построчно. Загрузка из файлов в том же контекстном меню собирает каталог обратно в .epf.

То же делают из командной строки, без открытия окна Конфигуратора:

"C:\Program Files\1cv8\8.3.25.1374\bin\1cv8.exe" DESIGNER /F "D:\Bases\Test" /DumpExternalDataProcessorOrReportToFiles "D:\src\ZagruzkaCen" "D:\epf\ZagruzkaCen.epf"

"C:\Program Files\1cv8\8.3.25.1374\bin\1cv8.exe" DESIGNER /F "D:\Bases\Test" /LoadExternalDataProcessorOrReportFromFiles "D:\src\ZagruzkaCen\ZagruzkaCen.xml" "D:\epf\ZagruzkaCen.epf"

Номер версии в пути подставьте свой: он совпадает с каталогом установленной платформы. База в параметре /F нужна только для запуска Конфигуратора, её данные команда не трогает.

1C:EDT

В EDT внешние обработки импортируют в отдельный проект. Код правят в редакторе с подсказками, а готовый .epf собирают из проекта. Это оправдано, если вы ведёте десятки обработок и работаете командой.

Когда EPF не открывается или открывается не так

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

Диагностика: выберите симптом

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

Безопасность: чужие EPF-файлы и рабочая база

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

Что делать с файлом из непроверенного источника:

🔍 откройте его в Конфигураторе и прочитайте модули до первого запуска;
🚩 ищите обращения к файлам, COMОбъект, HTTP-соединения, команды удаления объектов;
🧪 первый запуск — в копии базы, а не в рабочей;
🔐 не запускайте неизвестную обработку под полными правами, если хватает обычного пользователя.

Платформа помогает защищаться. Для пользователей можно включить защиту от опасных действий: в Конфигураторе в Администрирование → Пользователи откройте карточку пользователя и отметьте соответствующий флажок. Тогда при открытии внешнего файла платформа выдаст предупреждение безопасности, и пользователь решит, доверять ли файлу.

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

Приёмы для тех, кто правит обработки регулярно

Отладка с точками останова

Откройте .epf в Конфигураторе и поставьте точку останова (F9) на нужной строке.
Запустите отладку Отладка → Начать отладку или F5.
В открывшемся сеансе откройте тот же самый файл через Файл → Открыть.
Выполнение остановится на точке, значения переменных видны в окне «Вычислить выражение» (Shift+F9).

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

Быстрый тест без перезапуска

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

Контроль версий

Выгружайте обработку в XML после каждой правки и коммитьте каталог в Git. Через полгода разница между «рабочей» и «той, что прислали» видна за минуту, а не после построчного сравнения модулей вручную.

Можно ли редактировать EPF без Конфигуратора?

Полноценно — только в Конфигураторе или 1C:EDT. Сторонние распаковщики позволяют посмотреть содержимое, но собранный ими файл может не открыться.

Нужна ли отдельная база, чтобы открыть EPF в Конфигураторе?

Нужна любая информационная база: Конфигуратор запускается только от неё. Для просмотра кода хватит пустой базы, для проверки работы — базы с той конфигурацией, под которую писалась обработка.

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

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

Можно ли превратить внешнюю обработку во встроенную?

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

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

Разные права. У второго пользователя нет права на открытие внешних обработок или на объекты, к которым обращается код.

Помогла статья?