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