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