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

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

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

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

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

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

Также убедитесь, что префикс расширения не пересекается с уже подключёнными. Если два расширения добавляют объекты с одинаковыми именами и одним префиксом, возникнет конфликт, и второе расширение не подключится.

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

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

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

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

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

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

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

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

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

Проверка применимости и контроль ошибок

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

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

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

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

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

Статус в списке расширений

Норма

Флажок «Подключено» установлен, применимость — «Да»

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

Применимость «Нет», расширение отключено платформой

Обновление конфигурации БД

Норма

F7 выполняется без ошибок реструктуризации

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

Ошибки обновления, ссылки на несуществующие объекты

Работа в 1С:Предприятии

Норма

Доработанные формы и отчёты открываются и работают

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

Ошибки при открытии форм, отсутствие добавленных элементов

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

Норма

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

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

Записи об ошибках применения расширения при входе пользователей

Отладка кода расширения

Расширения полноценно поддерживают отладку. Включите режим отладки в конфигураторе («Отладка → Начать отладку» или F5), поставьте точку останова в модуле расширения — платформа остановится на ней так же, как на коде основной конфигурации. В дереве конфигурации объекты расширения отображаются в отдельной ветке, что упрощает навигацию.

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

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

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

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

Как отключить или удалить расширение

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

Для полного удаления выделите расширение в списке и нажмите Delete. Платформа предупредит, если расширение добавляет собственные объекты с данными: при удалении эти данные будут потеряны вместе со структурой. Перед удалением такого расширения сохраните его в файл CFE — кнопка «Сохранить в файл» — чтобы при необходимости вернуть доработку.

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

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

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

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

Чем расширение отличается от внешней обработки?

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

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

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

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

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

Как перенести расширение из тестовой базы в рабочую?

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

Влияет ли расширение на обновление типовой конфигурации?

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