Расширения в облачной 1С:Фреш: из каталога, из файла и через проверку провайдера

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

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

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

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

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

• 🔒 расширение подключается только к вашей области данных, другие абоненты его не видят;
• 🛡️ оно работает в безопасном режиме: без доступа к файловой системе сервера, COM-объектам, внешним компонентам и привилегированным операциям;
• ✅ любой код, который приходит не из каталога, проверяет провайдер: автоматически и, как правило, вручную;
• 🔄 конфигурацию обновляет сервис, а не вы — после обновления расширение обязано остаться совместимым.

Расширение или дополнительная обработка

Во Фреше есть и второй механизм доработок — дополнительные отчёты и обработки (файлы .epf и .erf). Их выбор зависит от задачи.

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

Подготовка: права, версия и сам файл расширения

Прежде чем что-то загружать, проверьте три вещи.

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

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

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

Совместимость с релизом конфигурации

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

1. Конфигурация совпадает: расширение для Бухгалтерии предприятия не подключится к Управлению нашей фирмой.
2. Релиз, под который делали расширение, совпадает с релизом вашего приложения. Его видно в разделе Справка → О программе (или по значку информации в шапке).
3. Режим совместимости расширения не новее, чем у основной конфигурации.
4. Свойство «Безопасный режим» в расширении включено, а код не использует запрещённые в нём операции.

Требования к коду

Проверку провайдера не пройдут расширения, которые:

• ❌ пишут или читают файлы на диске сервера, запускают внешние программы;
• ❌ используют COM-объекты и внешние компоненты, не одобренные сервисом;
• ❌ выполняют код в привилегированном режиме или переключают безопасный режим;
• ❌ меняют общие (неразделённые) данные, которые принадлежат всем абонентам;
• ❌ обращаются к внешним веб-адресам без описания, зачем это нужно.

Способы установки расширения в 1С:Фреш

Способ 1. Из каталога расширений

Каталог — это витрина готовых решений, которые разработчики уже опубликовали и прошли проверку. Часть из них бесплатна, часть продаётся по подписке.

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

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

Способ 2. Загрузка своего файла .cfe

Для собственной доработки путь такой:

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

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

Способ 3. Через партнёра

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

Настройка расширения после установки

Подключённое расширение ещё не значит работающее у всех. Осталось два шага.

Роли и права пользователей

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

1. Откройте Администрирование → Настройки пользователей и прав → Профили групп доступа.
2. Откройте профиль, по которому работают нужные сотрудники, например «Бухгалтер».
3. Отметьте роли расширения и запишите профиль.
4. Попросите пользователей перезайти в программу.

Не правьте поставляемые профили. Скопируйте профиль, добавьте роли в копию и переназначьте группу доступа на неё. Так изменения не потеряются при обновлении.

Параметры самого расширения

В списке расширений у каждой строки есть признаки, которые стоит проверить:

• ✅ «Подключено» — снимите флажок, чтобы временно выключить расширение без удаления;
• 🛡️ «Безопасный режим» — во Фреше всегда включён, снять его нельзя;
• ⚙️ собственные настройки — если расширение их добавляет, они обычно появляются в разделе Администрирование или в разделе, к которому относится доработка.

Проверьте доработку на одном-двух документах, а не сразу в закрытии месяца.

Как обновить или удалить расширение во Фреше

Обновление своего расширения

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

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

Что сделать заранее:

1. Следите за анонсами обновлений приложения в сервисе.
2. До установки релиза проверьте расширение на локальной базе с новым релизом.
3. Если нужны правки, загрузите новую версию расширения заранее.

Удаление

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

Безопаснее сначала снять флажок «Подключено» и поработать неделю. Если никто не пожаловался — удаляйте.

Как проверить расширение до загрузки в сервис

Проверка провайдера ищет опасный код, но не проверяет, правильно ли считает ваша доработка. Это задача заказчика и разработчика. Тестовый стенд собирают за час.

Локальная копия с тем же релизом

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

Что смотреть при тесте

• 🧾 Движения документов после проведения совпадают с тем, что было без расширения, если доработка не должна их менять.
• 👥 Пользователь с профилем «Бухгалтер», а не только администратор, видит новые команды и не получает ошибок прав.
• ⏱️ Открытие форм и проведение не стали заметно медленнее.
• ⚠️ В журнале регистрации нет ошибок безопасного режима.

Если всё прошло чисто на локальной копии, шанс получить отказ при проверке и сюрприз в рабочей базе заметно ниже.

Безопасность расширений в облачной базе

Безопасный режим защищает сервер, но не защищает ваши данные от ошибок в самой доработке. Расширение с полными правами может перепровести документы, изменить остатки или удалить элементы справочников.

Правила, которые снижают риск:

• 📦 Перед установкой нового расширения или его версии сделайте резервную копию приложения. Во Фреше это делается в личном кабинете, отдельно от ежедневных автоматических копий сервиса.
• 👤 Берите расширения только у разработчиков, которых знаете, или из каталога сервиса.
• 📝 Храните у себя исходный файл .cfe каждой версии и описание: что делает, кто писал, под какой релиз.
• 🔍 Не давайте роли расширения всем подряд. Если доработка нужна только кассиру, выдайте её только профилю кассира.

Частые вопросы