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

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

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

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

Что нужно подготовить перед подключением

Основной объект подключения — файл расширения с расширением .cfe. Его получают из конфигуратора локальной базы: открывают ветку «Конфигурация → Расширения конфигурации», создают или дорабатывают расширение и сохраняют его в файл через пункт «Сохранить в файл». Версия платформы и конфигурации, на которой готовился файл, должна быть совместима с версией, развёрнутой в вашем абонентском приложении 1С:Фреш, иначе при загрузке появится ошибка несовместимости.

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

Способ 1: подключение через менеджер сервиса

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

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

1. 1
   Войдите в менеджер сервиса под учётной записью владельца или администратора абонента
2. 2
   Откройте карточку нужного приложения и перейдите в раздел «Расширения»
3. 3
   Нажмите «Добавить» и выберите файл .cfe на компьютере
4. 4
   Дождитесь завершения автоматической проверки безопасности
5. 5
   Убедитесь, что расширение получило статус «Подключено», и проверьте его работу в приложении

Способ 2: дополнительные отчёты и обработки внутри приложения

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

После включения в том же разделе появляется ссылка «Дополнительные отчеты и обработки», через которую загружаются файлы .erf (отчёты) и .epf (обработки), а также подключаются обработки из официального каталога. Этот путь проще и безопаснее: такие файлы работают в строго ограниченном безопасном режиме и не требуют прав администратора сервиса. Однако они не умеют изменять формы документов, добавлять реквизиты и подсистемы — для этого нужно именно расширение.

Что выбрать для доработки

Расширение конфигурации (.cfe)

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

Дополнительные отчёты и обработки (.erf/.epf)

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

Обработки из каталога 1С

Готовые проверенные решения, подключаются в пару кликов. Ограничены ассортиментом каталога, не подходят для индивидуальных доработок.

Проверка безопасности и причины отказа

Автоматическая проверка 1С:Фреш отклоняет расширения, которые потенциально опасны для облачной инфраструктуры или нарушают изоляцию абонентов. К типичным причинам отказа относятся: обращение к файловой системе сервера, использование COM-объектов и OLE, запуск внешних приложений, подключение внешних компонентов, попытка выполнить произвольный код через «Выполнить» и «Вычислить», а также изменение состава ролей, влияющих на права доступа к чужим данным.

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

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

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

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

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

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

Статус расширения в менеджере сервиса

Норма

«Подключено», ошибок проверки нет

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

«Отклонено» или «Ошибка» — читайте протокол проверки

Новые объекты в интерфейсе

Норма

Печатные формы, отчёты или элементы форм появились и работают

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

Объекты не видны — проверьте права и роли расширения

Типовые операции

Норма

Проведение документов и отчёты работают как раньше

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

Ошибки при проведении — расширение конфликтует с конфигурацией, отключите его

Обновление, отключение и удаление расширения

При выходе новой версии доработки порядок действий тот же: сохраните обновлённый файл .cfe из конфигуратора и загрузите его в менеджере сервиса поверх существующего расширения — сервис заменит версию после повторной проверки. Учтите, что при обновлении самой конфигурации 1С:Фреш расширение может временно отключиться, если оно несовместимо с новой версией: тогда его нужно адаптировать и загрузить заново.

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

FAQ

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

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

Почему сервис отклонил моё расширение?

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

Расширение подключится для всех пользователей сразу?

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

Что будет с расширением при обновлении конфигурации в облаке?

Если расширение совместимо с новой версией — оно продолжит работать. При несовместимости сервис может отключить его автоматически: тогда доработку нужно адаптировать в конфигураторе под новую версию и загрузить заново.

Чем расширение лучше внешней обработки?

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

Можно ли вернуть всё как было после удаления расширения?

Да, после удаления расширения конфигурация возвращается к типовому поведению. Однако данные, сохранённые в реквизитах, которые добавляло расширение, станут недоступны — при необходимости выгрузите их заранее.