К статье
Практический материал

Разработка и Конфигурация · 8 мин

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

Как открыть расширение конфигурации в 1С через конфигуратор: подключение файла .cfe, просмотр, редактирование и отладка. Типичные ошибки и ответы на вопросы.

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

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

Что такое расширение и где оно хранится

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

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

Как открыть подключённое расширение в конфигураторе

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

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

Порядок действий
  1. 1
    Откройте конфигуратор и войдите в базу под администратором
  2. 2
    Перейдите: Конфигурация → Расширения конфигурации
  3. 3
    Выделите нужное расширение и нажмите «Открыть»
  4. 4
    Дождитесь загрузки дерева объектов расширения
  5. 5
    Внесите изменения и сохраните (F7 или Ctrl+S)
  6. 6
    Обновите конфигурацию базы данных (F7 → принять изменения)

Как загрузить и открыть расширение из файла .cfe

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

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

Просмотр и редактирование объектов расширения

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

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

Проверка результата и применение изменений

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

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

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

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

Статус расширения в списке
Норма

Флажок активности установлен, ошибок нет

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

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

Работа формы в режиме предприятия
Норма

Форма открывается, доработки видны и функционируют

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

Ошибка при открытии формы или отсутствие изменений

Журнал регистрации
Норма

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

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

Ошибки компиляции модулей или обращения к объектам

Типичные ошибки при открытии расширений

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

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

Типичные ошибки
01
Загрузка .cfe в рабочую базу без копии — при несовместимости база может не запуститься
02
Забытое обновление конфигурации базы данных — изменения сохранены, но не применены
03
Редактирование расширения при работающих пользователях — обновление требует монопольного доступа
04
Игнорирование режима совместимости — старые платформы не поддерживают часть возможностей расширений

Частые вопросы

Можно ли открыть расширение без конфигуратора?

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

Как выгрузить расширение в файл для передачи?

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

Почему после обновления конфигурации расширение перестало работать?

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

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

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

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

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

Итог

Что важно запомнить

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