Erf Expert

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

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

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

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

Usage

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

Команда

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]

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

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

1. Если пользователь указал параметры (путь, сервер) — используй напрямую
2. Если указал базу по имени — ищи в .v8-project.json
3. Если не указал — сопоставь ветку Git с databases[].branches
4. Если ветка не совпала — используй default
5. Если .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"

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

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

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

Usage

/erf-expert dump <File> [OutDir]

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

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

Команда

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

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

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