Администрирование · 10 мин
Как подключить внешнюю обработку в 1С:Фреш
Пошаговая инструкция, как подключить внешнюю обработку в 1С:Фреш: режим сервиса, проверка безопасности, роли, ограничения облака и типичные ошибки подключения.
Внешняя обработка — это файл с расширением .epf, который добавляет в программу функции, не предусмотренные типовой конфигурацией: загрузку данных, специализированные отчёты, печатные формы. В облачном сервисе 1С:Фреш подключение таких файлов отличается от работы в локальной версии: сервис проверяет каждую обработку на безопасность и ограничивает действия, которые могут навредить общей инфраструктуре.
Подключить обработку в 1С:Фреш можно двумя путями: через стандартный механизм «Дополнительные отчеты и обработки» внутри приложения или через менеджер сервиса, если файл предназначен для конкретной области данных. Выбор зависит от того, что делает обработка и откуда она получена. Ниже разобраны оба сценария, условия их применения и проверка результата.
Что нужно проверить до подключения обработки
Не каждая обработка, которая работает в локальной 1С, заработает в облаке. Сервис 1С:Фреш выполняет код в безопасном режиме, поэтому запрещены прямое обращение к файловой системе сервера, запуск внешних приложений, работа с COM-объектами и OLE, загрузка внешних компонентов. Если обработка скачивает курс валют напрямую через HTTP-запрос или сохраняет файл на диск «C:\», она не пройдёт проверку.
Проверьте источник файла. Обработки из официальной библиотеки на портале 1С и от франчайзи, адаптированные под сервис, обычно помечены как совместимые с 1С:Фреш. Если файл получен с форума или написан давно для локальной базы, высока вероятность отказа при загрузке.
Также убедитесь, что у вашей учётной записи есть права. Подключать дополнительные обработки может пользователь с ролью администратора абонента или правами на настройку программы. Обычному пользователю пункт «Дополнительные отчеты и обработки» будет недоступен.
Включение механизма дополнительных отчётов и обработок
По умолчанию в некоторых приложениях сервиса механизм подключения внешних файлов выключен. Откройте раздел «Администрирование» (в разных конфигурациях он может называться «Настройки» или находиться в меню с изображением шестерёнки). Найдите подраздел «Печатные формы, отчеты и обработки».
Установите флажок «Дополнительные отчеты и обработки». После этого в том же подразделе появится одноимённая ссылка — это список всех подключённых файлов. Если флажок недоступен для редактирования, значит, у вас недостаточно прав: обратитесь к владельцу абонента сервиса.
В некоторых приложениях 1С:Фреш рядом есть настройка профилей безопасности. Для типовой работы менять её не требуется — сервис сам определяет разрешённые операции.
- 1Откройте «Администрирование → Печатные формы, отчеты и обработки» и включите флажок «Дополнительные отчеты и обработки»
- 2Перейдите по ссылке «Дополнительные отчеты и обработки» и нажмите «Добавить из файла»
- 3Выберите файл .epf на компьютере и дождитесь проверки безопасности сервиса
- 4В карточке обработки укажите разделы командного интерфейса, где она будет доступна
- 5Нажмите «Записать и закрыть» и проверьте появление команды в выбранном разделе
Загрузка файла обработки и проверка безопасности
В списке дополнительных обработок нажмите «Добавить из файла» (в ряде конфигураций — «Создать → Загрузить из файла»). Укажите файл .epf на локальном компьютере. Сервис начнёт автоматическую проверку: анализируется код модуля на предмет запрещённых операций.
Проверка занимает от нескольких секунд до пары минут. Если обработка совместима, откроется её карточка с заполненными полями: наименование, версия, вид (дополнительная обработка, отчёт, печатная форма, заполнение табличной части). Эти сведения обработка сообщает о себе сама через встроенную функцию регистрации.
Если сервис отклонил файл, появится сообщение с перечнем нарушений — например, «использование небезопасных операций: НайтиФайлы, ЗапуститьПриложение». В этом случае обработку нужно доработать: заменить прямую работу с файлами на передачу данных через диалоги помещения файлов, убрать COM-объекты. Такую доработку выполняет программист 1С.
Настройка размещения и прав доступа
После загрузки откройте карточку обработки и проверьте таблицу «Размещение» — в ней перечислены разделы программы (например, «Покупки», «Склад», «Отчёты»), где появится команда запуска. Если таблица пуста, обработка подключена, но недоступна пользователям: добавьте разделы вручную через ссылку «Размещение» или «Быстрый доступ».
В таблице «Быстрый доступ» укажите, каким пользователям команда видна сразу. Остальные смогут открыть обработку через «Дополнительные обработки» в меню раздела «Ещё», если у них есть соответствующие права. Для печатных форм и обработок заполнения табличных частей вместо разделов задаётся перечень объектов — документов и справочников, к которым привязана команда.
Проверьте результат под учётной записью обычного пользователя: откройте нужный раздел, найдите команду в меню «Дополнительные обработки» и запустите её. Если команда видна и обработка открывается без ошибок — подключение выполнено корректно.
Как проверить результат
Обработка появилась в меню «Дополнительные обработки» выбранного раздела
Команды нет ни у администратора, ни у пользователя — не заполнено размещение
Форма открывается, действия выполняются без сообщений о безопасности
Ошибка «операция не разрешена в безопасном режиме» — код несовместим с сервисом
Статус «Опубликована», поля версии и вида заполнены
Статус отклонена или карточка не сохраняется
Подключение через менеджер сервиса и расширения
Второй сценарий применяется, когда функциональность нужна не как отдельная команда, а как изменение поведения самой конфигурации. В 1С:Фреш для этого используются расширения конфигурации — они подключаются через раздел «Администрирование → Печатные формы, отчеты и обработки → Расширения» либо через личный кабинет абонента в менеджере сервиса, если тариф это позволяет.
Расширение — это файл .cfe, который тоже проходит проверку безопасности. Оно подходит для доработки форм, добавления реквизитов и изменения логики документов, тогда как обработка .epf — для отдельных действий по требованию пользователя. Не пытайтесь решить задачу изменения типовой формы внешней обработкой: она не может перманентно изменить интерфейс.
Что выбрать для задачи
Отдельные команды: загрузка данных, групповые операции, специальные отчёты. Ограничение — не меняет типовые формы и логику
Изменение форм, реквизитов, алгоритмов документов. Ограничение — требует разработки и проверки совместимости при обновлении конфигурации
Готовые решения, уже проверенные для 1С:Фреш. Ограничение — выбор ограничен опубликованным списком
Обновление и удаление подключённых обработок
Когда выходит новая версия обработки, не загружайте её как отдельный элемент — откройте карточку существующей и используйте команду замены файла (обычно «Заменить на внешний файл» или аналогичную). Тогда сохранятся настройки размещения и быстрого доступа, а пользователям не придётся искать команду заново.
Если обработка больше не нужна, не удаляйте её сразу: сначала снимите флажок публикации в карточке, переведя обработку в отключённое состояние. Убедитесь, что ни у кого из пользователей не осталось регламентных заданий, ссылающихся на неё, — иначе задания начнут завершаться с ошибкой. Только после этого удаляйте элемент из списка.
Имейте в виду: при обновлении конфигурации сервисом подключённые обработки сохраняются, но их работоспособность с новой версией стоит проверить, особенно если обработка обращается к реквизитам, которые могли быть переименованы разработчиком конфигурации.
Что важно запомнить
Подключение делается через «Дополнительные отчеты и обработки» с правами администратора, файл обязательно проходит проверку безопасности сервиса, а после загрузки нужно настроить размещение и проверить команду под обычным пользователем. Обработки с прямым доступом к файлам и COM-объектам в облаке работать не будут.
Частые вопросы о подключении обработок в 1С:Фреш
Почему сервис отклоняет мою обработку, которая работает в локальной 1С?
Потому что в облаке код выполняется в безопасном режиме. Запрещены прямое обращение к файловой системе сервера, COM/OLE, запуск приложений и внешние компоненты. Сообщение об отказе содержит список запрещённых операций — по нему программист адаптирует код, например заменяя запись файла на диск передачей через диалог помещения файла.
Можно ли подключить внешнюю печатную форму?
Да, тем же способом через «Дополнительные отчеты и обработки». Отличие в настройке: вместо разделов командного интерфейса указывается перечень документов, для которых форма доступна. После подключения она появится в меню «Печать» этих документов.
Не вижу пункт «Дополнительные отчеты и обработки» в меню. Что делать?
Сначала проверьте, включён ли одноимённый флажок в «Администрирование → Печатные формы, отчеты и обработки». Если самого пункта настроек нет — у вашей учётной записи недостаточно прав, и подключение должен выполнить администратор абонента.
Опасно ли подключать обработки к рабочей базе?
Обработка выполняется с правами запустившего её пользователя, поэтому потенциально она может изменить любые доступные ему данные. Подключайте только файлы из доверенных источников, а новую обработку сначала опробуйте на копии области данных или на тестовом приложении, если оно доступно в вашем тарифе.
Чем обработка отличается от расширения конфигурации?
Обработка — это отдельная команда, которую пользователь запускает вручную; она не меняет типовые формы и алгоритмы. Расширение (.cfe) встраивается в конфигурацию и может изменять формы, реквизиты и логику документов, но требует разработки и контроля совместимости при обновлениях.
Пропадёт ли обработка при обновлении конфигурации в сервисе?
Нет, подключённые обработки сохраняются при обновлениях. Однако после обновления стоит проверить её работу: если разработчик конфигурации переименовал или удалил объекты, к которым обращается обработка, она начнёт выдавать ошибки, и файл придётся доработать.