About db-dump-xml
A skill for exporting 1C infobase configurations as XML source files, for configuration development and version-control workflows. It supports full, incremental, and partial exports, as well as updating ConfigDumpInfo alone.
Key features
- 01Full and incremental exports
- 02Partial export of selected objects
- 03Updates ConfigDumpInfo
- 04Exports configuration extensions
- 05Hierarchical or plain format
Use cases
- 01Export an entire configuration as XML
- 02Export only selected configuration objects
- 03Export extensions or refresh dump information
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ nikolay-shirokov/ cc-1c-skills --skill db-dump-xmlAfter installing, type/db-dump-xmlin Claude Code to confirm it loaded.
Bundled filesscripts/db-dump-xml.ps1scripts/db-dump-xml.py
Details
From the project README/db-dump-xml — Выгрузка конфигурации в XML
Выгружает конфигурацию информационной базы в XML-файлы (исходники). Поддерживает полную, инкрементальную, частичную выгрузку и обновление ConfigDumpInfo.
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 из корня проекта и разреши базу:
- Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
- Если указал базу по имени — ищи по id / alias / name в
.v8-project.json - Если не указал — сопоставь текущую ветку Git с
databases[].branches - Если ветка не совпала — используй
defaultПлатформа —v8pathнайденной записи базы, иначе корневойv8path. Не задан ни там, ни там —-V8Pathне передавай. Если файла нет — предложи/db-list add. Если использованная база не зарегистрирована — после выполнения предложи добавить через/db-list add. Если в записи базы указанconfigSrc— используй как каталог выгрузки по умолчанию. Для-Extensionкаталог берётся изextensions[].srcзаписи базы, если он там указан.
Команда
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" <параметры>
Параметры скрипта
| Параметр | Обязательный | Описание |
|---|---|---|
-V8Path <путь> | нет | Каталог bin платформы, или полный путь к 1cv8.exe / ibcmd.exe |
-InfoBasePath <путь> | * | Файловая база |
-InfoBaseServer <сервер> | * | Сервер 1С (для серверной базы) |
-InfoBaseRef <имя> | * | Имя базы на сервере |
-UserName <имя> | нет | Имя пользователя |
-Password <пароль> | нет | Пароль |
-ConfigDir <путь> | да | Каталог для выгрузки |
-Mode <режим> | нет | Full / Changes (по умолч.) / Partial / UpdateInfo |
-Objects <список> | для Partial | Имена объектов через запятую |
-Extension <имя> | нет | Выгрузить расширение |
-AllExtensions | нет | Выгрузить все расширения |
-Format <формат> | нет | Hierarchical (по умолч.) / Plain |
-AdditionalV8Arguments <список> | нет | Доп. аргументы запуска 1cv8.exe через запятую, напр. /UseHwLicenses+ |
-AdditionalIbcmdArguments <список> | нет | Доп. аргументы ibcmd через запятую, в форме --ключ=значение |
*— нужен либо-InfoBasePath, либо пара-InfoBaseServer+-InfoBaseRef
Режимы выгрузки
| Режим | Описание |
|---|---|
Full | Полная выгрузка — все объекты конфигурации. Пишет поверх каталога: файлы, которых нет в конфигурации, остаются |
Changes | Инкрементальная — только изменённые с последней выгрузки (по ConfigDumpInfo.xml). Если выгрузки в каталоге ещё нет (пусто или только .git, README), выгружает полностью |
Partial | Частичная — выбранные объекты из параметра -Objects |
UpdateInfo | Обновить только ConfigDumpInfo.xml без выгрузки файлов |
Если пользователь просит выгрузить конкретные объекты — используй
-Mode Partialс-Objects.
Changes отказывает, если в каталоге есть выгрузка без ConfigDumpInfo.xml или каталог выгружен
в другой версии формата (другой платформой). -Mode Full в таком случае перевыгрузит всё дерево,
и изменятся все файлы, поэтому решение о полной выгрузке оставь пользователю.
Примеры
# Полная выгрузка (файловая база)
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/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_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Changes
# Частичная выгрузка
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
# Серверная база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/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_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"