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

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

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

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

Первое условие — версия платформы. Механизм расширений работает на платформе 8.3.6 и выше, но комфортная разработка (заимствование форм, ролей, подсистем, изменение команд) доступна примерно с 8.3.11. Если расширение создано на более новой платформе, чем установлена у вас, открыть его не получится: конфигуратор выдаст сообщение о несовместимости версий.

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

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

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

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

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

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

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

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

Если расширение ещё не подключено к базе, его нужно загрузить из файла с расширением .cfe. В окне «Расширения конфигурации» нажмите кнопку «Загрузить из файла» и укажите путь к CFE-файлу. Платформа выполнит проверку применимости: сопоставит заимствованные объекты с объектами основной конфигурации.

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

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

Как создать и открыть новое расширение

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

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

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

Проверка применимости и устранение конфликтов

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

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

Выгрузка расширения в файл и перенос между базами

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

Для массовой установки расширений на несколько баз используйте пакетный режим конфигуратора с параметром /LoadCfg или механизмы встроенного языка (менеджер расширений конфигурации). Это удобно при обновлении флота одинаковых баз, но требует аккуратности с версиями.

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

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

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

Есть только файл CFEЗагрузите его через «Загрузить из файла», затем обновите конфигурацию базы данных

Расширение помечено как неприменимое после обновления конфигурацииЗапустите проверку применимости и устраните конфликты заимствованных объектов

Нужно изменить код типовой конфигурацииНе правьте основную конфигурацию — создайте расширение и заимствуйте нужные объекты

Ограничения механизма расширений

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

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

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

Почему пункт «Расширения конфигурации» неактивен в меню?

Чаще всего не открыта основная конфигурация: выполните «Конфигурация» → «Открыть конфигурацию». Также пункт недоступен, если пользователь не имеет административных прав или версия платформы ниже 8.3.6.

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

Просмотреть и отредактировать код можно в 1C:Enterprise Development Tools (EDT) — расширение импортируется туда как проект. В режиме «Предприятие» расширение открыть для редактирования нельзя, там доступно только подключение и отключение через «НСИ и администрирование» → «Печатные формы, отчеты и обработки» → «Расширения».

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

Расширение создано на более новой платформе. Либо обновите платформу на рабочей базе, либо попросите автора расширения выгрузить его под вашу версию. Понижение версии расширения вручную недоступно.

Расширение активно, но доработки не видны в режиме «Предприятие». В чём причина?

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

Как удалить расширение из базы?

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

Можно ли открыть расширение на копии базы, а потом перенести в рабочую?

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