Обработка в отдельный файл: три способа получить epf из Конфигуратора и рабочей базы
Содержание
Сохранить обработку в 1С можно тремя путями. Новую или открытую из файла внешнюю обработку
сохраняют в Конфигураторе через Файл → Сохранить (Ctrl+S) — получается файл .epf. Встроенную обработку из конфигурации выгружают командой контекстного меню Сохранить как внешнюю обработку, отчет.... Обработку, загруженную пользователями в базу, достают из справочника дополнительных обработок командой выгрузки в файл.
Какой путь выбрать, зависит от того, где обработка живёт сейчас:
| Где сейчас обработка | Чем сохранить | Что нужно |
|---|---|---|
| Открыта из файла или создана заново | Конфигуратор, Ctrl+S | доступ к Конфигуратору |
| Встроена в конфигурацию (ветка «Обработки») | контекстное меню объекта в дереве | доступ к Конфигуратору, права администратора |
| Загружена в базу как дополнительная | карточка в справочнике дополнительных обработок | право на изменение дополнительных обработок |
| Открыта пользователем через «Файл → Открыть» | никак — копия только на диске | найти исходный файл |
Чем отличаются файлы epf и erf
У платформы 1С:Предприятие 8.3 два формата внешних объектов. Они устроены одинаково, но открываются по-разному.
| Файл | Что внутри | Где используется |
|---|---|---|
.epf | внешняя обработка | загрузка данных, групповые изменения, печатные формы, сервисные инструменты |
.erf | внешний отчёт | отчёты на системе компоновки данных, аналитика |
.cf | вся конфигурация | обновление и перенос конфигурации, не для отдельной обработки |
.cfe | расширение конфигурации | доработки без снятия с поддержки, не путать с обработкой |
📌 Что важно знать о форматах:
- 📄 Файл
.epf— двоичный контейнер. В нём лежат модули, формы, макеты и реквизиты обработки. Открыть его блокнотом и прочитать код нельзя. - 🔁 Переименовать
.erfв.epfбесполезно: платформа проверяет тип объекта внутри файла, а не расширение. - 🧩 Печатная форма, которую подключают через «Дополнительные отчеты и обработки», — это обычный
.epfс особой функцией регистрации в модуле объекта. - 📦 Если нужен текстовый вид для Git, обработку разбирают в XML-файлы (об этом — в разделе про совместимость).
Сохранение обработки в Конфигураторе
Это основной способ для разработчика. Конфигуратор умеет создавать, редактировать и сохранять внешние обработки без открытой конфигурации базы, но для проверки ссылок на справочники и документы базу лучше открыть.
Новая внешняя обработка
- Запустите базу в режиме «Конфигуратор».
- Выберите
Файл → Новый...и в списке — «Внешняя обработка» (или «Внешний отчет »). - В окне объекта задайте имя латиницей или кириллицей без пробелов, например
ЗагрузкаЦенИзExcel. - Добавьте реквизиты, форму, модуль.
- Нажмите
Файл → Сохранитьили Ctrl+S. - В диалоге выберите папку и имя файла. Расширение
.epfподставится само.
Изменённая обработка из файла
Файл → Открыть(Ctrl+O), укажите.epf.- Внесите правки в модуль или форму.
- Ctrl+S перезапишет исходный файл. Если нужна отдельная версия —
Файл → Сохранить как...и новое имя, напримерЗагрузкаЦен_v2.epf.
Перед сохранением прогоните синтаксический контроль модуля (Ctrl+F7 в окне модуля). Файл с ошибкой в коде сохранится, но в режиме «Предприятие» обработка не откроется или упадёт при первом вызове.
Встроенная обработка из конфигурации
Частая задача: обработка есть в дереве конфигурации, а её нужно отдать коллеге, отладить отдельно или запустить в другой базе той же конфигурации.
- Откройте конфигурацию:
Конфигурация → Открыть конфигурацию. - В дереве раскройте ветку «Обработки» (или «Отчеты»).
- Щёлкните правой кнопкой по нужному объекту.
- Выберите
Сохранить как внешнюю обработку, отчет.... - Укажите папку и имя файла.
Команда работает и для типовой конфигурации на поддержке без возможности изменения: выгрузка ничего в базе не меняет. Для включения правок обратно есть парная команда Заменить на внешнюю обработку, отчет..., но она уже меняет конфигурацию и требует снятой блокировки объекта.
Обратная замена встроенной обработки в типовой конфигурации требует включить возможность изменения и усложняет каждое следующее обновление. Для доработок типовых решений надёжнее расширение конфигурации .
Если Конфигуратор не сохраняет файл
- 📁 Нет прав на папку. Сохранение в
C:\Program Filesили в сетевую папку только для чтения завершится ошибкой записи. Выберите папку в профиле пользователя, например «Документы». - 🔒 Файл защищён от записи. У файла стоит атрибут «Только чтение» или он лежит в папке синхронизации, которая его заблокировала. Снимите атрибут в свойствах файла или сохраните под новым именем.
- ✏️ Недопустимое имя. Имя объекта внутри обработки не может начинаться с цифры и содержать пробелы. Имя файла на диске может быть любым, но лучше держать его равным имени объекта — так проще искать.
Как выгрузить обработку из режима «Предприятие»
Пользовательский режим не умеет сохранять встроенные обработки конфигурации. Зато он хранит внутри базы дополнительные обработки и отчёты, которые когда-то загрузили через справочник. Их можно выгрузить обратно в файл без Конфигуратора.
Где найти список дополнительных обработок
| Конфигурация | Путь меню |
|---|---|
| Бухгалтерия предприятия 3.0 | Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки |
| ЗУП 3.1 | Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки |
| Управление торговлей 11 | НСИ и администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки |
Если ссылки нет, на той же странице сначала включите флажок «Дополнительные отчеты и обработки».
Порядок выгрузки
- Откройте список и найдите нужную строку. Вид («Дополнительная обработка», «Печатная форма», «Заполнение объекта») видно в колонке списка.
- Откройте карточку двойным щелчком.
- В командной панели карточки выберите команду выгрузки в файл. Если её не видно на панели, она в меню «Ещё».
- Укажите папку. Имя файла по умолчанию совпадает с именем, под которым обработку загружали.
Команда доступна пользователю с правом на добавление и изменение дополнительных отчётов и обработок. Обычно это администратор. Если кнопка неактивна — дело в правах, а не в обработке.
В справочнике хранится та версия, которую загрузили последней. Если разработчик правил файл у себя и не перезагрузил его в базу, выгрузка вернёт старый вариант.
Если обработку открывали через «Файл → Открыть»
Обработка, запущенная через Файл → Открыть в режиме «Предприятие», в базе не сохраняется. Платформа читает её с диска при каждом открытии. Сохранить её из пользовательского режима нечем: исходный файл и есть единственная копия. Ищите его там, откуда открывали, — путь виден в списке недавних файлов меню «Файл» в главном меню программы.
Временные копии и кэш: где обработка лежит «сама»
Автосохранения внешней обработки в смысле Word у 1С нет. Пока вы не нажали Ctrl+S, правки в Конфигураторе живут только в памяти. Закрыли окно с ответом «Нет» или Конфигуратор аварийно завершился — правки потеряны.
Что происходит с файлами за кадром:
- 🗂 Дополнительные обработки хранятся в базе как двоичные данные. При запуске платформа передаёт их на сервер и подключает. Отдельного файла на диске пользователя для повторного использования нет.
- 💾 Пользовательские настройки формы обработки (размеры, сохранённые значения реквизитов) пишутся в хранилище настроек базы, а не в
.epf. Поэтому после переноса файла в другую базу настройки не переедут. - 🧹 Кэш платформы в
%APPDATA%\1C\1cv8и%LOCALAPPDATA%\1C\1cv8хранит метаданные конфигурации. Внешнюю обработку как архив изменений он не хранит, искать там потерянную версию бесполезно.
Почему не видно правок после пересохранения
Типичная ситуация: разработчик поправил модуль, сохранил .epf, а пользователь в уже открытом сеансе видит старое поведение.
- Закройте форму обработки полностью и откройте файл заново через
Файл → Открыть. - Если обработка дополнительная — перезагрузите файл в карточку справочника и запишите карточку. Пока этого не сделано, база работает со старой копией.
- Если не помогло — перезапустите сеанс 1С. В крайнем случае запустите клиент с параметром
/ClearCache. Сброс кэша касается только этого пользователя, но при запуске с ним старт займёт больше времени.
Привычка, которая спасает от потери кода: храните рабочие файлы в папке с версиями (Имя_2026-10-07.epf) или в Git в разобранном виде. Резервная копия базы не поможет, если обработка жила только во внешнем файле.
Совместимость с версиями платформы и другими базами
Файл сохранился, но на другом компьютере или в другой базе не открывается. Причин немного, и каждая проверяется за пару минут.
Разбор обработки в XML и обратная сборка
Для хранения в Git и сравнения версий .epf раскладывают на текстовые файлы. Конфигуратор делает это из командной строки:
"C:\Program Files\1cv8\8.3.24.1586\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /DumpExternalDataProcessorOrReportToFiles "D:\src\ZagruzkaCen.xml" "D:\epf\ZagruzkaCen.epf"
"C:\Program Files\1cv8\8.3.24.1586\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /LoadExternalDataProcessorOrReportFromFiles "D:\src\ZagruzkaCen.xml" "D:\epf\ZagruzkaCen.epf"
Первая команда разбирает файл в XML, вторая собирает .epf обратно. Номер платформы в пути подставьте свой: посмотреть его можно в Справка → О программе. Если к базе нужен логин, добавьте параметры /N и /P с именем и паролем пользователя.
Собранный из XML файл получает формат той платформы, которой его собирали. Это удобный способ «понизить» обработку для коллеги со старой версией, если в ней нет возможностей, появившихся позже.
Безопасность сохранённых обработок
Внешняя обработка выполняется с правами пользователя, который её открыл. У администратора она может читать, менять и удалять любые данные базы. Поэтому вопрос, где лежит файл и кто его правил, важнее, чем кажется.
Кто может открывать файлы
- 🔐 Право «Интерактивное открытие внешних обработок» (и аналогичное для отчётов) выдаётся ролью. Рядовым бухгалтерам его обычно не дают: они пользуются только проверенными дополнительными обработками из справочника.
- 🛡 Защита от опасных действий показывает предупреждение перед открытием внешнего файла. Отключать её всем пользователям ради удобства — плохая идея.
- 🧪 Дополнительные обработки, подключённые через справочник, могут работать в безопасном режиме. Тогда код не получит доступ к файловой системе и внешним компонентам без явного разрешения.
Можно ли закрыть код обработки
Встроенного пароля на файл .epf нет. Любой, кто откроет его в Конфигураторе, увидит модуль и формы. Для коммерческих разработок используют сторонние средства защиты кода, но для внутренних задач обычно хватает правил:
- Храните рабочие версии в закрытой сетевой папке с правами только для разработчиков.
- Обработки для пользователей загружайте в справочник дополнительных обработок, а файл с диска пользователей убирайте.
- Чужой
.epfиз интернета перед запуском откройте в Конфигураторе и просмотрите модуль: ищите удаление объектов, запись файлов, обращение к внешним адресам.
Незнакомую обработку запускайте сначала на копии базы. Групповое удаление или перепроведение документов, запущенное по ошибке в рабочей базе, без резервной копии не откатить.
Частые вопросы
Можно ли сохранить обработку из 1С без Конфигуратора?
Сохранится ли обработка, если обновить конфигурацию?
.epf обновление не затрагивает. Но после обновления он может перестать работать, если в конфигурации переименовали реквизиты или процедуры, на которые он ссылается.Как сохранить отчёт, а не обработку?
.erf, а для встроенного отчёта есть та же команда контекстного меню «Сохранить как внешнюю обработку, отчет…».