Skip to main content
skill CX Codex

db-load-xml — Claude Code skill: load 1C configuration from XML

db-load-xml loads 1C configuration into an infobase from XML sources — full replacement or selected objects only.

MIT 45 installs ★ 811 updated 2026-10-23

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills
Open on GitHub

What db-load-xml does

The skill calls a PowerShell script that passes files to the 1C platform via 1cv8.exe or ibcmd. It supports full and partial load: the first replaces the entire configuration with the contents of the directory, the second updates only the listed objects along with their forms, templates, and modules from Ext/. You can pass the file list directly in the command or read it from a UTF-8 with BOM text file.

Connection parameters are read from .v8-project.json: you can specify the database by name, and the skill will match it by id, alias, or current Git branch. If no database is specified, the record marked default is used. The platform path is taken from the v8path field of the database record or the root level of the file. Without the 1C platform in PATH or specified via -V8Path, the load will not start.

What it helps with

  • load 1C configuration from XML files into an infobase
  • update individual configuration objects without full replacement
  • load a 1C extension from source files
  • apply repository changes to a 1C database
  • automate configuration assembly from XML via an agent

Example prompts for the agent

  • Load the configuration from src/config into the dev database
  • Update the Nomenclature catalog and its module from src/config with a partial load
  • Load the MyExtension extension from src/ext_src into the database and update the DB configuration

How to install db-load-xml

1Plugin marketplace

/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills

This installs the whole 1c-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-load-xml -a claude-code

3Manually: put the files in place

~/.claude/skills/db-load-xml/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/db-load-xml/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about db-load-xml

How do I install db-load-xml in Claude Code?

Run two commands: /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, then /plugin install 1c-skills@cc-1c-skills. The skill will appear in the list of available commands.

What does db-load-xml do?

It loads 1C configuration from XML sources into an infobase — entirely or by selected objects. It works with extensions, reads connection parameters from .v8-project.json, and supports updating the database configuration right after loading.

What is the difference between partial and full load?

Full load replaces the entire configuration with the contents of the XML directory; partial load updates only the specified objects along with their child elements (forms, templates, modules). If Configuration.xml is included in the file list, the platform will perform a full load regardless.

Source text

SKILL.md · MIT
---
name: db-load-xml
description: Загрузка конфигурации 1С из XML-файлов. Используй когда нужно загрузить конфигурацию из файлов, XML, исходников, LoadConfigFromFiles
argument-hint: <configDir> [database]
allowed-tools:
  - Bash
  - Read
  - Glob
  - AskUserQuestion
---

# /db-load-xml — Загрузка конфигурации из XML

Загружает конфигурацию в информационную базу из XML-файлов (исходников). Поддерживает полную и частичную загрузку.

## Usage

```
/db-load-xml <configDir> [database]
/db-load-xml src/config dev
/db-load-xml src/config dev -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"
```

> **Внимание**: полная загрузка **заменяет всю конфигурацию** в базе. Перед выполнением запроси подтверждение у пользователя.

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

Прочитай `.v8-project.json` из корня проекта и разреши базу:
1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
4. Если ветка не совпала — используй `default`
Платформа — `v8path` найденной записи базы, иначе корневой `v8path`. Не задан ни там, ни там — `-V8Path` не передавай.
Если файла нет — предложи `/db-list add`.
Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
Если в записи базы указан `configSrc` — используй как каталог загрузки по умолчанию.
Для `-Extension` каталог берётся из `extensions[].src` записи базы, если он там указан.

## Команда

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" <параметры>
```

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

| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
| `-InfoBasePath <путь>` | * | Файловая база |
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
| `-UserName <имя>` | нет | Имя пользователя |
| `-Password <пароль>` | нет | Пароль |
| `-ConfigDir <путь>` | да | Каталог XML-исходников |
| `-Mode <режим>` | нет | `Full` (по умолч.) / `Partial` |
| `-Files <список>` | для Partial | Относительные пути файлов через запятую |
| `-ListFile <путь>` | для Partial | Путь к файлу со списком (альтернатива `-Files`) |
| `-Extension <имя>` | нет | Загрузить в расширение |
| `-AllExtensions` | нет | Загрузить все расширения (только полностью; частями — по одному через `-Extension`) |
| `-NoApplyCheck` | нет | Не проверять применимость расширения после загрузки |
| `-Format <формат>` | нет | `Hierarchical` (по умолч.) / `Plain` |
| `-UpdateDB` | нет | После загрузки сразу обновить конфигурацию БД (`/UpdateDBCfg`) |
| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |

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

### Режимы загрузки

| Режим | Описание |
|-------|----------|
| `Full` | Полная загрузка — замена всей конфигурации из каталога XML |
| `Partial` | Частичная — перечисленные объекты вместе с их дочерними (формы, макеты) и `Ext/` |

> Если в список файлов включить `Configuration.xml`, платформа выполнит **полную загрузку конфигурации**, а не только перечисленных объектов.

### Формат файла списка (listFile)

Файл содержит **относительные пути к файлам** в каталоге выгрузки (один на строку), кодировка **UTF-8 с BOM**:

```
Catalogs/Номенклатура.xml
Catalogs/Номенклатура/Ext/ObjectModule.bsl
Documents/Заказ.xml
Documents/Заказ/Forms/ФормаДокумента.xml
```

## После выполнения

Если `-UpdateDB` не был указан — **предложи выполнить `/db-update`** для применения изменений к БД

## Примеры

```powershell
# Полная загрузка
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-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-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Files "Catalogs/Номенклатура.xml,Catalogs/Номенклатура/Ext/ObjectModule.bsl"

# Загрузка расширения
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"

# Загрузка + обновление БД в одном запуске
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full -UpdateDB
```

© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills

Similar skills

Everything for 1C →

From the same set81

The whole set →
meta-edit The meta-edit skill edits existing 1C metadata XML objects, including attributes, tabular sections, and object properties. Use it for focused configuration changes. CX Codex +1 45installs form-patterns form-patterns — a pattern guide for designing 1C managed forms. Use it before form generation when the layout requirements leave the structure open. CX Codex +1 45installs form-compile form-compile turns a JSON description of a 1C managed form, or an object's metadata, into a Form.xml file. Handy when a form has to be created from scratch or generated as a standard one. CX Codex +1 45installs form-add form-add generates 1C managed form scaffolds and registers them in configuration metadata XML. Handy when adding new forms to documents, catalogs, or registers. CX Codex +1 45installs db-load-git db-load-git applies configuration changes from Git into a 1C infobase without a full reload. It scans working tree edits or commits to push only modified objects. CX Codex +1 45installs cfe-diff cfe-diff analyzes 1C CFE configuration extensions, inspects borrowed metadata objects, and checks if code patches reached the main configuration. CX Codex +1 45installs cf-init cf-init scaffolds an empty 1C enterprise configuration XML source tree directly from the command line. CX Codex +1 45installs web-stop web-stop stops Apache HTTP Server for a project with web publishing. Use it when the server should go down while published databases remain available for a later restart. CX Codex +1 44installs

Project sponsors

Companies that keep this analytics open