desko77/claude-code-skills-1c/1c-db-cfe-admin

/db-cfe-admin - Расширения в информационной базе

Управляет расширениями, которые уже лежат в информационной базе: список, проверка, свойства, удаление. Движок один - ibcmd. Конфигуратор и EDT не вызываются.

Когда применять

• EDT недоступна, а расширение в базе надо включить, выключить, снять с безопасного режима

или удалить.

• Нужно увидеть, какие расширения есть в базе, и проверить, применимо ли названное расширение.

Когда не применять

• Проект открыт в EDT и доступен AI-EDT. Свойства расширения в базе меняет infobase_admin.
• Нужно создать исходники расширения, заимствовать объект или собрать файл .cfe.

Это скилы 1c-cfe-*.

• Нужно загрузить .cfe или XML в базу. Это /db-load-cf и /db-load-xml.

Параметры подключения

Прочитай .v8-project.json из корня проекта. Возьми v8path (каталог bin или путь к ibcmd.exe) и разреши базу:

1. Если пользователь указал параметры подключения (путь, сервер) - используй напрямую
2. Если указал базу по имени - ищи по id / alias / name в .v8-project.json
3. Если не указал - сопоставь текущую ветку Git с databases[].branches
4. Если ветка не совпала - используй default

Если v8path не задан - автоопределение: Get-ChildItem "C:\Program Files\1cv8\*\bin\ibcmd.exe" | Sort FullName | Select -Last 1 Если файла нет - попроси путь к ibcmd.exe в -V8Path. Если использованная база не зарегистрирована - после выполнения предложи добавить через /db-list add.

ibcmd не ходит в кластер 1С. Файловая база передается ключом --db-path (-InfoBasePath). Пара -InfoBaseServer и -InfoBaseRef передается как --db-server и --db-name: сервер и имя базы СУБД, как в справке ibcmd. Тип СУБД - -Dbms (--dbms). Без -Dbms утилита считает базу файловой. Если заданы и путь, и пара сервер/имя, в команду попадает пара: так же цель выбирает защита боевой базы.

База с ролью prod в .v8-project.json отказывает операциям set-properties и delete: скрипт завершается кодом 1, пока не передан -AllowProd. Операции list и check защиту не проходят: они базу не меняют.

Команда

powershell.exe -NoProfile -File skills/1c-db-cfe-admin/scripts/db-cfe-admin.ps1 <операция> <параметры>

Порт Python: skills/1c-db-cfe-admin/scripts/db-cfe-admin.py. Имена параметров те же. -WhatIf и --dry-run печатают команду ibcmd и не запускают ее.

Операции

check соответствует команде infobase config check из справки ibcmd: проверка конфигурации названного расширения. Ключ -Name обязателен.

Параметры скрипта

* - нужен либо -InfoBasePath, либо пара -InfoBaseServer + -InfoBaseRef

** - обязателен для check, set-properties и delete без -All

Свойства set-properties

Хотя бы одно свойство обязательно. Значения yes и no - как в справке ibcmd.

Коды возврата

Ограничения

• ibcmd.exe входит в компонент автономного сервера и ставится с платформой не всегда: в каталоге

bin установленной платформы его может не быть. Тогда путь к ibcmd.exe передается в -V8Path.

• Для серверной базы ibcmd подключается к СУБД: -InfoBaseServer и -InfoBaseRef - сервер и имя базы

СУБД, а не кластер 1С. Защита боевой базы сравнивает их с полями server и ref записи .v8-project.json; если там записаны имена кластера, запись не совпадет и защита не сработает. Для серверной боевой базы указывать в записи сервер и имя базы СУБД либо не выполнять изменяющие операции без явной команды пользователя.

• set-properties -SecurityProfileName в одном вызове с другими свойствами может вернуть безопасный

режим во включенное состояние (замер 8.3.27.1989): после вызова проверить свойства командой list.

Примеры

# Список расширений файловой базы
powershell.exe -NoProfile -File skills/1c-db-cfe-admin/scripts/db-cfe-admin.ps1 list -InfoBasePath "C:\Bases\MyDB"
 
# Проверка применимости расширения
powershell.exe -NoProfile -File skills/1c-db-cfe-admin/scripts/db-cfe-admin.ps1 check -InfoBasePath "C:\Bases\MyDB" -Name "МоеРасширение"
 
# Снять безопасный режим и оставить расширение активным
powershell.exe -NoProfile -File skills/1c-db-cfe-admin/scripts/db-cfe-admin.ps1 set-properties -InfoBasePath "C:\Bases\MyDB" -Name "МоеРасширение" -SafeMode no -Active yes
 
# Удаление
powershell.exe -NoProfile -File skills/1c-db-cfe-admin/scripts/db-cfe-admin.ps1 delete -InfoBasePath "C:\Bases\MyDB" -Name "МоеРасширение"
 
# Команда без запуска
powershell.exe -NoProfile -File skills/1c-db-cfe-admin/scripts/db-cfe-admin.ps1 delete -InfoBasePath "C:\Bases\MyDB" -Name "МоеРасширение" -WhatIf