Extensions on the infobase side: composition and connection properties, checks, deletion. For extension sources — other skills, see “Related”.
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
Connection parameters
Read .v8-project.json from the project root and resolve the infobase:
- If the user specified connection parameters (path, server) — use them directly
- If they specified the infobase by name — search by id / alias / name in
.v8-project.json - If they did not specify — match the current Git branch with
databases[].branches - If the branch did not match — use
default
Platform — v8path of the found infobase entry, otherwise the root v8path. Not set in either place — -V8Path do not pass.
Command
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-cfe-admin.ps1" -Command <команда> <параметры>
Common parameters
| Parameter | Required | Description |
|---|---|---|
-Command <команда> |
yes | list / check / set-properties / delete |
-V8Path <путь> |
no | Platform bin directory or full path to 1cv8.exe / ibcmd.exe |
-InfoBasePath <путь> |
* | File infobase |
-InfoBaseServer <сервер> |
* | 1C server (for a server infobase) |
-InfoBaseRef <имя> |
* | Infobase name on the server |
-UserName <имя> |
no | Infobase user |
-Password <пароль> |
no | User password |
-Name <имя> |
cond. | Extension. Required for set-properties; в delete — instead of -All. Without it, list и check work on all extensions |
-All |
cond. | Only for delete: delete all extensions. Instead of -Name, and not together with it |
-AdditionalV8Arguments <список> |
no | Additional arguments 1cv8.exe comma-separated |
-AdditionalIbcmdArguments <список> |
no | Additional arguments ibcmd comma-separated, in the form --ключ=значение |
*— either-InfoBasePathis required, or the pair-InfoBaseServer+-InfoBaseRef
Parameters check
| Parameter | Description |
|---|---|
-Checks <список> |
apply — extension applicability, modules — syntax check, config — configuration checks (integrity, references, unused procedures and handlers). Comma-separated, by default apply,modules |
-Context <список> |
Syntax check contexts: ThinClient, WebClient, Server, ExternalConnection, ThickClientManagedApplication, ThickClientOrdinaryApplication, MobileClient and others. Comma-separated, by default ThinClient,Server |
Applicability and syntax check different things and do not replace each other. Only the extension is checked: errors of the configuration itself do not get in here.
Properties set-properties
| Parameter | Description |
|---|---|
-SafeMode <on/off> |
Safe mode |
-Active <on/off> |
Extension activity |
-UnsafeActionProtection <on/off> |
Protection against dangerous actions |
-UsedInDistributedInfobase <on/off> |
Use in distributed IB |
-Scope <область> |
infobase / data-separation |
-SecurityProfile <имя> |
Security profile |
Pass only what you change: an unspecified property remains as it was. An extension that first entered the database via loading is created with safe mode enabled, and in it the extension module is not applied.
Properties are managed by ibcmd — it is not present in every platform installation and works with a file database;
the remaining commands always work.
Related
| Task | Skill |
|---|---|
| Create an extension, borrow objects, intercept a method | /cfe-init, /cfe-borrow, /cfe-patch-method, /cfe-validate |
| Load extension sources into the database | /db-load-xml -Extension (from a Git commit — /db-load-git) |
Load a ready-made .cfe |
/db-load-cf -Extension |
| Unload the extension from the database | /db-dump-xml -Extension, /db-dump-cf -Extension |
| Update the database configuration after loading | /db-update -Extension |
| Check the drift of controlled methods against the sources | /cfe-patch-method -Check |
Examples
# Что подключено к базе
... -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"