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

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

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

Что такое расширение CFE и когда его применяют

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

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

Условия, которые нужно проверить перед загрузкой

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

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

Пошаговая загрузка CFE через конфигуратор

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

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

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

Настройки расширения после добавления

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

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

Проверка результата в режиме «1С:Предприятие»

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

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

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

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

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

Норма

Статус активно, ошибок применимости нет

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

Жёлтый или красный индикатор, сообщение о несовместимости

Запуск в режиме «1С:Предприятие»

Норма

Сеанс стартует без сообщений об ошибках расширений

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

Предупреждение об отключении расширения при старте

Функциональность

Норма

Новые формы, команды и печатные формы работают

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

Объекты отсутствуют или выдают ошибку при обращении

Типичные ошибки при загрузке и их решение

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

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

Альтернативные способы подключения расширения

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

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

Сравнение вариантов

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

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

Загрузка из режима «1С:Предприятие»

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

Пакетный режим / командная строка

Подходит для массового развёртывания на многих базах. Требует навыков автоматизации и аккуратной обработки ошибок

FAQ

Можно ли загрузить CFE, не снимая конфигурацию с поддержки?

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

Расширение загружено, но не работает в режиме «1С:Предприятие». Что проверить?

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

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

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

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

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

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

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

Опасно ли снимать флажок «Безопасный режим» у расширения?

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