Подключаем файл .cfe к рабочей базе 1С 8.3 без сюрпризов

Расширение в файле .cfe устанавливают двумя способами. В типовых конфигурациях на БСП (Бухгалтерия 3.0, ЗУП 3.1, УТ 11) проще всего из пользовательского режима: Администрирование → Печатные формы, отчеты и обработки → Расширения, кнопка «Добавить из файла», затем перезапуск программы. Второй путь — Конфигуратор: Конфигурация → Расширения конфигурации, добавить пустое расширение, загрузить в него файл и обновить конфигурацию базы данных.

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

Что проверить до установки расширения CFE

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

📋 Что выяснить у разработчика или в описании расширения:

• 🧩 Для какой конфигурации и какого релиза собрано расширение. Расширение «заимствует» объекты основной конфигурации. Если в вашем релизе реквизит переименовали или удалили, расширение не применится.
• 🔢 Режим совместимости расширения. Он не должен быть выше, чем у платформы, на которой работает база. Номер платформы смотрите в Справка → О программе.
• 🛡️ Нужен ли небезопасный режим. Если расширение работает с файлами, COM-объектами, внешними компонентами или веб-сервисами, в безопасном режиме оно упадёт с ошибкой при первом вызове.
• 🗃️ Добавляет ли расширение свои данные: новые справочники, документы, регистры. Такое расширение при подключении меняет структуру хранения, и откатывать его сложнее.

Затем подготовьте базу:

1. Сделайте выгрузку .dt или резервную копию средствами СУБД. Для файловой базы достаточно скопировать каталог с файлом 1Cv8.1CD, пока в базе никто не работает .
2. Проверьте, что у вашего пользователя есть роль «Полные права» или «Администратор системы». Без них раздел расширений просто не виден.
3. Если файл пришёл от неизвестного автора, сначала разверните копию базы и поставьте расширение туда.

Способ 1: установка из пользовательского режима

Этот путь подходит бухгалтеру или администратору без опыта работы в Конфигураторе. Конфигурацию база при этом не переводит в монопольный режим, другие пользователи могут продолжать работу.

Типовые конфигурации на БСП

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

Конфигурации без БСП

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

1. Включите в параметрах программы Сервис и настройки → Параметры → Отображать команду «Все функции».
2. Откройте Все функции → Стандартные → Управление расширениями конфигурации.
3. Нажмите «Добавить» и выберите файл .cfe.
4. Проверьте флажки «Активно» и «Безопасный режим», затем перезапустите сеанс.

Способ 2: установка расширения CFE через Конфигуратор в файловом режиме

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

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

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

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

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

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

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

Особенности установки на сервере 1С

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

Что учесть на практике:

• 🖥️ Пути к файлам. Если расширение читает или пишет файлы на сервере, путь должен существовать на сервере 1С, а не на вашем компьютере. Права на каталог нужны учётной записи, под которой работает служба агента сервера.
• 🔐 Профиль безопасности. Если администратор кластера назначил базе профиль безопасности, он может запретить расширениям небезопасный режим. Тогда флажок в базе ничего не даст: настройку меняют в консоли кластера.
• 🧱 Внешние компоненты. Расширение с внешней компонентой требует, чтобы компонента подходила под разрядность и ОС сервера. 32-битная компонента не загрузится в 64-битный рабочий процесс.
• 🔄 Сеансы. Подключённое расширение видят только новые сеансы. Пользователям, которые сидят в базе с утра, надо перезапустить программу.

В пакетном режиме для серверной базы меняется только строка подключения:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /S"srv1c\buh_prod" /N"Администратор" /P"пароль" ^
  /LoadCfg "D:\Ext\Obmen.cfe" -Extension "Obmen" /UpdateDBCfg -Extension "Obmen" /Out "D:\Ext\log.txt"

Права доступа и безопасный режим расширения

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

Роли внутри расширения

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

1. Откройте Администрирование → Настройки пользователей и прав → Группы доступа (в БП 3.0 и ЗУП 3.1) или профили групп доступа.
2. В профиле группы найдите роль расширения: она появится в общем списке ролей.
3. Отметьте её и запишите профиль. Пользователям группы права добавятся после перезапуска.

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

Безопасный режим и защита от опасных действий

У каждого расширения есть два флажка, которые влияют на поведение:

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

Ошибки при установке и как их устранить

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

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

Как обновлять расширение и не потерять его после обновления 1С

Расширение живёт дольше одного обновления. За ним нужно следить при каждой смене релиза типовой конфигурации.

Замена файла расширения новой версией

• В пользовательском режиме выделите расширение в списке и загрузите новый файл через команду обновления в командной панели. Добавлять второе расширение с тем же назначением не нужно: две копии конфликтуют.
• В Конфигураторе выделите расширение в окне Расширения конфигурации, загрузите новый .cfe поверх и снова обновите конфигурацию БД.
• В пакетном режиме повторите команду /LoadCfg … -Extension с тем же именем.

Если расширение хранит свои данные, не удаляйте его ради «чистой» переустановки: при удалении такого расширения платформа удалит и его таблицы вместе с данными.

Порядок при обновлении типовой конфигурации

1. До обновления сохраните текущую версию расширения в файл. В Конфигураторе это команда «Сохранить конфигурацию в файл» в окне расширений, в пакетном режиме — /DumpCfg "файл.cfe" -Extension "Имя".
2. Обновите основную конфигурацию на копии базы.
3. Проверьте, применяется ли расширение к новому релизу. Если нет — запросите у автора обновлённый файл.
4. Только после этого обновляйте рабочую базу.

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

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