| name | erf |
| description | Используй этот скилл для всех операций с внешними отчётами 1С (ERF): создание (init), сборка (build), разборка (dump). Также используй при любой работе с ERF-файлами и их исходниками. Не используй для внешних обработок (EPF) — используй epf; для СКД внутри отчёта — используй skd-edit; для форм — form-add.
|
| argument-hint | <mode> [args...] # modes: init|build|dump |
| allowed-tools | ["Bash","Read","Write","Edit","Glob","Grep"] |
erf — Внешние отчёты 1С (ERF)
Единый скилл для всех операций с внешними отчётами ERF. Выбери нужный режим:
| Режим | Что делает |
|---|
init | Создать новый пустой отчёт (scaffold XML) |
build | Собрать ERF из XML-исходников |
dump | Разобрать ERF в XML-исходники |
Режим: init — создание отчёта
Генерирует минимальный набор XML-исходников для внешнего отчёта (ERF) 1С.
Usage
erf init <Name> [Synonym] [SrcDir] [--with-skd]
| Параметр | Обязательный | По умолчанию | Описание |
|---|
| Name | да | — | Имя отчёта |
| Synonym | нет | = Name | Синоним (отображаемое имя) |
| SrcDir | нет | src | Каталог исходников |
| --WithSKD | нет | — | Создать пустую СКД и привязать к MainDataCompositionSchema |
Команда
powershell.exe -NoProfile -File 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 template-add
- Редактировать СКД:
/skd-edit
- Добавить справку:
/help-add
- Собрать ERF:
erf build
Режим: build — сборка ERF
Собирает ERF файл из XML-исходников с помощью платформы 1С.
Usage
erf 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 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 dump <File> [OutDir]
| Параметр | Обязательный | По умолчанию | Описание |
|---|
| File | да | — | Путь к ERF файлу |
| OutDir | нет | src | Каталог для выгрузки исходников |
Параметры подключения
Аналогично режиму build — разрешение базы через .v8-project.json.
Команда
powershell.exe -NoProfile -File 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>
