/erf-expert — Внешние отчёты 1С (ERF)

Единый скилл для всех операций с внешними отчётами ERF. Выбери нужный режим:

Режим	Что делает
`init`	Создать новый пустой отчёт (scaffold XML)
`build`	Собрать ERF из XML-исходников
`dump`	Разобрать ERF в XML-исходники

Режим: init — создание отчёта

Генерирует минимальный набор XML-исходников для внешнего отчёта (ERF) 1С.

Usage

/erf-expert init <Name> [Synonym] [SrcDir] [--with-skd]

Параметр	Обязательный	По умолчанию	Описание
Name	да	—	Имя отчёта
Synonym	нет	= Name	Синоним (отображаемое имя)
SrcDir	нет	`src`	Каталог исходников
--WithSKD	нет	—	Создать пустую СКД и привязать к MainDataCompositionSchema

Команда

powershell.exe -NoProfile -File .claude/skills/erf-expert/scripts/erf-init.ps1 -Name "<Name>" [-Synonym "<Synonym>"] [-SrcDir "<SrcDir>"] [-WithSKD]

Что создаётся

<SrcDir>/
├── <Name>.xml          # Корневой файл метаданных (4 UUID)
└── <Name>/
    └── Ext/
        └── ObjectModule.bsl  # Модуль объекта с 3 регионами

При --WithSKD дополнительно:

<SrcDir>/<Name>/
    Templates/
    ├── ОсновнаяСхемаКомпоновкиДанных.xml
    └── ОсновнаяСхемаКомпоновкиДанных/Ext/Template.xml  # Пустая СКД

Корневой XML содержит MetaDataObject/ExternalReport
При --WithSKD: MainDataCompositionSchema заполняется, ChildObjects содержит <Template>
ClassId фиксирован: e41aff26-25cf-4bb6-b6c1-3f478a75f374
Файлы создаются в UTF-8 с BOM

Дальнейшие шаги

Добавить форму: /form-add
Добавить макет: /mxl-expert template-add
Редактировать СКД: /skd-edit
Добавить справку: /help-add
Собрать ERF: /erf-expert build

Режим: build — сборка ERF

Собирает ERF файл из XML-исходников с помощью платформы 1С.

Usage

/erf-expert build <Name> [SrcDir] [OutDir]

Параметр	Обязательный	По умолчанию	Описание
Name	да	—	Имя объекта (имя корневого XML)
SrcDir	нет	`src`	Каталог исходников
OutDir	нет	`build`	Каталог для результата

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

Прочитай .v8-project.json из корня проекта. Возьми v8path и разреши базу:

Если пользователь указал параметры (путь, сервер) — используй напрямую
Если указал базу по имени — ищи в .v8-project.json
Если не указал — сопоставь ветку Git с databases[].branches
Если ветка не совпала — используй default
Если .v8-project.json нет — создай пустую ИБ в ./base

Если v8path не задан: Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1

Команда

powershell.exe -NoProfile -File .claude/skills/erf-expert/scripts/erf-build.ps1 -InfoBasePath "<путь>" -SourceFile "src\<Name>.xml" -OutputFile "build\<Name>.erf"

Параметр	Обязательный	Описание
`-V8Path <путь>`	нет	Каталог bin платформы
`-InfoBasePath <путь>`	*	Файловая база
`-InfoBaseServer <сервер>`	*	Сервер 1С
`-InfoBaseRef <имя>`	*	Имя базы на сервере
`-UserName <имя>`	нет	Пользователь
`-Password <пароль>`	нет	Пароль
`-SourceFile <путь>`	да	Корневой XML исходников
`-OutputFile <путь>`	да	Выходной ERF файл

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

Режим: dump — разборка ERF

Разбирает ERF файл в XML-исходники с помощью платформы 1С (иерархический формат).

Usage

/erf-expert dump <File> [OutDir]

Параметр	Обязательный	По умолчанию	Описание
File	да	—	Путь к ERF файлу
OutDir	нет	`src`	Каталог для выгрузки исходников

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

Аналогично режиму build — разрешение базы через .v8-project.json.

Команда

powershell.exe -NoProfile -File .claude/skills/erf-expert/scripts/erf-dump.ps1 -InfoBasePath "<путь>" -InputFile "<файл>.erf" -OutputDir "src"

Параметр	Обязательный	Описание
`-V8Path <путь>`	нет	Каталог bin платформы
`-InfoBasePath <путь>`	*	Файловая база
`-InfoBaseServer <сервер>`	*	Сервер 1С
`-InfoBaseRef <имя>`	*	Имя базы на сервере
`-UserName <имя>`	нет	Пользователь
`-Password <пароль>`	нет	Пароль
`-InputFile <путь>`	да	Путь к ERF файлу
`-OutputDir <путь>`	да	Каталог для выгрузки
`-Format <формат>`	нет	`Hierarchical` (по умолч.) / `Plain`

Структура результата (Hierarchical)

<OutDir>/
├── <Name>.xml
└── <Name>/
    ├── Ext/
    │   └── ObjectModule.bsl
    ├── Forms/
    │   ├── <FormName>.xml
    │   └── <FormName>/Ext/Form.xml
    └── Templates/
        ├── <TemplateName>.xml
        └── <TemplateName>/Ext/Template.<ext>