Расширение .cfe в базу 1С: загрузка через конфигуратор от и до
Содержание
Расширение ставится в конфигураторе так: меню Конфигурация → Расширения конфигурации, добавить новое расширение, загрузить в него файл .cfe, снять или оставить флаги безопасности и обновить конфигурацию
базы данных. Дальше 1С перезапускают, и изменения работают в обычном режиме.
Звучит просто, пока не упрёшься в «не хватает прав», «расширение не совместимо» или в зависший монопольный доступ. Ниже — порядок, который избавляет от этих сюрпризов, плюс то, чего обычно нет в коротких инструкциях: пакетная установка из командной строки, удаление и проверка конфликтов.
Подготовка: что проверить до загрузки файла
Расширение меняет поведение рабочей базы. Две минуты подготовки экономят часы разбора.
Что должно быть под рукой
- ✅ Доступ к базе в режиме
Конфигуратор(пользователь с ролью администратора). - ✅ Монопольный доступ: все пользователи вышли, фоновые задания остановлены.
- ✅ Файл расширения с окончанием
.cfe. - ✅ Свежая выгрузка базы — файл
.dtили копия каталога файловой базы.
Сделайте копию базы до первой загрузки. Откатить расширение можно удалением, но если оно успело изменить данные при первом запуске, вернуть их поможет только копия.
Совместимость
У расширения есть режим совместимости и привязка к версии платформы. Если оно собрано под более новую платформу, чем у вас, конфигуратор откажется его загружать. Узнайте у автора, под какую платформу и релиз конфигурации оно написано, и сравните со своими значениями в пункте Справка → О программе.
Для типовых конфигураций проверьте и другое: стоит ли у вас конфигурация на поддержке и не изменена ли она. Расширению это безразлично, но если оно «перехватывает» процедуру, которую вы уже правили в основной конфигурации, поведение будет неожиданным.
Откуда берут файл расширения и как проверить его перед загрузкой
Файл приходит из трёх источников:
| Источник | Что учесть |
|---|---|
| Разработчик, который писал под вас | Попросите описание: что меняет, какие объекты затрагивает |
| Партнёр или франчайзи, готовое решение | Спросите версию, для которой собрано, и срок поддержки |
| Выгрузка из другой вашей базы | Убедитесь, что конфигурации совпадают по релизу |
Файл из интернета с неизвестным автором ставить в рабочую базу нельзя. Расширение — это исполняемый код с доступом к данным. Минимум: сначала запустить в тестовой копии, внимательно прочитать, какие права и режимы оно запрашивает.
Проверка целостности
Скачанный файл мог оборваться на середине. Сравните размер с указанным автором. Если автор даёт контрольную сумму, проверьте её в командной строке:
certutil -hashfile "C:\ext\МоёРасширение.cfe" SHA256
Результат должен совпасть с тем, что прислал автор. Не совпал — файл повреждён или подменён, запросите заново.
Заодно посмотрите на расположение файла. Путь с кириллицей и пробелами обычно работает, но на сетевых дисках и длинных путях загрузка иногда падает без внятной причины. Скопируйте файл в короткий локальный каталог вроде C:\ext\.
Установка расширения через конфигуратор: порядок действий
Проверено на платформе 8.3. Названия пунктов могут чуть отличаться по версиям, поэтому ориентируйтесь на смысл, а не на буквы.
Шаг 1. Запустите базу в режиме конфигуратора
В списке баз выберите нужную и нажмите Конфигуратор. Если база занята пользователями, платформа предупредит о невозможности монопольного доступа — завершите их сеансы (в консоли администрирования кластера или через Администрирование → Активные пользователи в самой базе).
Шаг 2. Откройте список расширений
Откройте меню Конфигурация → Расширения конфигурации. Если расширений ещё нет, окно будет пустым.
Шаг 3. Добавьте новое расширение
Нажмите Добавить. Платформа создаст пустое расширение и предложит указать:
- Имя — техническое, без пробелов и спецсимволов, лучше латиницей или кириллицей без точек. Для загружаемого из файла расширения имя потом заменится именем из файла.
- Синоним — удобное название для людей.
- Назначение —
Исправление,ДополнениеилиДобавление. Если вы не автор, берите то, что указал разработчик.
Шаг 4. Загрузите файл .cfe
Выделите добавленное расширение и выполните команду загрузки из файла. В зависимости от версии она находится в меню Конфигурация либо в командной панели окна расширений. В диалоге выберите ваш .cfe.
Платформа прочитает файл и заменит им содержимое пустого расширения. Если в списке объектов появились справочники, обработки, модули — загрузка прошла.
Шаг 5. Выставьте настройки безопасности
У расширения есть три флага, и неправильный выбор — частая причина «не работает ».
| Флаг | Когда снимать | Риск |
|---|---|---|
Безопасный режим | Расширение обращается к файлам, COM, внешним ресурсам | Выключенный режим даёт коду больше свободы |
Защита от опасных действий | Расширение должно запускать внешние программы | Пользователя перестанут предупреждать |
Использовать основные роли для всех пользователей | Новых ролей в расширении нет, права берутся из основной конфигурации | Пользователи получат то, что есть у основных ролей |
Оставляйте режимы включёнными, пока не убедитесь, что без снятия расширение не работает. Снимать флаги вслепую — плохая привычка.
Шаг 6. Обновите конфигурацию базы данных
Нажмите F7 (Конфигурация → Обновить конфигурацию базы данных). Расширения применяются к базе только после этого. Платформа покажет список изменений структуры — подтвердите.
Для больших баз обновление идёт от нескольких секунд до десятков минут. Не закрывайте конфигуратор, пока не появится сообщение об успешном завершении.
Шаг 7. Запустите 1С в обычном режиме
Закройте конфигуратор, запустите 1С:Предприятие и проверьте, что новая функциональность на месте.
Если расширение добавило новые пункты в меню или команды, а пользователи их не видят, проблема почти всегда в правах. Откройте профиль пользователя и проверьте роли, которые принесло расширение.
Типичные ошибки загрузки и что с ними делать
Здесь только то, что отличается от очевидных шагов выше.
.cfe, а, например, выгрузка конфигурации .cf. Проверьте расширение файла и его размер.Как проверить, что расширение действительно работает
Загрузилось — не значит работает. Сделайте короткую проверку.
- Откройте в режиме
1С:Предприятиету часть интерфейса, которую расширение должно менять, и выполните сценарий, ради которого оно ставилось. - Посмотрите журнал регистрации: события с уровнем
Ошибкасразу после первого запуска покажут, что расширение пишет об исключениях. - Откройте то, что расширение не должно трогать: стандартные документы, отчёты, печатные формы. Они не должны изменить поведение.
Конфликты между расширениями
Если несколько расширений меняют один и тот же объект, они применяются в определённом порядке. Порядок меняется в окне Расширения конфигурации стрелками вверх и вниз. Расширение, стоящее ниже, «видит» результат работы стоящих выше.
Признаки конфликта: после установки второго расширения перестаёт работать первое, либо один и тот же обработчик вызывается дважды. Лечится так:
- отключить расширения по очереди и найти виновника;
- сменить порядок и повторить проверку;
- если два расширения правят один модуль, договориться с авторами об объединении.
Расширение с флагом Активно, но не загруженное в базу данных, не работает. Статус видно в списке: если рядом пометка об ожидании обновления, выполните F7.
Установка из командной строки: когда баз много
Если нужно поставить одно расширение в десять баз, кликать в конфигураторе скучно. Платформа умеет всё в пакетном режиме.
Загрузка файла расширения в файловую базу :
"C:\Program Files\1cv8\8.3.XX.XXXX\bin\1cv8.exe" DESIGNER /F "D:\bases\work" /N "Админ" /P "пароль" /DisableStartupDialogs /LoadCfg "C:\ext\МоёРасширение.cfe" -Extension "МоёРасширение" /UpdateDBCfg /Out "C:\ext\log.txt"
Для клиент-серверной базы вместо /F указывают /S "сервер\имя_базы". Версию платформы в пути нужно заменить на вашу.
Что здесь важно:
- 🔹
-Extensionзадаёт имя расширения: если такого ещё нет, оно создастся; - 🔹
/UpdateDBCfgприменяет изменения к базе в том же запуске; - 🔹
/Outпишет лог — по нему видно, чем закончилась операция; - 🔹 пароль в командной строке виден в списке процессов; для скриптов заведите отдельного технического пользователя с минимальными правами.
Чтобы разослать одно расширение по списку баз, оберните команду в цикл и читайте лог после каждой. Не запускайте установку параллельно в одну базу.
Как удалить или отключить расширение
Отключить — значит оставить в базе, но не применять. Удалить — убрать целиком.
Отключение
В окне Расширения конфигурации снимите флаг Активно и выполните F7. Расширение остаётся в списке, его можно включить снова. Это хороший способ быстро проверить, не оно ли ломает работу.
Удаление
Выделите расширение в списке, нажмите Удалить, подтвердите и снова обновите конфигурацию базы данных. Из командной строки то же самое делает ключ /DeleteCfg с параметром -Extension.
Если расширение создавало собственные справочники или регистры, удаление уберёт и их данные. Посмотрите состав расширения заранее и при необходимости выгрузите данные.
Перед удалением полезно выгрузить само расширение обратно в файл (Конфигурация → выгрузка расширения в файл .cfe). Тогда у вас останется рабочая копия.
Что делать, чтобы расширения не мешали работе базы
Расширения при обновлении типовой конфигурации иногда ломаются. Несколько привычек делают жизнь спокойнее.
- 📌 Ведите список расширений: имя, автор, версия, дата установки, зачем нужно.
- 📌 Перед обновлением релиза сначала тестируйте в копии: расширения могут ссылаться на объекты, которые поменялись.
- 📌 Не держите «мёртвые» расширения. Каждое увеличивает время запуска и усложняет поддержку.
- 📌 Выгружайте текущие расширения в файлы после каждой правки — это дешевле, чем потом искать исходники у ушедшего подрядчика.
- 📌 Для нескольких расширений на один объект назначьте одного ответственного: он следит за порядком.
Если расширение отвечает за изменение печатной формы или добавление реквизита, обычно хватает простого. Сложные доработки с подпиской на события лучше проверять отдельно после каждого обновления платформы.
Частые вопросы
Чем расширение отличается от изменения конфигурации?
Можно ли установить расширение в базу на поддержке?
Нужен ли монопольный доступ для установки?
Как узнать, какие расширения уже стоят в базе?
Конфигурация → Расширения конфигурации в конфигураторе. В режиме 1С:Предприятие список виден администратору в разделе администрирования, в сведениях о программе.