Как выгрузить обработку из конфигурации 1С

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

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

Ниже разобраны подготовка, пошаговая выгрузка через конфигуратор, альтернативные способы, проверка результата и типичные ошибки.

Что нужно подготовить перед выгрузкой

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

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

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

Выгрузка обработки через конфигуратор

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

В дереве конфигурации раскройте ветку «Обработки». Найдите нужный объект, щёлкните по нему правой кнопкой мыши и выберите пункт «Сохранить как внешнюю обработку, отчёт…». В появившемся диалоге укажите папку и имя файла, затем нажмите «Сохранить».

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

1. 1
   Запустите конфигуратор нужной информационной базы
2. 2
   Откройте конфигурацию: меню «Конфигурация → Открыть конфигурацию»
3. 3
   В дереве объектов раскройте ветку «Обработки» и найдите нужную
4. 4
   Щёлкните правой кнопкой и выберите «Сохранить как внешнюю обработку, отчёт…»
5. 5
   Укажите папку и имя файла, нажмите «Сохранить»
6. 6
   Проверьте, что файл .epf появился в указанной папке

Альтернативные способы получить обработку

Через пункт «Сохранить копию» в открытой обработке

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

Выгрузка через пакетный режим конфигуратора

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

Сравнение вариантов

Через дерево конфигурации

Универсальный способ: подходит для любой обработки, не требует открывать объект. Ограничение — нужен доступ к конфигуратору.

«Сохранить копию» из открытого объекта

Удобно при редактировании: сохраняет текущее состояние с учётом несохранённых правок. Не подходит для массовой выгрузки.

Пакетный режим командной строки

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

Как проверить, что выгрузка прошла успешно

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

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

Дополнительно можно открыть файл в конфигураторе через «Файл → Открыть» и убедиться, что модуль, формы и макеты на месте. Это важно, если обработка будет дорабатываться вне исходной базы.

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

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

Наличие и размер файла

Норма

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

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

Файл отсутствует или имеет нулевой размер

Открытие в режиме «Предприятие»

Норма

Обработка запускается, форма отображается

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

Ошибка открытия или сообщение о повреждении файла

Состав объекта в конфигураторе

Норма

Модуль, формы и макеты доступны для просмотра

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

Часть содержимого отсутствует или не открывается

Ограничения и риски при переносе обработки

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

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

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

Типичные ошибки и как их избежать

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

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

Третья проблема — путаница между .epf и .erf: первый формат — внешняя обработка, второй — внешний отчёт. Если случайно выгружен отчёт вместо обработки, файл откроется, но логика работы будет иной. Проверяйте тип объекта в дереве конфигурации перед сохранением.

Что делать с выгруженным файлом дальше

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

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

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

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

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

Чем отличается файл .epf от .erf?

Расширение .epf соответствует внешней обработке, а .erf — внешнему отчёту. Тип определяется объектом, из которого выполняется сохранение: из ветки «Обработки» получится .epf, из ветки «Отчёты» — .erf. Механизм выгрузки при этом одинаковый.

Почему выгруженная обработка не открывается в другой базе?

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

Нужен ли монопольный режим для выгрузки?

Нет. Сохранение объекта во внешний файл — это чтение данных конфигурации, оно не блокирует работу пользователей. Монопольный доступ потребуется только для изменения или удаления обработки из состава конфигурации.

Как выгрузить сразу несколько обработок?

Штатного способа массовой выгрузки через интерфейс нет — объекты сохраняются по одному. Для пакетной выгрузки используют запуск конфигуратора в пакетном режиме из командной строки или выгрузку конфигурации в файлы с последующим извлечением нужных объектов.

Можно ли выгрузить обработку из базы на поддержке без снятия с поддержки?

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