Как добавить расширение в 1С:Фреш

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

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

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

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

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

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

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

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

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

Войдите в личный кабинет абонента на портале сервиса, выберите нужное приложение (информационную базу) и перейдите в раздел управления расширениями. Нажмите кнопку добавления, укажите файл .cfe с локального компьютера и подтвердите загрузку. Сервис выполнит автоматическую проверку и, если она пройдена, подключит расширение к базе.

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

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

Способ 2: добавление изнутри информационной базы

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

Откройте этот раздел, нажмите «Добавить из файла» и выберите файл .cfe. Система предупредит о необходимости перезапуска сеанса — после добавления расширения нужно выйти из базы и войти снова, чтобы изменения вступили в силу. Перед загрузкой рекомендуется снять флажок «Безопасный режим» только в том случае, если вы полностью доверяете источнику расширения и понимаете, зачем ему нужны расширенные права.

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

Проверка безопасности и почему сервис может отказать

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

Типичные причины отказа: использование методов работы с файловой системой (НайтиФайлы, запись на диск сервера), подключение внешних компонентов, обращение к COM-объектам, выполнение произвольного кода через Выполнить() с внешними данными, прямые запросы к СУБД. В локальной базе такие приёмы работают, в облаке — нет.

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

Сравнение способов установки

Менеджер сервиса

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

Изнутри базы (раздел «Расширения»)

Удобен администратору прикладного решения без доступа к менеджеру сервиса. Может быть заблокирован настройками абонента.

Готовые расширения из каталога сервиса

Уже прошли проверку, устанавливаются в один клик. Выбор ограничен опубликованными решениями, доработка невозможна.

Как проверить, что расширение работает

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

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

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

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

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

Норма

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

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

Расширение отсутствует или отключено после перезапуска сеанса

Работа функционала

Норма

Новые кнопки, формы или отчёты доступны и выполняются без ошибок

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

Ошибки «метод не обнаружен», «объект не найден» при вызове

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

Норма

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

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

Повторяющиеся ошибки при обращении к доработанным объектам

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

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

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

FAQ

Можно ли изменить типовую конфигурацию в 1С:Фреш напрямую?

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

Что делать, если сервис отклонил расширение при проверке?

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

Кто может устанавливать расширения в абоненте?

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

Нужно ли переустанавливать расширение после обновления конфигурации?

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

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

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

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

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