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

Другое · 6 мин

Выгрузка внешней обработки из 1С: пошаговая инструкция

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

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

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

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

Определите, что именно нужно выгрузить

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

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

Подготовка и права доступа

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

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

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

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

Откройте конфигурацию в режиме Конфигуратора, найдите в дереве объект «Внешние обработки» и разверните его. Выберите нужную обработку, откройте контекстное меню или главное меню и найдите команду сохранения объекта в файл. Укажите папку и имя файла с расширением .epf, затем подтвердите сохранение.

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

Сохранение из режима предприятия

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

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

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

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

Файл .epf создан и имеет ненулевой размер
Норма

Файл открывается в 1С и подключается к базе

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

Файл не открывается или не виден в списке внешних обработок

Формы и команды обработки работают
Норма

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

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

Ошибки отсутствующих объектов или модулей

Проверка файла и перенос на другую базу

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

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

Типичные ошибки
01
Попытка сохранить встроенную обработку как внешнюю — файл не работает на другой базе
02
Копирование файлов базы вручную вместо использования команды сохранения в .epf
03
Выгрузка без резервной копии — при ошибке можно повредить конфигурацию

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

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

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

Итог

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

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

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

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

Что делать, если файл .epf не открывается на другой базе?

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

Нужно ли выгружать всю конфигурацию, чтобы получить одну обработку?

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

Безопасно ли редактировать выгруженный файл .epf вручную?

Не рекомендуется. Редактирование файла вне 1С может повредить его структуру. Внесите изменения в Конфигураторе и снова сохраните объект в файл.