Как загрузить внешнюю обработку в 1С

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

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

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

Что такое внешняя обработка и когда она нужна

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

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

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

Как открыть внешнюю обработку для разового запуска

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

1. 1
   Запустите информационную базу в режиме «1С:Предприятие» под пользователем с достаточными правами.
2. 2
   Откройте главное меню и выберите «Файл → Открыть» или нажмите Ctrl+O.
3. 3
   Укажите путь к EPF-файлу и подтвердите открытие.
4. 4
   Если появится предупреждение системы безопасности, проверьте источник файла и нажмите «Да» для запуска.
5. 5
   Проверьте, что форма обработки открылась и выполняет нужные действия.

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

Учтите, что при таком способе обработка нигде не сохраняется внутри базы: после закрытия окна её нужно будет открывать заново. Для регулярной работы это неудобно, поэтому используется второй способ — подключение.

Как включить механизм дополнительных отчетов и обработок

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

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

Как подключить обработку через справочник дополнительных обработок

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

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

После записи обработка появится в выбранных разделах: в подменю «Дополнительные обработки», «Печать» или «Заполнение» в зависимости от её вида. Проверьте результат под обычным пользователем, а не только под администратором — права на запуск дополнительных обработок настраиваются отдельно.

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

Как проверить результат подключения

Обработка в списке

Норма

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

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

Запись не сохраняется или появляется сообщение о несовместимости

Доступность в интерфейсе

Норма

Команда видна в указанных разделах и формах объектов

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

Команды нет — не заполнено размещение или не хватает прав у пользователя

Запуск

Норма

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

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

Ошибки обращения к метаданным — обработка не подходит к этой конфигурации

Безопасность и профили безопасности

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

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

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

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

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

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

Альтернативы: расширения конфигурации

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

Что выбрать

Разовое открытие файла

Подходит для теста и разовых операций; не требует настройки, но обработка не сохраняется в базе.

Дополнительные отчеты и обработки

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

Расширение конфигурации

Для глубокой доработки интерфейса и логики без снятия с поддержки; требует навыков разработки и тестирования при обновлениях.

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

Можно ли загрузить внешнюю обработку в 1С:Фреш (облако)?

Да, но только через механизм дополнительных отчетов и обработок и только если обработка проходит проверку безопасности сервиса: она должна работать в безопасном режиме, без доступа к файловой системе и внешним компонентам. Прямое открытие файла через «Файл → Открыть» в облачном сервисе недоступно.

Почему при открытии файла появляется сообщение «Нарушение целостности файла»?

Файл поврежден при скачивании или передаче, либо это не EPF-файл (например, переименованный архив или XML-выгрузка). Скачайте файл заново из источника и проверьте его расширение и размер.

Обработка требует отключить безопасный режим — это нормально?

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

Как обновить уже подключенную обработку новой версией?

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

Почему обработку видит администратор, а обычный пользователь — нет?

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

Можно ли запускать внешнюю обработку автоматически по расписанию?

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