/db-dump-xml - Выгрузка конфигурации в XML
Выгружает конфигурацию информационной базы в XML-файлы (исходники). Поддерживает полную, инкрементальную, частичную выгрузку и обновление ConfigDumpInfo.
EDT MCP: Если проект открыт в EDT и доступен EDT MCP-сервер - этот скил не нужен. EDT работает напрямую с XML-исходниками, выгрузка из БД не требуется. Используй этот скил только если пользователь явно просит выгрузку через конфигуратор.
Usage
/db-dump-xml [database] [outputDir]
/db-dump-xml dev src/config
/db-dump-xml dev src/config -Mode Full
/db-dump-xml dev src/config -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
Параметры подключения
Прочитай .v8-project.json из корня проекта. Возьми v8path (путь к платформе) и разреши базу:
- Если пользователь указал параметры подключения (путь, сервер) - используй напрямую
- Если указал базу по имени - ищи по id / alias / name в
.v8-project.json - Если не указал - сопоставь текущую ветку Git с
databases[].branches - Если ветка не совпала - используй
defaultЕслиv8pathне задан - автоопределение:Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1Если файла нет - предложи/db-list add. Если использованная база не зарегистрирована - после выполнения предложи добавить через/db-list add. Если в записи базы указанconfigSrc- используй как каталог выгрузки по умолчанию.
Команда
powershell.exe -NoProfile -File skills/1c-db-dump-xml/scripts/db-dump-xml.ps1 <параметры>
Параметры скрипта
| Параметр | Обязательный | Описание |
|---|---|---|
-V8Path <путь> |
нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
-InfoBasePath <путь> |
* | Файловая база |
-InfoBaseServer <сервер> |
* | Сервер 1С (для серверной базы) |
-InfoBaseRef <имя> |
* | Имя базы на сервере |
-UserName <имя> |
нет | Имя пользователя |
-Password <пароль> |
нет | Пароль |
-ConfigDir <путь> |
да | Каталог для выгрузки |
-Mode <режим> |
нет | Full / Changes (по умолч.) / Partial / UpdateInfo |
-Objects <список> |
для Partial | Имена объектов через запятую |
-Extension <имя> |
нет | Выгрузить расширение |
-AllExtensions |
нет | Выгрузить все расширения |
-Format <формат> |
нет | Hierarchical (по умолч.) / Plain |
-StrictLog |
нет | Отказ в журнале поднимает код возврата до 1, даже если платформа вернула 0 |
*- нужен либо-InfoBasePath, либо пара-InfoBaseServer+-InfoBaseRef
Режимы выгрузки
| Режим | Описание |
|---|---|
Full |
Полная выгрузка - все объекты конфигурации |
Changes |
Инкрементальная - только измененные с последней выгрузки (использует ConfigDumpInfo.xml) |
Инкрементальная выгрузка сверяется с файлом версий ConfigDumpInfo.xml рядом с исходниками.
При первой выгрузке в пустой каталог его нет, и платформа отказывает сообщением "Не удалось
найти файл версий", поэтому навык выполняет первую выгрузку полной и сообщает об этом.
| Partial | Частичная - выбранные объекты из параметра -Objects |
| UpdateInfo | Обновить только ConfigDumpInfo.xml без выгрузки файлов |
Коды возврата
| Код | Описание |
|---|---|
| 0 | Успешно |
| 1 | Ошибка (см. лог) |
Если пользователь просит выгрузить конкретные объекты - используй
-Mode Partialс-Objects.
Примеры
# Полная выгрузка (файловая база)
powershell.exe -NoProfile -File skills/1c-db-dump-xml/scripts/db-dump-xml.ps1 -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full
# Инкрементальная выгрузка
powershell.exe -NoProfile -File skills/1c-db-dump-xml/scripts/db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Changes
# Частичная выгрузка
powershell.exe -NoProfile -File skills/1c-db-dump-xml/scripts/db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
# Серверная база
powershell.exe -NoProfile -File skills/1c-db-dump-xml/scripts/db-dump-xml.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -ConfigDir "C:\WS\cfsrc" -Mode Full
# Выгрузка расширения
powershell.exe -NoProfile -File skills/1c-db-dump-xml/scripts/db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоеРасширение"