Как подключить внешнюю обработку в 1С:Фреш

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

Главное отличие от локальной версии — нельзя просто открыть произвольный файл через меню «Файл → Открыть» и выполнить любой код. Обработка должна пройти автоматическую проверку, работать в безопасном режиме и не использовать запрещённые в облаке механизмы. Ниже разобран полный порядок подключения, требования к файлам и способы обойти типичные ошибки.

Что нужно проверить до загрузки файла

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

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

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

Механизм подключения внешних файлов в типовых конфигурациях реализован через подсистему «Дополнительные отчеты и обработки» библиотеки стандартных подсистем. Если она отключена, пункта для загрузки файла в интерфейсе не будет. Откройте раздел «Администрирование» и найдите группу настроек «Печатные формы, отчеты и обработки» (в некоторых конфигурациях — «Настройки программы» или «Общие настройки»).

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

1. 1
   Откройте Администрирование → Печатные формы, отчеты и обработки
2. 2
   Включите флаг «Дополнительные отчеты и обработки»
3. 3
   Перейдите по ссылке «Дополнительные отчеты и обработки» и нажмите «Добавить из файла»
4. 4
   Выберите файл .epf или .erf на своём компьютере и подтвердите загрузку
5. 5
   Дождитесь результата автоматической проверки безопасности
6. 6
   Укажите размещение: разделы командного интерфейса и, при необходимости, расписание
7. 7
   Нажмите «Записать и закрыть» и проверьте появление команды в указанном разделе

Загрузка файла и проверка безопасности

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

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

При отказе в загрузке сервис выводит причину: какие конструкции кода запрещены. Типичные причины — установка привилегированного режима, использование метода Выполнить или ОценитьВыражение вне допустимого контекста, обращение к COMОбъект, ПодключитьВнешнююКомпоненту, работа с файлами напрямую на сервере. Устранить такие замечания может только разработчик обработки.

Настройка размещения и запуска

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

Для обработок, привязанных к объектам (печатные формы, заполнение табличных частей, создание связанных объектов), вместо разделов указываются типы объектов — например, документ «Реализация товаров и услуг». Тогда команда появится в форме документа: в меню «Печать» или «Заполнить».

Запуск по расписанию

Если обработка поддерживает регламентное выполнение (в её сведениях есть команда с вариантом использования «Вызов серверного метода»), в карточке элемента доступна настройка расписания. Это удобно для регулярных операций: обмена данными, пересчёта итогов, рассылки отчётов. Учитывайте, что в облаке регламентные задания выполняются в рамках ограничений сервиса по длительности и нагрузке.

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

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

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

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

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

Команда в разделе

Норма

Команда видна в подменю «Дополнительные обработки»

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

Команды нет после обновления интерфейса

Запуск

Норма

Обработка открывается и выполняется без сообщения об ошибке

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

Ошибка «в безопасном режиме операция запрещена»

Данные после выполнения

Норма

Изменения соответствуют ожиданиям на контрольном примере

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

Данные не изменились или изменились неверно

Журнал регистрации

Норма

Нет ошибок по сеансу выполнения

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

Записи с уровнем «Ошибка» и текстом исключения

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

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

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

Альтернативы внешним обработкам в облаке

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

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

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

Внешняя обработка (.epf)

Быстро подключить, подходит для разовых операций; ограничение — строгая проверка безопасности и риск несовместимости после обновлений

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

Надёжно для постоянных доработок, переживает обновления; требует разработки и проверки при загрузке в сервис

Типовые механизмы

Групповое изменение реквизитов, универсальный отчёт; безопасны, но покрывают только стандартные сценарии

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

Почему сервис отклоняет файл при загрузке?

Чаще всего код содержит запрещённые в облаке конструкции: привилегированный режим, COM-объекты, внешние компоненты, прямую работу с файловой системой сервера. Текст ошибки указывает конкретное нарушение — передайте его разработчику обработки для исправления.

Можно ли открыть обработку напрямую через «Файл → Открыть»?

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

Кто может подключать внешние обработки?

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

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

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

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

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

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

Риск есть: внешний код получает доступ к данным вашей базы. Проверка сервиса отсекает заведомо опасные конструкции, но не гарантирует корректность бизнес-логики. Используйте файлы от проверенных разработчиков и сначала тестируйте на контрольных примерах.