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

Администрирование · 9 мин

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

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

Выгрузка обработки из 1С означает сохранение внешней обработки в файл с расширением .epf (для управляемых и обычных форм на платформе 8.x) или .ert (для устаревшей платформы 7.7). Такой файл можно перенести в другую базу, отправить коллеге, открыть в конфигураторе для доработки или хранить как резервную копию перед обновлением конфигурации.

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

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

Определите, где хранится обработка

Первый шаг — понять, откуда именно нужно выгружать. Внешняя обработка, которую вы открываете через «Файл — Открыть», уже существует в виде отдельного файла .epf на диске: в этом случае выгружать ничего не нужно, достаточно скопировать сам файл. Уточнить путь к нему можно в заголовке окна или через свойства открытого файла.

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

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

Маршрут решения

Как выбрать способ выгрузки

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

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

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

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

Выгрузка обработки, встроенной в конфигурацию

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

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

Выгрузка из справочника «Дополнительные отчеты и обработки»

В конфигурациях на базе библиотеки стандартных подсистем (УТ, ERP, Бухгалтерия, ЗУП и другие) внешние обработки обычно подключаются через справочник «Дополнительные отчеты и обработки». Файл при этом загружается внутрь базы, и исходный .epf на диске может быть утерян.

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

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

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

Проверка выгруженного файла

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

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

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

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

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

Структура обработки загружается без ошибок

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

Сообщение о повреждении или неверном формате файла

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

Форма открывается, основные команды выполняются

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

Ошибки компиляции модуля или отсутствующие объекты метаданных

Размер файла
Норма

Соответствует сложности обработки

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

Аномально маленький размер при сложной логике

Типичные ошибки и ограничения

Частая проблема — попытка открыть внешнюю обработку в базе, где она не работает из-за отсутствия нужных объектов метаданных. Обработка, выгруженная из ERP и обращающаяся к специфическим документам этой конфигурации, не запустится в «Бухгалтерии». Это не ошибка выгрузки, а ограничение переносимости.

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

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

Типичные ошибки
01
Выгрузка обработки из одной конфигурации и попытка запуска в другой без проверки зависимостей — приводит к ошибкам компиляции
02
Работа без резервной копии при замене встроенных объектов конфигурации — изменения необратимы
03
Открытие обработок из непроверенных источников в рабочей базе — риск выполнения вредоносного кода
04
Сохранение файла под именем без версии — позже невозможно понять, какая копия актуальна

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

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

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

FAQ

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

Файл .ert — формат внешних обработок платформы 1С:Предприятие 7.7, а .epf используется в платформе 8.x. Они несовместимы: обработку из 7.7 нельзя открыть в восьмой версии без конвертации и существенной доработки кода.

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

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

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

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

Безопасно ли открывать внешнюю обработку, полученную по почте?

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

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

Штатной массовой выгрузки в файлы .epf в типовых конфигурациях обычно нет. Используйте обработку «Выгрузка и загрузка данных XML» для переноса элементов справочника целиком либо выгружайте каждый элемент по отдельности командой «Выгрузить в файл».

Итог

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

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