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