Как загрузить расширение CFE в 1С

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

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

Ниже разобран полный цикл: подготовка, оба способа загрузки, проверка результата, типовые ошибки и безопасный откат.

Подготовка: что проверить до загрузки CFE

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

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

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

Загрузка CFE через конфигуратор

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

Нажмите кнопку «Добавить» (или F4/«Создать» в списке) и укажите путь к файлу с расширением .cfe. Платформа загрузит расширение и покажет его в списке. Убедитесь, что у нового расширения установлено свойство «Используется» (флажок активен) и задано осмысленное имя — по нему расширение будет идентифицироваться в журналах и при обновлениях.

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

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

Загрузка CFE в режиме «Предприятие»

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

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

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

Два способа загрузки CFE

Через конфигуратор

Подходит для любых конфигураций, включая самописные. Требует прав администратора конфигурации и часто монопольного доступа.

В режиме «Предприятие»

Быстрее и без остановки работы пользователей, но доступен только в типовых конфигурациях на БСП и требует роли администрирования расширений.

Проверка результата после загрузки

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

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

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

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

Расширение в списке

Норма

Статус «Используется»/«Подключено», имя без ошибок

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

Флажок снят, расширение помечено как неприменённое

Работа изменённых объектов

Норма

Формы открываются, документы проводятся, отчёты строятся

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

Ошибки при открытии форм или проведении документов

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

Норма

Нет новых ошибок после подключения

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

Ошибки «метод не обнаружен», «поле не обнаружено»

Типичные ошибки и ограничения

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

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

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

Отключение и удаление расширения

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

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

FAQ по загрузке расширений CFE

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

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

Нужен ли монопольный доступ для загрузки расширения?

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

Расширение загрузилось, но не работает. Что проверить?

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

Что произойдёт с расширением при обновлении типовой конфигурации?

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

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

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

Безопасно ли загружать CFE из интернета?

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