/db-cfe-admin — Управление расширениями конфигурации
Расширения на стороне базы: состав и свойства подключения, проверки, удаление. Про исходники расширения — другие навыки, см. «Смежное».
Usage
/db-cfe-admin list [database] /db-cfe-admin check [database] [-Name Расш1] /db-cfe-admin set-properties [database] -Name Расш1 -SafeMode off /db-cfe-admin delete [database] -Name Расш1
Параметры подключения
Прочитай .v8-project.json из корня проекта и разреши базу:
- Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
- Если указал базу по имени — ищи по id / alias / name в
.v8-project.json - Если не указал — сопоставь текущую ветку Git с
databases[].branches - Если ветка не совпала — используй
default
Платформа — v8path найденной записи базы, иначе корневой v8path. Не задан ни там, ни там — -V8Path не передавай.
Команда
powershellpowershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-cfe-admin.ps1" -Command <команда> <параметры>
Общие параметры
| Параметр | Обязательный | Описание |
|---|---|---|
-Command <команда> | да | list / check / set-properties / delete |
-V8Path <путь> | нет | Каталог bin платформы или полный путь к 1cv8.exe / ibcmd.exe |
-InfoBasePath <путь> | * | Файловая база |
-InfoBaseServer <сервер> | * | Сервер 1С (для серверной базы) |
-InfoBaseRef <имя> | * | Имя базы на сервере |
-UserName <имя> | нет | Пользователь базы |
-Password <пароль> | нет | Пароль пользователя |
-Name <имя> | усл. | Расширение. Обязателен для set-properties; в delete — вместо -All. Без него list и check работают по всем расширениям |
-All | усл. | Только для delete: удалить все расширения. Вместо -Name, а не вместе с ним |
-AdditionalV8Arguments <список> | нет | Доп. аргументы 1cv8.exe через запятую |
-AdditionalIbcmdArguments <список> | нет | Доп. аргументы ibcmd через запятую, в форме --ключ=значение |
*— нужен либо-InfoBasePath, либо пара-InfoBaseServer+-InfoBaseRef
Параметры check
| Параметр | Описание |
|---|---|
-Checks <список> | apply — применимость расширения, modules — синтаксическая проверка, config — проверки конфигурации (целостность, ссылки, неиспользуемые процедуры и обработчики). Через запятую, по умолчанию apply,modules |
-Context <список> | Контексты синтаксической проверки: ThinClient, WebClient, Server, ExternalConnection, ThickClientManagedApplication, ThickClientOrdinaryApplication, MobileClient и др. Через запятую, по умолчанию ThinClient,Server |
Применимость и синтаксис проверяют разное и друг друга не заменяют. Проверяется только расширение: ошибки самой конфигурации сюда не попадают.
Свойства set-properties
| Параметр | Описание |
|---|---|
-SafeMode <on/off> | Безопасный режим |
-Active <on/off> | Активность расширения |
-UnsafeActionProtection <on/off> | Защита от опасных действий |
-UsedInDistributedInfobase <on/off> | Использование в распределённой ИБ |
-Scope <область> | infobase / data-separation |
-SecurityProfile <имя> | Профиль безопасности |
Передавай только то, что меняешь: не указанное свойство остаётся как было. Расширение, впервые попавшее в базу загрузкой, создаётся с включённым безопасным режимом, а в нём расширение модуля не применяется.
Свойствами управляет ibcmd — он есть не в каждой установке платформы и работает с файловой базой;
остальные команды работают всегда.
Смежное
| Задача | Навык |
|---|---|
| Создать расширение, заимствовать объекты, перехватить метод | /cfe-init, /cfe-borrow, /cfe-patch-method, /cfe-validate |
| Загрузить исходники расширения в базу | /db-load-xml -Extension (из коммита Git — /db-load-git) |
Загрузить готовый .cfe | /db-load-cf -Extension |
| Выгрузить расширение из базы | /db-dump-xml -Extension, /db-dump-cf -Extension |
| Обновить конфигурацию базы после загрузки | /db-update -Extension |
| Проверить дрейф контролируемых методов по исходникам | /cfe-patch-method -Check |
Примеры
powershell# Что подключено к базе ... -Command list -InfoBasePath "C:\Bases\MyDB" # Проверить расширение ... -Command check -InfoBasePath "C:\Bases\MyDB" -Name "Расш1" # Синтаксическая проверка в контексте веб-клиента ... -Command check -InfoBasePath "C:\Bases\MyDB" -Checks modules -Context WebClient,Server # Снять безопасный режим ... -Command set-properties -InfoBasePath "C:\Bases\MyDB" -Name "Расш1" -SafeMode off # Отключить, не удаляя ... -Command set-properties -InfoBasePath "C:\Bases\MyDB" -Name "Расш1" -Active off # Убрать расширение из базы ... -Command delete -InfoBasePath "C:\Bases\MyDB" -Name "Расш1"
