Разработка и Конфигурация · 10 мин
Как выгрузить внешнюю обработку из 1С
Как выгрузить внешнюю обработку из 1С в файл EPF: через конфигуратор, расширение и из базы. Проверка результата, типичные ошибки и ответы на вопросы.
Внешняя обработка в 1С — это файл с расширением EPF (для управляемого и обычного приложения) или ERF (для внешнего отчёта), который работает без изменения конфигурации базы. Выгрузить её нужно в разных ситуациях: передать коллеге, сохранить резервную копию, перенести в другую базу или доработать в конфигураторе. Способ выгрузки зависит от того, где обработка находится: отдельным файлом на диске, в справочнике дополнительных отчётов и обработок или встроена в конфигурацию.
Разница принципиальная. Если обработка уже лежит файлом — выгружать ничего не нужно, достаточно скопировать файл. Если она подключена через механизм «Дополнительные отчеты и обработки» (БСП), файл хранится внутри базы в виде двоичных данных, и его нужно извлечь. Если же функциональность встроена в конфигурацию как обычная обработка, потребуется конфигуратор и права разработчика.
Ниже разобраны все три сценария с точными действиями, проверкой результата и типичными ошибками. Инструкции применимы к платформе 1С:Предприятие 8.3 и типовым конфигурациям на её основе.
Определите, где находится обработка
Перед выгрузкой выясните, каким способом обработка подключена к системе. От этого зависит весь порядок действий. Есть три типичных варианта: обработка запускается через «Файл — Открыть» и хранится на диске или сетевом ресурсе; она зарегистрирована в справочнике «Дополнительные отчеты и обработки»; она является частью конфигурации и видна в дереве объектов конфигуратора.
Быстрый способ проверить: откройте раздел «Администрирование» (или «НСИ и администрирование») и найдите пункт «Печатные формы, отчеты и обработки», затем «Дополнительные отчеты и обработки». Если нужная обработка есть в списке — это второй сценарий. Если её там нет, но она вызывается из меню конфигурации — скорее всего, она встроена в конфигурацию.
Как выбрать способ выгрузки
Выгрузка из справочника «Дополнительные отчеты и обработки»
Это самый частый сценарий в типовых конфигурациях на базе БСП (Библиотека стандартных подсистем): «Управление торговлей», «ERP», «Комплексная автоматизация», «Бухгалтерия предприятия». Файл обработки хранится внутри информационной базы как присоединённый файл, и задача — извлечь его обратно на диск.
- 1Откройте раздел «Администрирование» — «Печатные формы, отчеты и обработки»
- 2Перейдите в «Дополнительные отчеты и обработки» и найдите нужную обработку в списке
- 3Откройте элемент двойным щелчком
- 4Найдите команду «Выгрузить в файл» (обычно в меню «Ещё» или рядом с полем хранения файла)
- 5Укажите папку и имя файла, сохраните
- 6Проверьте, что файл появился на диске и имеет расширение EPF или ERF
В некоторых конфигурациях команда называется иначе: «Сохранить файл обработки», «Сохранить как» или доступна по кнопке с иконкой дискеты рядом с реквизитом, где указано имя загруженного файла. Если команда не видна, проверьте права: выгрузка обычно доступна пользователям с ролью администратора или с правом добавления и изменения дополнительных отчётов и обработок.
После сохранения откройте полученный файл через «Файл — Открыть» в режиме 1С:Предприятие и убедитесь, что обработка запускается. Это гарантирует, что выгружен рабочий файл, а не пустышка или повреждённые данные.
Выгрузка обработки из конфигурации через конфигуратор
Если нужная функциональность встроена в конфигурацию как объект «Обработка», её можно сохранить как внешнюю. Для этого потребуется запуск конфигуратора и права на просмотр конфигурации. Учтите: если обработка использует общие модули, запросы к данным или формы, завязанные на конфигурацию, после выгрузки она может работать некорректно — внешняя обработка не имеет доступа к общим модулям конфигурации напрямую из своего контекста, хотя вызовы серверных методов через метаданные обычно сохраняются.
Порядок действий: запустите конфигуратор, откройте конфигурацию («Конфигурация — Открыть конфигурацию»), в дереве объектов найдите ветку «Обработки» и нужный объект. Кликните по нему правой кнопкой мыши и выберите «Сохранить как внешнюю обработку» (в ряде версий платформы — «Сохранить как внешнюю обработку, отчет»). Укажите путь и имя файла.
Аналогично выгружаются внешние отчёты из ветки «Отчеты» — результатом будет файл ERF. Если конфигурация закрыта паролем или поставлена без исходных текстов (поставка без исходных кодов модулей), команда сохранения может быть недоступна или модуль формы окажется пустым — это ограничение поставки, обойти его штатными средствами нельзя.
Выгрузка обработки из расширения конфигурации
Всё чаще доработки выполняются через расширения. Обработка может находиться внутри расширения, и тогда в дереве основной конфигурации её не будет. Откройте в конфигураторе «Конфигурация — Расширения конфигурации», найдите нужное расширение и откройте его двойным щелчком.
В дереве расширения перейдите к ветке «Обработки», найдите объект и через правый клик сохраните его как внешнюю обработку — механизм идентичен выгрузке из основной конфигурации. Обратите внимание: если обработка заимствована из основной конфигурации и изменена в расширении, выгруженный файл будет содержать версию расширения, а не исходную.
Как проверить результат выгрузки
Формальное наличие файла на диске ещё не означает успех. Проверьте три вещи: размер файла (подозрительно маленький файл в несколько килобайт для сложной обработки — повод насторожиться), возможность открытия в режиме 1С:Предприятие через «Файл — Открыть» и корректную работу основных функций.
Дополнительная проверка — открыть файл в конфигураторе («Файл — Открыть») и убедиться, что модуль объекта и формы содержат код, а не пусты. Если обработка поставлялась без исходного кода, модуль будет недоступен — это нормально для такой поставки, но доработать её уже не получится.
Как проверить результат
Файл с расширением EPF или ERF, размер соответствует сложности обработки
Файл нулевого размера или не открывается
Обработка открывается через Файл — Открыть и выполняет свои функции
Ошибка при открытии или при выполнении команд
Формы и модули присутствуют и содержат код
Модули пусты при открытой поставке — выгружен не тот объект
Типичные ошибки и ограничения
Отдельно стоит ограничение по безопасности: при открытии внешних обработок платформа может показывать предупреждение о безопасности, если включён соответствующий режим. Это нормальное поведение, а не признак повреждения файла. Не отключайте защиту от опасных действий глобально ради одной обработки — открывайте файлы только из доверенных источников.
Ещё одна частая ситуация: обработка выгружена, но в другой базе не запускается из-за обращений к объектам, которых там нет (например, к документам или регистрам, отсутствующим в целевой конфигурации). Перед переносом сверьте состав метаданных обеих баз или запрашивайте у автора версию, адаптированную под целевую конфигурацию.
Заведите правило: при каждом обновлении дополнительной обработки в базе сразу выгружайте файл в архивную папку с датой в имени. Это займёт полминуты, но позволит откатиться на предыдущую версию, если новая окажется с ошибкой.
Частые вопросы
Чем отличается файл EPF от ERF?
EPF — это внешняя обработка, ERF — внешний отчёт. Технически форматы близки, но тип объекта разный: отчёты строятся на схеме компоновки данных и предназначены для вывода данных, обработки — для выполнения действий. Файл одного типа нельзя просто переименовать в другой — объект внутри сохраняет исходный тип.
Можно ли выгрузить обработку без прав администратора?
Из справочника «Дополнительные отчеты и обработки» — только если ваша роль разрешает работу с этим справочником и выгрузку файлов. Из конфигуратора — если у пользователя есть право на запуск конфигуратора и просмотр конфигурации. Если прав нет, обратитесь к администратору базы.
Выгруженный файл не открывается: «Ошибка формата». Что делать?
Чаще всего файл повреждён при передаче (например, почтовый клиент изменил вложение) или выгрузка завершилась с ошибкой. Повторите выгрузку заново, передайте файл в архиве ZIP и проверьте, что версия платформы, в которой открывают файл, не старше той, где он был создан.
Как выгрузить обработку, если база файловая и конфигуратор недоступен?
Если обработка подключена через «Дополнительные отчеты и обработки», конфигуратор не нужен — выгрузка выполняется прямо из режима 1С:Предприятие через команду сохранения файла в элементе справочника. Конфигуратор требуется только для объектов, встроенных в конфигурацию или расширение.
Можно ли выгрузить все дополнительные обработки сразу?
Штатной групповой выгрузки в типовых конфигурациях, как правило, нет — файлы сохраняются по одному из каждого элемента справочника. Для массового извлечения используют специализированные сервисные обработки, которые читают присоединённые файлы и сохраняют их в указанный каталог, либо выгружают базу целиком в DT для полного архива.
Безопасно ли открывать EPF-файл, полученный извне?
Внешняя обработка — это исполняемый код, который имеет доступ к данным базы. Открывайте файлы только из источников, которым доверяете, не отключайте защиту от опасных действий и по возможности сначала запускайте файл в копии базы, а не в рабочей.
Что важно запомнить
Способ выгрузки зависит от места хранения: из справочника «Дополнительные отчеты и обработки» файл сохраняется прямо из режима предприятия, из конфигурации и расширения — через конфигуратор командой «Сохранить как внешнюю обработку». Всегда проверяйте выгруженный файл запуском и храните версии с датами для возможности отката.