Загрузка файла .cfe через Конфигуратор: от подготовки до проверки
Содержание
Чтобы установить расширение
1С в Конфигураторе, откройте базу в режиме Конфигуратор, выберите Конфигурация → Расширения конфигурации, добавьте новое расширение и загрузите в него файл .cfe. Затем обновите конфигурацию базы данных для этого расширения и перезапустите пользовательские сеансы. Весь процесс занимает 5–10 минут, если расширение совместимо с текущим релизом.
Есть и другие пути. Через пользовательский режим (Все функции → Стандартные → Управление расширениями конфигурации или раздел администрирования типовой конфигурации) удобно ставить готовые доработки без доступа к Конфигуратору. Через командную строку — массово, на десятки баз. Конфигуратор выбирают, когда нужно видеть состав расширения, настроить его свойства вручную и сразу разобрать ошибки применения.
Что проверить до установки расширения
Расширения работают на платформе 1С:Предприятие 8.3, начиная с версии 8.3.6. Но реальные требования задаёт само расширение: в его свойствах есть режим совместимости, и платформа должна его поддерживать.
Перед началом проверьте пять вещей:
- 🔑 Права пользователя. Для входа в Конфигуратор нужна роль с правом «Администрирование». Если в базе нет списка пользователей, Конфигуратор откроется без пароля.
- 🧩 Номер платформы. Файл
.cfe, сохранённый на платформе с более высоким номером, может не загрузиться на платформе с более низким. Уточните у разработчика минимальный номер. - 📄 Релиз типовой конфигурации. Расширение заимствует объекты основной конфигурации. Если разработчик делал его под другой релиз, часть объектов может не совпасть.
- 💾 Резервная копия. Перед установкой выгрузите базу в .dt или сделайте копию средствами СУБД. Расширение с собственными данными при удалении теряет эти данные.
- 👥 Окно для работы. Если расширение меняет структуру данных, для обновления может понадобиться монопольный режим. Договоритесь с пользователями о времени.
Сначала поставьте расширение в копию рабочей базы. Если оно применилось и отчёты открываются — повторите на рабочей.
Чем отличаются способы установки
| Способ | Когда выбирают | Что нужно |
|---|---|---|
| Конфигуратор | Нужно видеть состав и свойства, разбирать ошибки | Право «Администрирование», запуск Конфигуратора |
| Пользовательский режим | Готовое расширение от поставщика, без доработок | Право «Администрирование расширений конфигурации» |
| Командная строка | Установка на много баз по расписанию или скриптом | Доступ к серверу, учётные данные пользователя базы |
Запуск Конфигуратора для работы с расширениями
Откройте стартовое окно 1С, выберите нужную базу и нажмите кнопку Конфигуратор. Войдите под пользователем с административными правами.
Монопольный режим на этом этапе не нужен. Список расширений можно открыть, пока пользователи работают в базе. Блокировка понадобится позже, при обновлении структуры данных, и платформа сама сообщит об этом.
Если основная конфигурация ещё не открыта, откройте её: Конфигурация → Открыть конфигурацию. Затем выберите Конфигурация → Расширения конфигурации. Появится окно со списком установленных расширений. В новой базе он пустой.
В этом окне видны колонки с ключевыми свойствами: имя, синоним, версия, назначение, флаги активности и безопасного режима. По ним удобно сверяться после загрузки.
Если в базе есть незавершённое обновление основной конфигурации (конфигурация изменена, но не применена к базе данных), сначала закончите его или откатите. Иначе при проверке расширения сложно понять, что именно вызвало ошибку.
Загрузка файла расширения: пошагово
Порядок действий для файла .cfe в окне «Расширения конфигурации
»:
- Нажмите Добавить. В списке появится новое пустое расширение с именем вида
Расширение1. - Выделите его строку.
- В командной панели окна откройте подменю Конфигурация и выберите Загрузить конфигурацию из файла ….
- Укажите путь к файлу
.cfeи нажмите Открыть. - Подтвердите замену содержимого. Пустое расширение получит имя, префикс, состав и свойства из файла.
- Платформа предложит обновить конфигурацию базы данных. Можно согласиться сразу или сделать это позже, после проверки свойств.
После загрузки имя в списке сменится на имя из файла, например ДоработкиПечатныхФорм. Двойным щелчком по строке откроется дерево объектов расширения: собственные и заимствованные из основной конфигурации.
Если расширение с таким именем уже есть
Имена расширений в базе уникальны. Если вы ставите новую версию уже установленного расширения, не добавляйте ещё одну строку. Выделите существующее расширение и загрузите файл прямо в него — содержимое заменится, данные расширения сохранятся, если структура совместима.
Перед заменой сохраните текущую версию: то же подменю, команда Сохранить конфигурацию в файл…. Получится откат на случай, если новая версия не применится.
Как устроен файл .cfe
Файл .cfe содержит только расширение, без основной конфигурации. Его размер обычно от десятков килобайт до нескольких мегабайт. Открыть его в Конфигураторе как обычную конфигурацию нельзя — только загрузить в расширение.
Свойства расширения и порядок применения
Загрузка не означает, что расширение заработает именно так, как задумал разработчик. Проверьте свойства — в списке расширений или в палитре свойств корня расширения.
| Свойство | Что делает | Что выбрать |
|---|---|---|
| Активно | Включает или отключает применение | Включено. Снимите флажок, чтобы временно отключить без удаления |
| Безопасный режим | Ограничивает код расширения: нет доступа к файлам, внешним компонентам, COM | Включён, если код не требует опасных операций. Иначе часть функций выдаст ошибку |
| Защита от опасных действий | Предупреждает пользователя перед потенциально опасными операциями кода | По рекомендации разработчика |
| Назначение | Исправление, Адаптация или Дополнение | Задаёт разработчик, менять не нужно |
| Режим совместимости | Версия, под которую написан код | Не выше версии платформы в базе |
Порядок, в котором применяются расширения
Если в базе несколько расширений, они накладываются на основную конфигурацию по очереди. Сначала идут расширения с назначением «Исправление», затем «Адаптация», затем «Дополнение». Внутри одной группы порядок определяется последовательностью добавления.
На практике это важно, когда два расширения перехватывают один и тот же обработчик или меняют одну форму. Тогда итог зависит от порядка, и результат может отличаться от ожидаемого.
Порядок внутри группы удобнее не двигать, а держать под контролем: ставьте исправления от поставщика как «Исправление», а свои доработки — как «Дополнение». Назначение меняет разработчик в свойствах корня расширения.
Роли расширения
Если расширение добавляет новые объекты (справочники, отчёты, обработки), у пользователей должны быть права на них. Обычно разработчик включает в расширение роль. После установки откройте карточку пользователя или группы доступа в пользовательском режиме и добавьте эту роль.
Без роли новый отчёт не появится в интерфейсе, а пользователь получит сообщение о нарушении прав доступа.
Обновление конфигурации базы данных для расширения
Загрузка файла и обновление базы данных — два отдельных шага. Пока второй не выполнен, расширение лежит в Конфигураторе, но пользователи его не видят.
Как обновить:
- Выделите расширение в списке «Расширения конфигурации».
- В подменю Конфигурация выберите Обновить конфигурацию базы данных.
- Изучите окно с перечнем изменений и нажмите Принять.
Если расширение только перехватывает процедуры или меняет формы, обновление проходит быстро и без блокировки. Если оно добавляет реквизиты к заимствованным объектам или создаёт свои таблицы, платформе нужно изменить структуру данных. Тогда она может потребовать монопольный доступ.
Для монопольного режима придётся завершить сеансы пользователей. Несохранённые данные у них пропадут. Предупредите людей заранее и делайте это вне рабочего времени. В клиент-серверной базе сеансы видны в консоли администрирования серверов.
После обновления пользователям, которые уже работали в базе, нужно перезапустить 1С. Расширения подключаются при старте сеанса, поэтому открытый сеанс изменений не увидит.
Как проверить, что расширение работает
Проверка в три уровня — от самого простого к самому показательному.
1. Список в пользовательском режиме. Запустите 1С:Предприятие и откройте Все функции → Стандартные → Управление расширениями конфигурации. Расширение должно быть в списке, без пометок об ошибке. Если меню «Все функции» скрыто, включите его: главное меню → Сервис → Параметры → флажок «Отображать команду „Все функции“».
2. Объекты в интерфейсе. Найдите то, что добавляет расширение: новую печатную форму, отчёт, кнопку на форме документа. Откройте и запустите.
3. Изменённое поведение. Если расширение исправляет алгоритм (например, заполнение документа), проверьте на тестовом документе, что результат изменился. Сравните с копией базы без расширения.
Если что-то не так
Для быстрой диагностики откройте модули расширения в Конфигураторе и выполните синтаксическую проверку (Ctrl+F7 в открытом модуле). Ошибки в коде и обращения к несуществующим реквизитам будут видны сразу.
Ещё полезнее отладка: поставьте точку останова в модуле расширения, запустите 1С:Предприятие в режиме отладки клавишей F5 и выполните действие, которое должно его вызвать. Если остановки нет — расширение не применяется или код не вызывается.
Установка расширения из командной строки
Когда баз много, Конфигуратор удобно запускать в пакетном режиме. Те же два шага — загрузка и обновление — выполняются параметрами 1cv8.
Для файловой базы:
"C:\Program Files\1cv8\8.3.24.1342\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль" /LoadCfg "D:\ext\Dorabotki.cfe" -Extension "ДоработкиПечатныхФорм" /UpdateDBCfg -Extension "ДоработкиПечатныхФорм" /Out "D:\ext\log.txt"
Для клиент-серверной базы вместо /F указывают /S "server\base".
Что здесь важно:
- 📌 Путь к
1cv8.exeподставьте свой — номер в каталоге совпадает с установленной версией платформы. - 📌 Имя после
-Extension— внутреннее имя расширения (свойство «Имя»), а не синоним. - 📌 Параметр
/Outпишет журнал выполнения. Без него ошибку пакетного режима не увидеть. - 📌 Пароль в командной строке виден в списке процессов. Для регулярных задач храните учётные данные в защищённом месте и ограничьте доступ к скрипту.
Сохранить расширение в файл перед заменой можно командой /DumpCfg "путь.cfe" -Extension "Имя".
Ошибки при установке и как их исправить
Большинство проблем проявляется при загрузке файла или при обновлении базы данных. Ниже — частые симптомы и что с ними делать.
Если после обновления типовой конфигурации расширение перестало применяться, не удаляйте его сразу. Снимите флажок «Активно» — база заработает, а данные расширения сохранятся до выхода исправленной версии.