Выгрузка обработки, отчёта и печатной формы из базы 1С в отдельный файл

Сохранить обработку 1С в файл можно двумя путями. Встроенную в конфигурацию обработку выгружают в Конфигураторе: правой кнопкой по объекту в дереве → Сохранить как внешнюю обработку, отчет..., на выходе файл .epf (для отчёта — .erf). Дополнительную обработку, подключённую через справочник, выгружают в режиме Предприятия: откройте её карточку в списке дополнительных отчётов и обработок и выполните команду «Выгрузить в файл…».

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

Какие файлы получаются и чем они отличаются

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

Практические выводы:

• 📦 Для переноса одной доработки в другую базу нужен .epf или .erf, а не .cf и тем более не .dt.
• 🖨️ Внешняя печатная форма — это тот же .epf, только зарегистрированный в базе с видом «Печатная форма».
• 🧩 Если доработку делали расширением, одну обработку из него в .epf не выгружают — переносят расширение целиком файлом .cfe.
• 📄 Макет без кода сохраняется в .mxl. Такой файл не подключается как обработка, его загружают в макет вручную.

Выгрузка дополнительной обработки в режиме Предприятия

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

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

Пошагово

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

Файл получится ровно таким, каким его загрузили в последний раз. Если после загрузки код меняли в Конфигураторе и снова загружали — выгрузится последняя версия .

Когда в карточке нет нужной команды

• 🔒 Не хватает прав — попросите администратора базы выгрузить файл.
• 🗂️ Объект подключён не через справочник, а открывался вручную через Файл → Открыть. Тогда в базе его просто нет: файл лежит у того, кто его открывал.
• 🏗️ Это нетиповая или сильно изменённая конфигурация без БСП. Механизм дополнительных обработок там может отсутствовать — остаётся Конфигуратор.

Сохранение обработки из Конфигуратора

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

Встроенную обработку — во внешний файл

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

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

Внешнюю обработку после правки

1. Файл → Открыть, выберите .epf или .erf.
2. Внесите изменения в форму, модуль или макет.
3. Файл → Сохранить или Ctrl+S — перезапишет исходный файл.
4. Чтобы оставить старую версию нетронутой, используйте Файл → Сохранить как и дайте новое имя, например ПечатьАкта_v2.epf.

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

Чем встроенная отличается от внешней после выгрузки

Выгруженная из конфигурации обработка сохраняет ссылки на общие модули, справочники и документы своей базы. В другой конфигурации она откроется, но упадёт там, где обращается к отсутствующим объектам. Перед переносом пройдитесь по модулю поиском: вызовы вида ОбщийМодульИмя.Процедура() и типы СправочникСсылка.Xxx должны существовать в целевой базе.

Макеты и изменённые печатные формы

Печатные формы в 1С живут в трёх местах, и сохраняются они по-разному.

Изменённый макет в пользовательском режиме

В конфигурациях на БСП список макетов открывается так: Администрирование → Печатные формы, отчеты и обработки → Макеты печатных форм. Изменённые пользователем макеты отмечены в списке отдельным значком.

Чтобы унести такой макет в другую базу:

1. Откройте макет на редактирование.
2. Сохраните табличный документ в файл .mxl (кнопка с дискетой или команда сохранения в меню «Ещё»).
3. В целевой базе откройте тот же макет, откройте файл .mxl и скопируйте содержимое в макет целиком, через выделение всех ячеек.

Готовую печатную форму — в файл

Иногда под «сохранить печатную форму» имеют в виду не шаблон, а сформированный документ. В окне печати нажмите кнопку «Сохранить» (значок дискеты), выберите формат: .pdf, .xlsx, .docx, .mxl или .odt. Там же можно сразу приложить файл к документу базы.

Выгрузка обработок программно и пакетно

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

Код на встроенном языке

В БСП файл обработки хранится в реквизите ХранилищеОбработки справочника ДополнительныеОтчетыИОбработки. Серверная процедура выгружает все действующие обработки в папку на сервере:

&НаСервереБезКонтекста
Процедура ВыгрузитьВсеОбработки(Каталог)

    Запрос = Новый Запрос;
    Запрос.Текст =
    "ВЫБРАТЬ
    |    Обработки.Ссылка КАК Ссылка,
    |    Обработки.ИмяФайла КАК ИмяФайла
    |ИЗ
    |    Справочник.ДополнительныеОтчетыИОбработки КАК Обработки
    |ГДЕ
    |    НЕ Обработки.ПометкаУдаления";

    Выборка = Запрос.Выполнить().Выбрать();
    Пока Выборка.Следующий() Цикл
        Данные = Выборка.Ссылка.ХранилищеОбработки.Получить();
        Если ТипЗнч(Данные) <> Тип("ДвоичныеДанные") Тогда
            Продолжить;
        КонецЕсли;
        ИмяФайла = Выборка.ИмяФайла;
        Если ПустаяСтрока(ИмяФайла) Тогда
            ИмяФайла = Строка(Выборка.Ссылка.УникальныйИдентификатор()) + ".epf";
        КонецЕсли;
        Данные.Записать(Каталог + ПолучитьРазделительПути() + ИмяФайла);
    КонецЦикла;

КонецПроцедуры

Что учесть:

• 🖥️ Код выполняется на сервере. В клиент-серверной базе файлы появятся в папке на сервере 1С, а не на вашем компьютере. Пользователю службы сервера нужны права на запись в эту папку.
• 📥 Чтобы отдать файл пользователю на клиент, поместите двоичные данные во временное хранилище (ПоместитьВоВременноеХранилище) и вызовите на клиенте ФайловаяСистемаКлиент.СохранитьФайл из БСП.
• 📛 Если у двух обработок одинаковое имя файла, вторая перезапишет первую. Для архива добавьте к имени код или дату.
• 🛡️ Запускайте такой код из внешней обработки под администратором. В базе с включённой защитой от опасных действий платформа сначала спросит подтверждение.

Пакетный режим Конфигуратора

Платформа умеет разбирать .epf на XML-файлы и собирать обратно. Это нужно для хранения обработок в Git и для сравнения версий:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F"D:\Bases\Empty" /DumpExternalDataProcessorOrReportToFiles "D:\src\ПечатьАкта.xml" "D:\epf\ПечатьАкта.epf" /Out "D:\log.txt"

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F"D:\Bases\Empty" /LoadExternalDataProcessorOrReportFromFiles "D:\src\ПечатьАкта.xml" "D:\epf\ПечатьАкта.epf" /Out "D:\log.txt"

Первая команда выгружает обработку в исходники, вторая собирает .epf из исходников. Номер версии в пути замените на установленный у вас. Для запуска нужна любая информационная база в параметре /F — подойдёт пустая файловая. Результат и ошибки смотрите в файле из /Out.

Что проверить перед переносом файла в другую базу

Файл сохранён — это половина дела. Вторая половина — чтобы он открылся у получателя.

Почему обработка не сохраняется или не открывается

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