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

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

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

Подготовка перед загрузкой расширения

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

Проверьте, что версия платформы 1С, на которой работает база, поддерживает расширения. Механизм доступен начиная с платформы 8.3.6, но многие возможности (например, расширение ролей или дополнение общих модулей) появились в более поздних версиях. Если расширение разработано под более новую платформу, чем установлена у вас, при загрузке или применении появится ошибка несовместимости.

Обязательно сделайте резервную копию базы. Для файловой базы достаточно скопировать каталог с файлом 1Cv8.1CD при отсутствии активных сеансов. Для клиент-серверной базы используйте выгрузку через конфигуратор («Администрирование → Выгрузить информационную базу») или средства СУБД.

Открытие списка расширений в конфигураторе

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

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

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

Загрузка расширения из файла CFE

В окне расширений нажмите кнопку «Добавить» (значок «+»). В список добавится новая строка с автоматически сгенерированным именем, например «Расширение1». Пока это пустое расширение без содержимого.

Далее выделите добавленную строку и нажмите кнопку «Загрузить из файла» (иконка со стрелкой из папки). В диалоге выбора укажите путь к файлу .cfe и подтвердите загрузку. Платформа прочитает файл и заполнит расширение объектами из него.

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

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

Настройка параметров безопасности

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

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

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

Обновление конфигурации базы данных

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

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

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

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

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

Статус расширения в списке

Норма

Расширение подключено, предупреждений нет

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

Жёлтый или красный значок, текст о несовместимости

Запуск в режиме предприятия

Норма

База открывается без ошибок, доработки видны

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

Ошибка при запуске или отсутствие объектов расширения

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

Норма

Нет ошибок, связанных с именем расширения

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

Ошибки применения расширения при входе пользователей

Проверка работы и контроль применимости

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

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

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

Типичные ошибки и их устранение

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

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

Третья ошибка — попытка загрузить файл не того формата. Файл .epf — это внешняя обработка, а не расширение; она открывается через «Файл → Открыть» в режиме предприятия, а не через список расширений. Убедитесь, что у вас именно файл с расширением .cfe.

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

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

Для автоматизации развёртывания используется пакетный режим конфигуратора с параметром /LoadCfg не подходит, а вот команда загрузки расширения выполняется через Designer с параметрами управления расширениями — например, /ManageCfgExtensions в новых версиях платформы. Это применяется в сценариях CI/CD и при массовом обновлении нескольких баз.

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

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

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

Через режим предприятия

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

Пакетный режим

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

Часто задаваемые вопросы

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

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

Чем файл CFE отличается от файла CF?

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

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

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

Можно ли подключить несколько расширений одновременно?

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

Нужно ли заново загружать расширение после обновления типовой конфигурации?

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

Безопасно ли снимать флаг «Безопасный режим»?

Это безопасно только для расширений из полностью доверенных источников — от вашего разработчика или проверенного поставщика. Безопасный режим запрещает коду расширения обращаться к файловой системе, внешним компонентам и COM-объектам. Сняв флаг для недоверенного расширения, вы даёте его коду полный доступ к компьютеру и данным базы.