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