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

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

Как сохранить обработку 1С в файл

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

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

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

Что такое файл обработки и где он хранится

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

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

Сохранение открытой внешней обработки

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

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

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

При выборе имени файла используйте понятное название с версией или датой, например «ЗагрузкаПрайсов_v2.epf». Это избавит от путаницы, когда копий обработки станет несколько.

Сохранение обработки, встроенной в конфигурацию

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

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

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

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

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

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

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

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

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

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

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

Файл появился в папке
Норма

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

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

Файл отсутствует или размер 0 байт — сохранение не выполнено

Файл открывается
Норма

Через «Файл — Открыть» в 1С обработка запускается без ошибок

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

Ошибка формата потока или «файл не является внешней обработкой»

Код на месте
Норма

В конфигураторе модуль обработки содержит ваш код

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

Модуль пуст — сохранена пустая форма без кода

Версия соответствует
Норма

Открывается именно та версия, что вы правили

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

Открывается старая версия — перепутан файл или папка

Дополнительно сравните размер нового файла с предыдущей версией: резкое уменьшение размера при неизменной функциональности — повод проверить, все ли макеты и формы попали в копию.

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

Типичные ошибки
01
Сохранение в формате ERF вместо EPF: в диалоге «Сохранить как» выбран тип «Внешний отчет» — файл не откроется как обработка. Проверяйте тип файла в диалоге
02
Попытка найти файл обработки, подключенной через БСП, в папке с базой: файл хранится внутри базы, выгружать нужно командой «Выгрузить в файл»
03
Сохранение под тем же именем в ту же папку при открытом файле: платформа может удерживать файл, что приводит к ошибке доступа. Закройте обработку перед перезаписью
04
Передача обработки без проверки совместимости: обработка для обычного приложения может не работать в тонком или веб-клиенте
05
Забытые внешние зависимости: обработка использует общие модули или картинки конфигурации и не запускается в другой базе

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

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

Файл — Сохранить как в конфигураторе

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

Сохранить копию из дерева конфигурации

Для встроенных обработок. Создает внешнюю копию, сам объект остается в метаданных

Выгрузить в файл из справочника БСП

Для обработок, подключенных через «Дополнительные отчеты и обработки». Не требует конфигуратора, нужны права

Копирование файла средствами ОС

Самый быстрый способ, если исходный EPF-файл уже лежит на диске и не изменялся

Передача файла и хранение версий

Файл EPF передается как обычный вложение: по почте, через мессенджер или общий сетевой каталог. Некоторые почтовые сервисы блокируют исполняемые вложения — в этом случае упакуйте файл в ZIP-архив.

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

Итог

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

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

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

Какое расширение должно быть у файла обработки 1С?

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

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

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

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

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

Что делать, если при сохранении возникает ошибка доступа к файлу?

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

Как сохранить обработку, защищенную паролем?

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

Чем отличается выгрузка в XML от сохранения в EPF?

EPF — исполняемый бинарный формат, готовый к запуску в платформе. XML-выгрузка (через конфигуратор или EDT) — текстовое представление исходного кода, форм и макетов, удобное для контроля версий и сравнения изменений, но не запускаемое напрямую. Для передачи готовой обработки используйте EPF, для хранения исходников — XML.