Как установить расширение 1С через конфигуратор

Расширение конфигурации — это механизм платформы 1С:Предприятие 8.3, который позволяет добавлять или изменять функциональность прикладного решения без снятия основной конфигурации с поддержки. Расширения хранятся в файлах с расширением .cfe и устанавливаются либо через конфигуратор, либо через пользовательский режим «1С:Предприятие». Установка через конфигуратор даёт администратору больше контроля: можно сразу проверить применимость, сравнить расширение с основной конфигурацией и управлять порядком загрузки.

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

Перед началом работы убедитесь, что у вас есть файл расширения (.cfe), права администратора в информационной базе и актуальная резервная копия. Хотя расширение не меняет основную конфигурацию напрямую, ошибочное расширение может заблокировать запуск сеансов пользователей или вызвать ошибки при обновлении конфигурации базы данных.

Что нужно подготовить перед установкой расширения

Минимальный набор для установки: файл расширения с расширением .cfe, конфигуратор 1С с доступом к нужной информационной базе и учётная запись с правами администрирования. Если база работает в клиент-серверном режиме, убедитесь, что у вас есть возможность временно ограничить работу пользователей или хотя бы предупредить их о перезапуске сеансов.

Проверьте совместимость расширения с вашей версией конфигурации и платформы. Расширение, написанное под другой релиз конфигурации, может загрузиться, но при проверке применимости выдаст ошибки по заимствованным объектам. Уточните у разработчика, под какую версию конфигурации собран файл, и сравните её с версией вашей базы (меню «Справка → О программе» в режиме предприятия или свойства конфигурации в конфигураторе).

Сделайте резервную копию. Для файловой базы достаточно скопировать файл 1Cv8.1CD или выгрузить базу через «Администрирование → Выгрузить информационную базу». Для клиент-серверной базы используйте штатные средства СУБД либо выгрузку через конфигуратор. Это займёт несколько минут, но позволит откатиться, если расширение нарушит работу базы.

Как открыть список расширений в конфигураторе

Запустите конфигуратор и откройте нужную информационную базу. В главном меню выберите «Конфигурация → Расширения конфигурации». Откроется окно со списком уже установленных расширений. Если список пуст, значит, в базе пока нет ни одного расширения либо они отключены на уровне публикации.

В окне расширений отображаются ключевые свойства каждого элемента: имя, префикс, назначение, активность и безопасный режим. Обратите внимание на колонку «Активно» — расширение может быть загружено в базу, но выключено. Перед добавлением нового расширения полезно убедиться, что его имя и префикс не совпадают с уже существующими: конфликт имён не даст загрузить файл.

Если база работает в клиент-серверном режиме, список расширений общий для всех пользователей. Изменения применяются к информационной базе целиком, а не к конкретному сеансу, поэтому планируйте установку в период минимальной нагрузки.

Пошаговая установка расширения из файла CFE

Последовательность действий при установке нового расширения через конфигуратор выглядит следующим образом. Сначала в окне «Расширения конфигурации» нажмите кнопку «Добавить». Платформа создаст пустое расширение и откроет его дерево объектов — пока оно не содержит ничего, кроме служебных свойств.

Далее в меню конфигуратора выберите «Конфигурация → Расширения конфигурации → Загрузить из файла» (в некоторых версиях платформы пункт доступен из контекстного меню созданного расширения). Укажите путь к файлу .cfe и подтвердите загрузку. Платформа перенесёт в пустое расширение все объекты из файла: заимствованные справочники, документы, добавленные формы, модули и роли.

После загрузки задайте осмысленное имя и префикс расширения в его свойствах, если они не заполнились автоматически. Префикс используется для имён добавляемых объектов, чтобы они не пересекались с объектами основной конфигурации и других расширений. Затем выполните проверку применимости и обновите конфигурацию базы данных (клавиша F7 или меню «Конфигурация → Обновить конфигурацию базы данных»).

1. 1
   Сделайте резервную копию информационной базы
2. 2
   Откройте базу в конфигураторе под учётной записью администратора
3. 3
   Перейдите в меню «Конфигурация → Расширения конфигурации»
4. 4
   Нажмите «Добавить» и создайте новое расширение
5. 5
   Загрузите расширение из файла CFE через пункт «Загрузить из файла»
6. 6
   Проверьте и при необходимости скорректируйте имя, префикс и назначение расширения
7. 7
   Выполните проверку применимости расширения
8. 8
   Обновите конфигурацию базы данных (F7)
9. 9
   Проверьте работу базы в режиме «1С:Предприятие»

Проверка применимости и обновление конфигурации базы данных

Проверка применимости — ключевой этап, который нельзя пропускать. Платформа анализирует, соответствуют ли заимствованные объекты расширения текущему состоянию основной конфигурации: существуют ли нужные объекты, не изменились ли их типы и состав реквизитов. Запустить проверку можно из окна расширений кнопкой «Проверить возможность применения» или автоматически при обновлении конфигурации базы данных.

Если проверка выявила ошибки, платформа покажет список проблемных объектов. Типичные причины: объект, на который опирается расширение, переименован или удалён в новой версии конфигурации; изменился тип реквизита; расширение рассчитано на другую версию прикладного решения. В такой ситуации не обновляйте конфигурацию базы данных «вслепую» — сначала передайте список ошибок разработчику расширения.

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

Настройки расширения: безопасный режим, защита и назначение

У каждого расширения есть свойство «Безопасный режим». Если флаг установлен, код расширения выполняется с ограничениями: недоступны операции с файловой системой, COM-объекты, внешние компоненты и ряд других потенциально опасных действий. Для расширений из недоверенных источников безопасный режим рекомендуется оставлять включённым, но учтите, что функциональность, требующая выхода из безопасного режима, перестанет работать.

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

Поле «Назначение» определяет область применения расширения: для всей информационной базы, для разделителей (в режиме SaaS) или для конкретных областей данных. В обычной локальной базе используется назначение «Информационная база». Неверно выбранное назначение — частая причина ситуации, когда расширение загружено, но не работает у части пользователей.

Маршрут решения

Как выбрать действие

Расширение от собственного разработчика и требует доступа к файлам или внешним компонентамСнимите флаг безопасного режима после проверки кода

Расширение получено из внешнего источника без гарантийОставьте безопасный режим включённым и протестируйте на копии базы

Расширение нужно только в отдельной области данных сервисаУстановите назначение «Разделение данных» и проверьте область применения

Типичные ошибки при установке и их устранение

Самая распространённая ошибка — «Нарушение целостности структуры конфигурации» или сообщения о несоответствии заимствованных объектов при проверке применимости. Это означает, что версия расширения не совпадает с версией основной конфигурации. Решение: запросить у разработчика сборку под ваш релиз либо обновить конфигурацию до версии, под которую собрано расширение.

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

Третья группа ошибок связана с правами и режимами: расширение загружено, но не применяется. Проверьте флаг «Активно» в списке расширений, настройки безопасного режима и защиты от опасных действий, а также то, что обновление конфигурации базы данных действительно выполнено. В клиент-серверном режиме иногда помогает перезапуск сеанса пользователя — старый сеанс может работать с устаревшим кэшем метаданных.

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

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

Дополнительно откройте в режиме предприятия раздел «Администрирование → Печатные формы, отчеты и обработки → Расширения» (в типовых конфигурациях на БСП) — там видно, какие расширения применены в текущем сеансе. Если расширение отображается в конфигураторе, но отсутствует в этом списке, значит, оно не применилось: проверьте активность и ошибки применимости.

Полезно проверить журнал регистрации на наличие ошибок после установки. Ошибки вида «Метод объекта не обнаружен» или «Поле объекта не обнаружено» при обращении к объектам расширения указывают на рассинхронизацию версий. Такие ошибки нужно устранять до вывода расширения в промышленную эксплуатацию.

Контрольные точки

Как проверить результат

Статус расширения в конфигураторе

Норма

Флаг «Активно» установлен, проверка применимости проходит без ошибок

Тревожный признак

Проверка применимости выдаёт ошибки по заимствованным объектам

Список расширений в режиме предприятия

Норма

Расширение отображается как применённое

Тревожный признак

Расширение отсутствует в списке или помечено как неприменённое

Журнал регистрации после запуска

Норма

Нет ошибок, связанных с объектами расширения

Тревожный признак

Ошибки «Метод не обнаружен» или «Поле объекта не обнаружено»

Функциональность расширения

Норма

Новые элементы интерфейса и логика работают как описано

Тревожный признак

Изменения не видны пользователям или вызывают ошибки

Обновление и удаление ранее установленного расширения

Чтобы обновить расширение новой версией, выделите его в списке расширений конфигуратора и выполните «Загрузить из файла», указав новый CFE-файл. Платформа заменит содержимое существующего расширения, сохранив его имя и настройки. Не добавляйте новое расширение для обновления — это создаст дубликат.

Удаление расширения выполняется кнопкой «Удалить» в окне расширений с последующим обновлением конфигурации базы данных. Учтите: если расширение добавляло собственные объекты с данными (например, новый справочник), при удалении эти данные будут потеряны. Платформа предупредит о таких объектах при обновлении конфигурации БД.

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

Частые вопросы об установке расширений через конфигуратор

Можно ли установить расширение, не прерывая работу пользователей?

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

Чем установка через конфигуратор отличается от установки в режиме «1С:Предприятие»?

В режиме предприятия расширения подключаются через раздел «Администрирование» и не требуют обновления конфигурации БД вручную — платформа делает это автоматически. Конфигуратор даёт больше контроля: можно открыть состав расширения, сравнить объекты с основной конфигурацией и выполнить детальную проверку применимости.

Что делать, если после установки расширения база перестала запускаться?

Откройте конфигуратор, перейдите в список расширений и снимите флаг «Активно» с проблемного расширения либо удалите его, затем обновите конфигурацию базы данных. Если конфигуратор тоже не открывается, восстановите базу из резервной копии — поэтому копия перед установкой обязательна.

Можно ли установить несколько расширений одновременно?

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

Нужно ли снимать конфигурацию с поддержки для установки расширения?

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

Почему расширение загрузилось, но пользователи не видят изменений?

Чаще всего не выполнено обновление конфигурации базы данных после загрузки файла. Также проверьте флаг «Активно», настройки безопасного режима и защиты от опасных действий, а затем попросите пользователя перезапустить сеанс.