К статье
Практический материал

Разработка и Конфигурация · 8 мин

Как сохранить внешнюю обработку 1С

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

Внешняя обработка в 1С — это файл с расширением .epf, который содержит алгоритм, формы и макеты, но не входит в состав конфигурации. Такой файл можно запустить в любой подходящей базе через меню «Файл → Открыть», не изменяя саму конфигурацию. Именно поэтому умение правильно сохранить внешнюю обработку — базовый навык разработчика, внедренца и продвинутого пользователя.

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

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

Что такое внешняя обработка и где она хранится

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

Формат файла — .epf (external processing file). Это бинарный контейнер, который нельзя редактировать текстовым редактором: вся работа ведётся через конфигуратор. Для внешних отчётов используется аналогичный формат .erf, и логика сохранения у них одинаковая.

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

Как сохранить новую внешнюю обработку из конфигуратора

Стандартный сценарий: вы создали обработку через «Файл → Новый → Внешняя обработка», написали код модуля, добавили форму. Теперь её нужно записать на диск.

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

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

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

Как сохранить изменённую обработку под другим именем

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

Это стандартный приём версионирования «вручную»: Обработка_v1.epf, Обработка_v2.epf. Способ рабочий, но при активной разработке надёжнее хранить обработки в системе контроля версий, выгружая их в исходные файлы через EDT или пакетный режим конфигуратора.

Если файл занят или нет прав на запись

Типовая ошибка — сохранение в папку, где у пользователя нет прав на запись (например, в Program Files или сетевой каталог с ограничениями). Платформа выдаст ошибку записи. Решение: сохраните файл в личную папку, а затем скопируйте его в целевой каталог с нужными правами, либо попросите администратора выдать доступ.

Как сохранить обработку, открытую в режиме «Предприятие»

Частая ситуация: пользователь получил обработку, открыл её через «Файл → Открыть», и теперь хочет сохранить файл себе. Если файл уже лежит на диске — ничего сохранять из 1С не нужно: просто скопируйте сам файл .epf средствами проводника Windows.

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

Обработка встроена в конфигурацию

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

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

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

Полная проверка — запуск в режиме «Предприятие» на копии базы. Обработка должна открыться, форма — отобразиться, а основной сценарий — выполниться без ошибок компиляции модуля.

Контрольные точки

Как проверить результат

Файл на диске
Норма

Файл .epf существует, размер больше нуля, дата изменения свежая

Тревожный признак

Файла нет или размер 0 байт — сохранение не завершилось

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

Обработка загружается, формы и модуль доступны

Тревожный признак

Ошибка чтения файла — файл повреждён или сохранён не полностью

Запуск в «Предприятии»
Норма

Обработка открывается и выполняется без ошибок

Тревожный признак

Ошибка компиляции или выполнения — код требует доработки

Типичные ошибки при сохранении

Типичные ошибки
01
Сохранение в системную папку без прав записи — платформа выдаёт ошибку, изменения теряются при закрытии; сохраняйте в пользовательский каталог
02
Путаница между EPF и ERF: отчёт сохраняют как обработку и наоборот — файл потом не подключается к нужному механизму
03
Редактирование файла, открытого одновременно в двух конфигураторах — последнее сохранение перезаписывает изменения первого
04
Отсутствие контрольного запуска после сохранения — синтаксическая ошибка обнаруживается уже у пользователя
05
Хранение единственной копии только в базе как дополнительной обработки — при чистке справочника исходник теряется

Отдельно стоит упомянуть работу по сети. Сохранение обработки напрямую в сетевую папку при нестабильном соединении может прерваться и оставить повреждённый файл. Надёжнее сохранять локально и затем копировать.

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

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

EPF — внешняя обработка, ERF — внешний отчёт. Тип объекта выбирается при создании через «Файл → Новый». Механика сохранения одинаковая, но подключаются они по-разному: отчёты обычно регистрируются в подсистеме дополнительных отчётов, обработки — в дополнительных обработках.

Можно ли сохранить внешнюю обработку без конфигуратора?

Из режима «Предприятие» создать или изменить файл .epf нельзя — там обработка только выполняется. Можно лишь скопировать уже существующий файл средствами операционной системы.

Почему при сохранении появляется ошибка «Файл занят другим процессом»?

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

Как сохранить обработку, если конфигурация на поддержке без изменений?

Внешняя обработка не изменяет конфигурацию, поэтому ограничения поддержки на неё не влияют. Создавайте и сохраняйте файл .epf через «Файл → Новый → Внешняя обработка» — снятие замка не требуется.

Откроется ли обработка, сохранённая в новой версии платформы, на старой?

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

Как перенести обработку в другую базу?

Достаточно скопировать файл .epf и открыть его в целевой базе через «Файл → Открыть». Условие: объекты метаданных, к которым обращается код (справочники, документы, регистры), должны существовать и в целевой базе, иначе возникнут ошибки выполнения.

Итог

Что важно запомнить

Внешняя обработка сохраняется только из конфигуратора командой «Файл → Сохранить / Сохранить как» в файл .epf. Храните файл в папке с правами записи, после сохранения проверяйте открытие и запуск, а неизвестные обработки перед запуском проверяйте в конфигураторе.