Расширения в облаке 1cFresh: права, проверка, установка и удаление

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

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

Чем облако 1С Фреш отличается от локальной базы

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

Что меняется в облаке:

• 🔒 Нет Конфигуратора. Абонент работает только в режиме «1С:Предприятие». Структуру конфигурации он не трогает.
• 🛡️ Безопасный режим. Код расширения выполняется с ограничениями: без прямого доступа к файловой системе сервера, без COM-объектов, без произвольных внешних соединений. Обращения к внешним ресурсам разрешаются только через профиль безопасности.
• ✅ Обязательная проверка. Любое расширение, которое не опубликовано в каталоге сервиса, перед установкой проверяет оператор. Он смотрит код на опасные действия и совместимость с конфигурацией.
• 🔄 Обновления по графику сервиса. Релиз конфигурации обновляет оператор, а не абонент. Расширение должно пережить это обновление.
• 👥 Разделение данных. Расширение ставится в конкретное приложение абонента и не затрагивает чужие приложения на той же конфигурации.

Отсюда два сценария подключения:

Какие права нужны, чтобы подключить расширение

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

В 1cFresh права раздаются на двух уровнях:

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

Как проверить себя:

1. Войдите в личный кабинет 1cFresh.
2. Откройте список пользователей абонента и найдите свою учётную запись.
3. Посмотрите права на нужное приложение: там должно стоять право администратора, а не обычного пользователя.
4. Если права пользовательские — попросите владельца абонента их поднять. Сами вы этого сделать не сможете.

После смены прав выйдите из приложения и зайдите снова. Новые права подхватываются при следующем входе.

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

Каталог — самый быстрый путь. Расширения в нём уже проверены оператором и привязаны к конкретной конфигурации, например к Бухгалтерии предприятия 3.0 или ЗУП 3.1.

Шаг 1. Найдите расширение

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

Шаг 2. Выберите приложение

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

Шаг 3. Установите и подтвердите разрешения

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

Шаг 4. Перезапустите приложение

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

Шаг 5. Проверьте результат

Откройте раздел Администрирование в приложении и найдите там управление расширениями. В БП 3.0 список расширений открывается через Администрирование → Печатные формы, отчеты и обработки → Расширения. Новое расширение должно быть в списке и быть активным.

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

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

Что подготовить до отправки

Большая часть отказов случается из-за подготовки, а не из-за кода. Перед отправкой программист проверяет:

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

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

Как узнать релиз и режим совместимости облачного приложения

Программисту нужны две цифры: релиз конфигурации и версия платформы. Обе видны в самом приложении:

1. Откройте меню приложения (кнопка с тремя полосками в левом верхнем углу).
2. Выберите Справка → О программе.
3. Перепишите номер релиза конфигурации и версию платформы.

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

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

Порядок отправки

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

Каталог готовых решений: что там искать и как выбирать

Каталог расширений в 1С Фреш — это витрина проверенных доработок от фирмы-оператора и партнёров. Чаще всего там встречаются:

• 🖨️ дополнительные печатные формы и бланки;
• 📊 отчёты и аналитические панели;
• 🔗 обмены с банками, маркетплейсами, сайтами и сервисами доставки;
• ⚙️ групповая обработка документов и справочников.

Как выбирать:

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

Ошибки при подключении расширения в облаке и что с ними делать

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

Ещё две ситуации, которые путают с ошибками:

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

Обновление и удаление подключённых расширений

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

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

Собственное расширение обновляется так же, как подключалось:

1. Программист вносит изменения и пересобирает .cfe на актуальном релизе.
2. Администратор отправляет новую версию на проверку.
3. После одобрения версия заменяет предыдущую в приложении.

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

Как отключить или удалить

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

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

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