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

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

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

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

Что такое расширение CFE и когда его используют

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

Расширения применяют, когда нужно доработать типовое решение без потери поддержки: добавить кнопку на форму документа, изменить алгоритм проведения через аннотации «ИзменитьИКонтролировать» или «Вместо», подключить внешнюю печатную форму как постоянный элемент конфигурации. Для одноразовых задач (например, разово сформировать отчёт) расширение не нужно — достаточно внешней обработки EPf или отчёта ERF.

Что проверить перед подключением

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

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

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

Подключение CFE через конфигуратор

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

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

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

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

Подключение через режим «1С:Предприятие»

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

В открывшейся форме нажмите «Добавить из файла», выберите CFE и подтвердите загрузку. Система может предупредить о том, что расширение подключается в небезопасном режиме, — для файлов из доверенного источника это допустимо, но лучше оставить безопасный режим включённым, если расширение не требует прямого доступа к файловой системе или COM-объектам.

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

Проверка результата и контроль ошибок

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

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

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

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

Список расширений

Норма

Расширение есть в списке, флажок «Активно» установлен, ошибок нет

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

Расширение отсутствует или помечено как неактивное/с ошибкой

Поведение системы

Норма

Новая функциональность доступна, формы открываются без ошибок

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

При открытии форм возникают ошибки «Объект не найден» или «Метод не обнаружен»

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

Норма

Нет записей об ошибках подключения расширений

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

Есть ошибки контроля заимствованных объектов или прав доступа

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

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

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

Типичные ошибки при подключении CFE

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

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

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

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

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

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

Чем CFE отличается от файлов EPF и ERF?

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

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

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

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

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

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

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

Безопасно ли подключать CFE из интернета?

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

Как подключить расширение только для отдельных пользователей?

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