Как загрузить расширение в 1С:Фреш

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

Главное отличие Фреша — ограничения безопасного режима. Сервис не пропустит расширение, которое пытается обратиться к файловой системе, внешним компонентам, COM-объектам или выполнить произвольный код в привилегированном режиме без ограничений. Поэтому перед загрузкой расширение нужно подготовить: убедиться, что оно разработано с учётом требований сервиса 1С:Фреш.

Ниже разобраны два рабочих способа загрузки (через «Менеджер сервиса» для абонентов и через «Настройки расширений» внутри приложения), требования к файлу расширения, порядок проверки результата и типичные ошибки, из-за которых сервис отклоняет загрузку.

Что нужно подготовить перед загрузкой расширения

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

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

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

Требования сервиса 1С:Фреш к расширениям

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

Основные ограничения безопасного режима Фреша:

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

Если расширение разрабатывается специально под Фреш, разработчик должен включить в свойствах расширения признак «Использовать в основных ролях» корректно, установить безопасный режим и задать параметр «Безопасный режим» в свойствах. Также рекомендуется заполнить имя, синоним и версию расширения — эти данные отображаются в списке подключённых расширений.

Способ 1: загрузка через Менеджер сервиса

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

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

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

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

Способ 2: загрузка внутри приложения 1С

Во многих приложениях Фреша (1С:Бухгалтерия, 1С:Управление нашей фирмой и других) расширение можно добавить прямо из интерфейса программы. Этот путь удобен, когда нет доступа к менеджеру сервиса, но есть права администратора в самой информационной базе.

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

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

Проверка результата после загрузки

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

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

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

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

Статус расширения в списке

Норма

Подключено, без предупреждений

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

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

Работа новой функции

Норма

Форма, отчёт или команда открываются и выполняются

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

Ошибка при обращении к метаданным или объекту

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

Норма

Нет ошибок, связанных с расширением

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

Повторяющиеся ошибки при работе пользователей

Типичные ошибки и как их исправить

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

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

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

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

Часто задаваемые вопросы

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

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

Сколько длится проверка расширения сервисом?

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

Расширение отключилось после обновления конфигурации. Что делать?

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

Можно ли изменять типовые объекты конфигурации через расширение в Фреше?

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

Кто имеет право загружать расширения в Фреш?

Администратор абонента — через менеджер сервиса, либо пользователь с правами администратора внутри приложения — через раздел «Расширения». Обычным пользователям эти функции недоступны.

Опасно ли подключать расширение к рабочей базе?

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