Управление расширениями конфигурации в информационной базе 1С. Используй когда нужно узнать какие расширения подключены к базе, выполнить проверку применимости или синтаксическую проверку, изменить безопасный режим или активность, удалить расширение из базы
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Расширения на стороне базы: состав и свойства подключения, проверки, удаление. Про исходники расширения — другие навыки, см. «Смежное».
/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 из корня проекта и разреши базу:
.v8-project.jsondatabases[].branchesdefaultПлатформа — v8path найденной записи базы, иначе корневой v8path. Не задан ни там, ни там — -V8Path не передавай.
powershell.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 |
# Что подключено к базе
... -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"
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Точечное редактирование конфигурации 1С. Используй когда нужно изменить свойства конфигурации, добавить или удалить объект из состава, настроить роли по умолчанию, поменять раскладку панелей, настроить начальную страницу
The English summary is being prepared. Showing the original description.
Анализ структуры конфигурации 1С — свойства, состав, счётчики объектов. Используй для обзора конфигурации — какие объекты есть, сколько их, какие настройки
The English summary is being prepared. Showing the original description.
Создать пустую конфигурацию 1С (scaffold XML-исходников). Используй когда нужно начать новую конфигурацию с нуля
The English summary is being prepared. Showing the original description.
Валидация конфигурации 1С. Используй после создания или модификации конфигурации для проверки корректности
The English summary is being prepared. Showing the original description.
Заимствование объектов из конфигурации 1С в расширение (CFE). Используй когда нужно перехватить метод, изменить форму или добавить реквизит к существующему объекту конфигурации
The English summary is being prepared. Showing the original description.
Анализ расширения конфигурации 1С (CFE) — состав, заимствованные объекты, перехватчики, проверка переноса. Используй когда нужно понять что содержит расширение или проверить перенесены ли вставки в конфигурацию
The English summary is being prepared. Showing the original description.