Загрузка файла .cfe в базу 1С 8.3 без снятия конфигурации с поддержки

· 9 мин

Содержание

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

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

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

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

📋 Что нужно на руках:

  • 📁 файл расширения с расширением .cfe (не .epf и не .erf — это внешние обработки и отчёты, они подключаются в другом месте);
  • 🏷 название конфигурации и релиза, для которых делалось расширение;
  • 🔑 пользователь с полными правами (роль «Полные права» или «Администратор системы»);
  • 💾 свежая резервная копия базы.

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

Совместимость. Главное, что нужно сверить:

Что сверитьГде посмотретьЧем грозит несовпадение
Конфигурация и релизСправка → О программе (кнопка с вопросом в заголовке окна)Заимствованный объект не найден, расширение не применится
Режим совместимостиСвойства конфигурации и свойства расширения в КонфигуратореРасширение с режимом выше, чем у конфигурации, не подключится
Версия платформыСправка → О программеРасширение, сохранённое на более новой платформе, может не открыться на старой
Назначение расширенияСвойства расширенияВлияет на порядок применения (см. ниже)

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

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

Способ 1: загрузка расширения через Конфигуратор

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

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

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

Шаг 2. Создайте пустое расширение и загрузите файл

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

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

Шаг 3. Примените расширение к базе

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

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

Если файла нет, а расширение есть в другой базе

Бывает, что доработка уже стоит в соседней базе (например, во второй организации), а .cfe потерян. Откройте ту базу в Конфигураторе, Конфигурация → Расширения конфигурации, выделите нужное расширение и выберите Конфигурация → Сохранить конфигурацию в файл.... Получится тот же .cfe, который дальше загружается по шагам выше.

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

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

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

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

Для клиент-серверной базы вместо /F укажите /S "сервер\имя_базы". Номер платформы в пути замените на свой. Результат пишется в файл из параметра /Out — проверьте его после запуска, ошибки на экран не выводятся.

Способ 2: подключение в пользовательском режиме

Бухгалтеру Конфигуратор не нужен: в типовых конфигурациях на БСП есть встроенная форма управления расширениями. Пути в основных конфигурациях:

КонфигурацияПуть к списку расширений
Бухгалтерия предприятия 3.0Администрирование → Печатные формы, отчеты и обработки → Расширения
ЗУП 3.1Администрирование → Печатные формы, отчеты и обработки → Расширения
Управление торговлей 11НСИ и администрирование → Печатные формы, отчеты и обработки → Расширения

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

Порядок действий:

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

Универсальный путь на случай, если в конфигурации нет такой формы (нетиповая или сильно урезанная): Все функции → Стандартные → Управление расширениями конфигурации. Команда «Все функции» включается в Сервис и настройки → Параметры флажком «Отображать команду “Все функции”» (в меню с тремя полосками в заголовке окна).

Остальные пользователи увидят расширение после того, как перезайдут в базу. Если кто-то работает весь день не выходя, он так и останется без изменений до перезапуска.

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

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

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

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

Порядок применения нескольких расширений

Когда в базе два-три расширения, они могут затрагивать одни и те же объекты. Тогда важен порядок, в котором платформа их накладывает.

Порядок определяется свойством «Назначение»:

НазначениеДля чего обычноПрименяется
ИсправлениеСрочный патч ошибки типовойПервым
АдаптацияДоработка под конкретную организациюВторым
ДополнениеНовая функциональность поверхПоследним

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

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

Ещё два свойства в списке, которые стоит знать:

  • 🔘 Активно — расширение можно временно выключить, не удаляя. Удобно для проверки, не оно ли ломает работу.
  • 🔁 Использовать в распределённой информационной базе — нужно включить, если база участвует в обмене РИБ и расширение должно попасть на узлы.

Как обновить или заменить уже загруженное расширение

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

В пользовательском режиме:

  1. Откройте список расширений.
  2. Выделите нужное расширение.
  3. Найдите в командной панели или в меню «Ещё» команду обновления из файла и укажите новый .cfe.
  4. Перезапустите программу.

В Конфигураторе:

  1. Конфигурация → Расширения конфигурации, выделите расширение.
  2. На всякий случай сохраните текущую версию: Конфигурация → Сохранить конфигурацию в файл....
  3. Загрузите новый файл в это же расширение: Конфигурация → Загрузить конфигурацию из файла....
  4. Выполните Обновить конфигурацию базы данных для расширения.

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

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

💡 Держите старые версии .cfe в одной папке с датой в имени файла (Pechat_2026-03-15.cfe). Если новая версия сломает печать, откатиться можно за минуту.

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

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

Диагностика: выберите симптом

Если не помогло

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

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

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

Чем расширение .cfe отличается от внешней обработки .epf?
Внешняя обработка — отдельный файл, который запускают вручную или подключают как печатную форму. Расширение встраивается в конфигурацию: может менять типовые формы, документы и модули, добавлять реквизиты.
Нужно ли снимать конфигурацию с поддержки, чтобы подключить расширение?
Нет. Расширение работает поверх конфигурации на поддержке, поэтому автоматическое обновление релизов сохраняется.
Можно ли подключить расширение в базе 1С:Фреш или другом облачном сервисе?
Зависит от политики сервиса. Обычно своё расширение передают на проверку провайдеру, а самостоятельная загрузка ограничена или доступна только в безопасном режиме.
Нужен ли монопольный доступ к базе для загрузки расширения?
Для загрузки через пользовательский режим другие сеансы не мешают, но увидят изменения только после перезапуска. Если расширение меняет структуру данных, лучше загружать его, когда в базе нет активной работы.
Сколько расширений можно подключить к одной базе?
Жёсткого практического лимита нет, но каждое расширение замедляет запуск сеанса и увеличивает риск конфликтов. Держите в базе только нужные и выключайте неиспользуемые.