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