Загрузка файла .cfe в Конфигураторе: от проверки версии до прав пользователей

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

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

Перед подключением расширения: версия платформы и права

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

Что проверить до начала работы:

• 🔢 Номер платформы. В Конфигураторе: Справка → О программе. Номер должен быть не ниже того, что указан для расширения.
• ⚙️ Режим совместимости конфигурации. Откройте свойства корня основной конфигурации и найдите свойство «Режим совместимости». Расширение собирают под конкретный режим, и при расхождении оно не применится.
• 🔑 Права пользователя. Для работы с расширениями нужен вход в Конфигуратор под пользователем с административными правами (в типовых конфигурациях — роль «Полные права» или «Администратор системы»).
• 📌 Версия и релиз основной конфигурации. Если расширение заимствует объекты типовой конфигурации, оно рассчитано на определённый релиз. На сильно отличающемся релизе часть заимствованных объектов может не совпасть.

Файл расширения: откуда он берётся и как его проверить

Расширение передают в виде файла с расширением .cfe. Источники бывают такие:

• 👨‍💻 ваш программист или подрядчик выгрузил его из своей базы командой сохранения расширения в файл;
• 🏢 его прислал разработчик отраслевого решения или сервиса вместе с инструкцией;
• 🗄️ вы сами сохранили его из другой информационной базы.

Перед загрузкой проверьте три вещи. Первое — файл действительно .cfe, а не .cf (полная конфигурация) или .epf (внешняя обработка). Загрузка .cf в окно расширений не пройдёт, а вот загрузка .cf в основную конфигурацию заменит её целиком — это совсем другая операция.

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

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

Как подключить расширение в Конфигураторе: шаги

Перед этими шагами сделайте резервную копию базы — порядок описан в последнем разделе.

Шаг 1. Откройте список расширений

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

Открывать основную конфигурацию (Конфигурация → Открыть конфигурацию) для этого не нужно.

Шаг 2. Загрузите файл .cfe

1. В окне списка расширений откройте меню «Конфигурации» на командной панели окна.
2. Выберите команду загрузки из файла и укажите ваш .cfe.
3. Если в базе уже есть расширение с тем же именем, Конфигуратор предложит заменить его содержимое. Для нового расширения появится новая строка.

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

Шаг 3. Проверьте свойства

Откройте свойства расширения (двойной щелчок по строке, затем свойства корня дерева). Посмотрите:

Флажки «Активно», «Безопасный режим» и «Защита от опасных действий» видны и прямо в колонках списка расширений.

Шаг 4. Обновите конфигурацию базы данных

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

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

Пакетный режим: подключение из командной строки

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

"C:\Program Files\1cv8\8.3.24.1342\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "" ^
  /LoadCfg "D:\Ext\MyExt.cfe" -Extension "MyExt" /UpdateDBCfg -Extension "MyExt" /Out "D:\Ext\log.txt"

Путь к платформе подставьте свой. Имя после -Extension — внутреннее имя расширения, а не имя файла. Результат пишется в лог /Out: смотрите его, а не только код возврата.

Права доступа к подключённому расширению

Расширение применилось, а пользователь ничего не видит — классика. Причина почти всегда в ролях.

Как устроены права в расширении:

• 🧩 Свои объекты расширения (новые отчёты, обработки, справочники) по умолчанию недоступны никому, кроме полноправных пользователей. Права на них даёт роль, которая лежит в самом расширении.
• 🔁 Заимствованные роли основной конфигурации в расширении изменить нельзя, но можно создать свою роль в расширении и выдать в ней права на свои объекты.
• 👥 Назначение роли пользователю делается уже в базе, а не в Конфигураторе.

Как выдать роль в типовой конфигурации

В конфигурациях на БСП (Бухгалтерия 3.0, ЗУП 3.1, УТ 11) роли не назначают пользователю напрямую. Их включают в профиль группы доступа:

1. В режиме «1С:Предприятие» откройте Администрирование → Настройки пользователей и прав.
2. Перейдите в «Профили групп доступа» и откройте профиль, который нужен этим пользователям (или скопируйте подходящий типовой).
3. На вкладке ролей найдите роль из расширения и отметьте её.
4. Запишите профиль. Пользователи групп с этим профилем получат доступ после перезапуска сеанса.

Типовые профили защищены от изменения, поэтому роль добавляют в копию профиля.

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

Если расширение не применяется: ошибки и решения

Сообщения о проблемах обычно содержат фразу Расширение ... не может быть применено и причину ниже. Читайте именно причину — по ней понятно, что делать.

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

Как убедиться, что расширение работает, и отладить его

Минимальная проверка после подключения:

1. Войдите в базу под обычным пользователем, а не под администратором. Так вы сразу увидите проблему с ролями.
2. Найдите то, что добавляет расширение: команду в форме документа, отчёт в разделе, печатную форму.
3. Выполните действие на тестовом документе и посмотрите результат.

Статус расширений виден и в самой базе. В Бухгалтерии 3.0 и других конфигурациях на БСП откройте Администрирование → Печатные формы, отчеты и обработки → Расширения. Там отображается список с отметками об активности и ошибках применения.

Для поиска ошибок в коде расширения подходит обычный отладчик Конфигуратора:

• 🐞 откройте модуль расширения в его дереве и поставьте точку останова (F9);
• ▶️ запустите отладку через меню Отладка → Начать отладку;
• 🔍 выполните в базе действие, которое вызывает этот код, и пройдите его по шагам.

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

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

Новая версия от разработчика

Обновление — та же загрузка файла поверх существующего расширения:

1. В списке расширений выделите нужное.
2. Загрузите новый .cfe той же командой из меню «Конфигурации» — содержимое заменится.
3. Выполните «Обновить конфигурацию базы данных» для расширения.

Если расширение хранит свои данные (в нём есть справочники или регистры), при смене их структуры появится окно с перечнем изменений. Прочитайте его: удаление реквизита в новой версии означает потерю данных в нём.

Временное отключение

Снимите флажок «Активно» в списке расширений. Расширение останется в базе со всеми данными, но перестанет применяться. Это первый шаг при поиске виновника, если после подключения что-то сломалось.

Удаление

Выделите расширение и нажмите «Удалить». Учтите разницу:

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

Резервная копия перед работой с расширениями

Копию делают до первой загрузки, до обновления и до удаления расширения. Варианта два, лучше сделать оба.

Выгрузка базы целиком. В Конфигураторе: Администрирование → Выгрузить информационную базу. Получится файл .dt с конфигурацией, расширениями и всеми данными. Делайте её в нерабочее время, когда в базе никто не проводит документы: так копия будет согласованной.

Из командной строки то же самое:

"C:\Program Files\1cv8\8.3.24.1342\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "" /DumpIB "D:\Backup\Buh_before_ext.dt"

Сохранение текущего расширения в файл. Перед заменой расширения новой версией сохраните старую: в окне списка расширений выделите его и в меню «Конфигурации» выберите сохранение в файл. Если новая версия не заработает, вы за минуту вернёте прежнюю загрузкой этого .cfe.

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

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