name: db-dump-xml description: 将1C配置导出为XML文件。当用户请求将配置导出为文件、XML、源代码或DumpConfigToFiles时使用。 argument-hint: “[database] [outputDir]” allowed-tools:
- Bash
- Read
- Glob
- AskUserQuestion
/db-dump-xml — 导出配置为XML
将信息库的配置导出为XML文件(源代码)。支持完整、增量、部分导出和更新ConfigDumpInfo。
用法
/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(平台路径)并解析数据库:
- 如果用户指定了连接参数(路径、服务器)— 直接使用
- 如果按名称指定了数据库 — 在
.v8-project.json中按 id / alias / name 查找 - 如果未指定 — 将当前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 .claude/skills/db-dump-xml/scripts/db-dump-xml.ps1 <参数>
脚本参数
| 参数 | 是否必需 | 描述 |
|---|---|---|
-V8Path <路径> |
否 | 平台bin目录(或1cv8.exe的完整路径) |
-InfoBasePath <路径> |
* | 文件数据库 |
-InfoBaseServer <服务器> |
* | 1C服务器(用于服务器数据库) |
-InfoBaseRef <名称> |
* | 服务器上数据库的名称 |
-UserName <名称> |
否 | 用户名 |
-Password <密码> |
否 | 密码 |
-ConfigDir <路径> |
是 | 导出目录 |
-Mode <模式> |
否 | Full / Changes(默认)/ Partial / UpdateInfo |
-Objects <列表> |
用于Partial | 对象名称,用逗号分隔 |
-Extension <名称> |
否 | 导出扩展 |
-AllExtensions |
否 | 导出所有扩展 |
-Format <格式> |
否 | Hierarchical(默认)/ Plain |
*— 需要-InfoBasePath或-InfoBaseServer+-InfoBaseRef对
导出模式
| 模式 | 描述 |
|---|---|
Full |
完整导出 — 所有配置对象 |
Changes |
增量导出 — 仅自上次导出后更改的对象(使用ConfigDumpInfo.xml) |
Partial |
部分导出 — 从参数 -Objects 中选择的对象 |
UpdateInfo |
仅更新ConfigDumpInfo.xml,不导出文件 |
返回码
| 代码 | 描述 |
|---|---|
| 0 | 成功 |
| 1 | 错误(查看日志) |
如果用户请求导出特定对象 — 使用
-Mode Partial和-Objects。
示例
# 完整导出(文件数据库)
powershell.exe -NoProfile -File .claude/skills/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 .claude/skills/db-dump-xml/scripts/db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Changes
# 部分导出
powershell.exe -NoProfile -File .claude/skills/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 .claude/skills/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 .claude/skills/db-dump-xml/scripts/db-dump-xml.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"