Администрирование · 10 мин
Как установить расширение в 1С:Фреш
Как подключить расширение конфигурации в 1С:Фреш через менеджер сервиса: требования к файлу .cfe, аудит безопасности, настройка прав, проверка результата и типичные ошибки.
Расширение конфигурации в 1С:Фреш позволяет добавить печатные формы, отчёты, обработки и доработки без изменения типовой конфигурации. Это основной законный способ адаптировать облачную программу под задачи компании, поскольку прямое изменение конфигурации в сервисе недоступно — приложения в 1С:Фреш работают только на поддерживаемых типовых решениях.
Процедура установки в облаке отличается от локальной версии 1С: файл расширения проходит автоматическую проверку безопасности на стороне сервиса, а сама загрузка выполняется через менеджер сервиса или непосредственно в приложении — в зависимости от настроек абонента. Ниже разобраны оба пути, требования к файлу и способы проверить, что расширение заработало корректно.
Что нужно подготовить перед установкой
Основа установки — корректно собранный файл расширения с расширением .cfe. Его создают в конфигураторе локальной версии 1С:Предприятия: разрабатывают расширение, проверяют его на копии той же конфигурации и версии, что используется в облаке, и сохраняют в файл через меню «Конфигурация — Расширения конфигурации — Сохранить в файл».
Версия платформы и конфигурации, на которой собиралось расширение, должна совпадать с версией в сервисе или быть совместимой с ней. Узнать текущие версии приложения можно в разделе «О программе» внутри самого приложения 1С:Фреш. Несовпадение версий — самая частая причина отказа в установке или ошибок после подключения.
Проверьте, что у вашей учётной записи есть права абонента с возможностью администрирования приложений. Обычный пользователь приложения без прав администратора абонента не сможет загрузить расширение — кнопки управления расширениями будут недоступны.
Ограничения безопасности в облаке
1С:Фреш накладывает на расширения ограничения, которых нет в локальной версии. Сервис запрещает функциональность, способную нарушить изоляцию данных абонентов или стабильность работы облака. Перед загрузкой убедитесь, что расширение не содержит запрещённых механизмов — иначе аудит завершится отказом.
Как правило, блокируются внешние компоненты, доступ к файловой системе сервера, запуск внешних приложений, COM-соединения и прямые запросы к базе данных. Расширение должно работать в безопасном режиме и использовать только разрешённые возможности встроенного языка.
Установка через менеджер сервиса
Основной способ — загрузка через менеджер сервиса на сайте 1С:Фреш. Авторизуйтесь под учётной записью абонента, откройте карточку нужного приложения и перейдите в раздел управления расширениями. Там доступна загрузка нового расширения с указанием файла .cfe.
После выбора файла сервис запускает автоматическую проверку: контроль версий, аудит безопасности и проверку совместимости с конфигурацией. Проверка занимает некоторое время — статус отображается в списке расширений. При успешном завершении расширение становится доступным для подключения к приложению.
- 1Соберите файл .cfe в конфигураторе на той же версии конфигурации, что в облаке
- 2Авторизуйтесь в менеджере сервиса 1С:Фреш под учётной записью абонента
- 3Откройте карточку приложения и перейдите в раздел управления расширениями
- 4Загрузите файл .cfe и дождитесь завершения автоматической проверки
- 5Подключите проверенное расширение к приложению
- 6Войдите в приложение и проверьте работу новой функциональности
Если проверка завершилась ошибкой, сервис показывает причину отказа. Исправьте расширение в конфигураторе (уберите запрещённые вызовы, выровняйте версии), соберите файл заново и повторите загрузку.
Установка изнутри приложения
В некоторых настройках абонента расширения можно подключать непосредственно из приложения: раздел «Администрирование — Печатные формы, отчёты и обработки — Расширения». Там доступны добавление файла, отключение и удаление расширений. Этот путь удобен, когда администратор работает в основном внутри программы.
Обратите внимание на флаг «Безопасный режим» при добавлении. В облачном сервисе работа вне безопасного режима, как правило, не допускается, и попытка снять этот флаг приведёт к отказу в подключении.
Сравнение вариантов
Подходит для первичной загрузки и централизованного управления расширениями всех приложений абонента; требует прав администратора абонента.
Удобно для быстрого подключения и отключения; доступность зависит от настроек абонента и прав пользователя.
Подходит, если нужная доработка уже опубликована и прошла аудит; ограничение — выбор только из доступных решений.
Проверка результата после установки
После подключения войдите в приложение под пользователем, которому должна быть доступна новая функциональность. Убедитесь, что добавленные расширением объекты появились: откройте документ с новой печатной формой, найдите дополнительный отчёт в соответствующем разделе, проверьте изменённые формы.
Полезно проверить журнал регистрации на наличие ошибок, связанных с расширением: они возникают при обращении к переименованным или удалённым объектам основной конфигурации. Если функциональность не появилась, убедитесь, что расширение подключено именно к этому приложению и у пользователя есть нужные права.
Как проверить результат
Подключено, проверка пройдена
Ошибка проверки или статус «Отключено»
Печатные формы и отчёты доступны и открываются
Объектов нет или при открытии возникает ошибка
Нет ошибок, связанных с расширением
Ошибки вида «объект не найден» после подключения
Обновление, отключение и удаление расширения
При обновлении конфигурации в сервисе расширение может оказаться несовместимым с новой версией — тогда сервис отключает его или помечает как неработоспособное. Порядок действий: получить обновлённую версию расширения от разработчика, загрузить её как новую версию существующего расширения и проверить работу.
Отключение расширения безопасно для данных основной конфигурации: информация, хранящаяся в типовых объектах, сохраняется. Однако данные, которые расширение хранило в собственных добавленных объектах, при удалении расширения могут быть утрачены — перед удалением убедитесь, что эти сведения не нужны или выгружены.
Когда обратиться к разработчику или в поддержку
Самостоятельно разумно устанавливать расширения, полученные от известного разработчика и подготовленные под вашу версию конфигурации. Если аудит отклоняет файл с неочевидной причиной, если расширение после обновления конфигурации перестало работать, а разработчик недоступен, или если доработка затрагивает критичные учётные механизмы (проведение документов, расчёт зарплаты, налоги) — привлеките специалиста по 1С или поддержку сервиса.
Как выбрать действие
Перед обновлением конфигурации в облаке полезно зафиксировать список подключённых расширений и их версий. Если после обновления что-то перестанет работать, вы быстро поймёте, какое расширение требует обновления, и не будете искать причину вслепую.
Что важно запомнить
Установка расширения в 1С:Фреш сводится к трём условиям: файл .cfe собран под версию конфигурации в облаке, не содержит запрещённых механизмов и загружается пользователем с правами администрирования. Проверка безопасности выполняется сервисом автоматически, а работоспособность после подключения нужно контролировать вручную — по появлению объектов и отсутствию ошибок в журнале регистрации.
Частые вопросы
Можно ли установить в 1С:Фреш обработку в формате .epf?
Да, внешние обработки и отчёты подключаются через «Администрирование — Печатные формы, отчёты и обработки — Дополнительные отчёты и обработки», если эта возможность включена для абонента. Они также проходят проверку безопасности и работают в безопасном режиме, поэтому обработки с доступом к файловой системе или внешним компонентам не сработают.
Почему сервис отклонил расширение, которое отлично работает локально?
Локальная версия не накладывает облачных ограничений. Типичные причины отказа: внешние компоненты, работа с файловой системой, COM-объекты, запуск внешних программ, отключённый безопасный режим. Откройте код расширения в конфигураторе и уберите такие вызовы либо замените их разрешёнными механизмами.
Пропадут ли данные, если отключить или удалить расширение?
Данные типовой конфигурации не пострадают. Риск касается только объектов, добавленных самим расширением (например, его собственных регистров или справочников): при удалении расширения хранящиеся в них сведения могут быть утрачены. Перед удалением выгрузите важные данные.
Кто может загружать расширения в сервисе?
Пользователь с правами администратора абонента в менеджере сервиса либо пользователь приложения с правами администрирования, если настройки абонента разрешают управление расширениями изнутри приложения. Обычному пользователю без этих прав функции загрузки недоступны.
Что делать, если после обновления конфигурации расширение перестало работать?
Сервис может автоматически отключить несовместимое расширение. Нужна новая версия расширения, собранная под актуальный релиз конфигурации: запросите её у разработчика или соберите самостоятельно в конфигураторе, затем загрузите как обновление и проверьте работу по контрольным точкам.
Можно ли протестировать расширение, не рискуя рабочими данными?
Да. Проверьте файл на локальной копии конфигурации той же версии, а при наличии отдельного тестового приложения в сервисе — подключите расширение сначала к нему. Только после успешной проверки функциональности подключайте расширение к рабочему приложению.