1c Db Update

/db-update — Обновление конфигурации БД

Применяет изменения основной конфигурации к конфигурации базы данных (/UpdateDBCfg). Обязательный шаг после /db-load-cf, /db-load-xml, /db-load-git.

> EDT MCP: Если проект открыт в EDT и доступен EDT MCP-сервер - используй update_database через MCP вместо этого скила. MCP поддерживает полное и инкрементальное обновление с автоматической реструктуризацией. Используй этот скил только если пользователь явно просит обновление через конфигуратор.

Usage

/db-update [database]
/db-update dev
/db-update dev -Dynamic+

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

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

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

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

Команда

powershell.exe -NoProfile -File skills/1c-db-update/scripts/db-update.ps1 

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

| Параметр | Обязательный | Описание | |----------|:------------:|----------| | -V8Path | нет | Каталог bin платформы (или полный путь к 1cv8.exe) | | -InfoBasePath | | Файловая база | | -InfoBaseServer | | Сервер 1С (для серверной базы) | | -InfoBaseRef | * | Имя базы на сервере | | -UserName | нет | Имя пользователя | | -Password | нет | Пароль | | -Extension | нет | Обновить расширение | | -AllExtensions | нет | Обновить все расширения | | -Dynamic | нет | + — динамическое обновление, - — отключить | | -Server | нет | Обновление на стороне сервера | | -WarningsAsErrors | нет | Предупреждения считать ошибками |

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

Фоновое обновление (серверная база)

| Параметр | Описание | |----------|----------| | -BackgroundStart | Начать фоновое обновление | | -BackgroundFinish | Дождаться окончания | | -BackgroundCancel | Отменить | | -BackgroundSuspend | Приостановить | | -BackgroundResume | Возобновить |

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

| Код | Описание | |-----|----------| | 0 | Успешно | | 1 | Ошибка (см. лог) |

Предупреждения

• Если обновление не динамическое — потребуется монопольный доступ к базе (все пользователи должны выйти)
• Для серверных баз рекомендуется -Dynamic+ для обновления без остановки
• Если структура данных существенно изменилась (удаление реквизитов, изменение типов) — динамическое обновление может быть невозможно

Примеры

# Обычное обновление (файловая база)
powershell.exe -NoProfile -File skills/1c-db-update/scripts/db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"

# Динамическое обновление (серверная база)
powershell.exe -NoProfile -File skills/1c-db-update/scripts/db-update.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -Dynamic "+"

# Обновление расширения
powershell.exe -NoProfile -File skills/1c-db-update/scripts/db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение"

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Desko77
• Source: Desko77/claude-code-skills-1c
• License: MIT

Install and usage instructions live in the source repository linked above.