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