SuperAPI AI Directory

db-load-git

General & other

View repository

Updated 10-15 17:18

About this skill

/db-load-git — Loading changes from Git

Determines changed configuration files from Git data and performs a partial load into the infobase.

Usage

/db-load-git [database]
/db-load-git dev                              — все незафиксированные изменения
/db-load-git dev -Source Staged               — только staged
/db-load-git dev -Source Commit -CommitRange "HEAD~3..HEAD"
/db-load-git dev -DryRun                      — только показать что будет загружено

Connection parameters

Read .v8-project.json from the project root. Take v8path (path to the platform) and resolve the database:

  1. If the user specified connection parameters (path, server) — use them directly
  2. If the user specified a database by name — search by id / alias / name in .v8-project.json
  3. If not specified — match the current Git branch with databases[].branches
  4. If the branch did not match — use default If v8path is not set — auto-detect: Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1 If the file does not exist — suggest /db-list add. If the used database is not registered — after execution, suggest adding it via /db-list add. If the database entry specifies configSrc — use it as the configuration directory.

Command

powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 <параметры>

Script parameters

Parameter Required Description
-V8Path <путь> no Platform bin directory (or full path to 1cv8.exe)
-InfoBasePath <путь> * File database
-InfoBaseServer <сервер> * 1C server (for a server database)
-InfoBaseRef <имя> * Database name on the server
-UserName <имя> no User name
-Password <пароль> no Password
-ConfigDir <путь> yes XML dump directory (git repository)
-Source <источник> no All (default) / Staged / Unstaged / Commit
-CommitRange <range> for Commit Commit range (e.g. HEAD~3..HEAD)
-Extension <имя> no Load into extension
-AllExtensions no Load all extensions
-Format <формат> no Hierarchical (default) / Plain
-DryRun no Only show what will be loaded (without loading)

* — either -InfoBasePathis needed, or the pair -InfoBaseServer + -InfoBaseRef

Sources of changes

Source Description
All All uncommitted: staged + unstaged + untracked
Staged Only indexed (git add)
Unstaged Modified but not indexed + new (untracked) files
Commit Files from the commit range (requires -CommitRange)

BSL → XML mapping logic

For .bsl files, the script automatically adds:

  1. XML of the top-level object (e.g. Catalogs/Номенклатура.xml)
  2. All files from the directory Ext/ of this object (associated modules)

Skipped: ConfigDumpInfo.xml, files outside ConfigDir.

Return codes

Code Description
0 Success (or no changes)
1 Error (see log)

After execution

  1. Show the list of uploaded files
  2. Suggest /db-update — to apply changes to the DB

Examples

# Загрузить все незафиксированные изменения (файловая база)
powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Source All

# Только staged
powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Source Staged

# Серверная база
powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -ConfigDir "C:\WS\cfsrc" -Source All

# Из диапазона коммитов
powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Source Commit -CommitRange "HEAD~3..HEAD"

# Только посмотреть (DryRun)
powershell.exe -NoProfile -File .claude/skills/db-load-git/scripts/db-load-git.ps1 -InfoBasePath "C:\Bases\MyDB" -ConfigDir "C:\WS\cfsrc" -DryRun