6 added, 4 removed. Audit A to A.
---
name: erf-init
description: Создать пустой make-ready scaffold внешнего отчёта 1С (ERF) в корне Designer/platform-XML external source-set, с модулем объекта и опциональной управляемой формой. Используй при запросе создать новый внешний отчёт с нуля; не используй для обычного Report внутри конфигурации.
---
# Создание внешнего отчёта ERF
## MCP routing
- Использовать MCP `unica` tool `unica.erf.init` для scaffold XML/BSL.
- Не вызывать внутренние adapters и не добавлять skill-local scripts.
- По INV-MCP-RUNTIME-RECEIPT и ADR-0074: `unica.runtime.execute` с `dryRun: true`
показывает запланированную команду без побочных эффектов, а с `dryRun: false`
- исполняет операцию и отвечает её терминальным результатом в том же вызове,
- приложив названную причину риска (`runtime_risk_*`) предупреждением. Preview
+ исполняет классифицированную операцию и отвечает её терминальным результатом в
+ том же вызове, приложив названную причину риска (`runtime_risk_*`)
+ предупреждением; неклассифицированная операция по-прежнему отказывает
+ `runtime_operation_unbounded` до обнаружения рабочего пространства. Preview
исполнением не является. Работу, которую вызов ждать не должен, запускай через
`unica.runtime.job.start`. Не обходи контракт прямым runner-ом или через
`unica.build.*`.
- Для будущей сборки результата предпросмотреть `operation=make` через `v8-runner`; текущий вызов не создаёт артефакт.
## Порядок работы
1. Убедиться, что `v8project.yaml` использует Designer mode: явно `format: DESIGNER` либо поле `format` отсутствует и действует Designer default v8-runner. Skill создаёт platform XML, а EDT external-project layout не поддерживается.
2. Сохранить существующие `workPath`, `infobase`, credentials и local overrides. Не заменять connection string и не инициализировать существующую ИБ ради scaffold.
3. Найти source-set с `type: EXTERNAL_REPORTS` и передать его `path` как `OutputDir` без вложенного подкаталога. v8-runner ищет descriptors непосредственно в корне source-set.
4. Если source-set ещё не объявлен, создать scaffold в выбранном новом каталоге, затем явно добавить этот каталог как корень Designer source-set. Проверить регистрацию через `unica.project.map`: `kind=external_report`, `sourceFormat=platform_xml`.
5. Передать `FormName`, только если нужна пустая управляемая форма. Без него создаются descriptor и `ObjectModule.bsl`; пустая СКД автоматически не добавляется.
6. Сначала проверить точный список файлов через `dryRun: true`; при явном запросе пользователя повторить с `dryRun: false`.
7. Добавлять СКД позже через `dcs-*`/`template-*`, затем предпросмотреть `unica.runtime.execute operation=make`. Для будущей applied-сборки в `v8project.yaml` потребуется доступная `infobase.connection`; текущий preview не собирает `.erf`.
`Name` и `FormName` должны быть идентификаторами 1С. Существующие descriptor или одноимённый каталог не перезаписываются. При `format: EDT` остановиться и объяснить несовместимость, не создавать Designer XML внутри EDT source-set.
В существующем валидном `v8project.yaml` добавить только этот фрагмент, используя ключ `source-set` в единственном числе и не затирая остальные поля:
```yaml
source-set:
- name: external-reports
type: EXTERNAL_REPORTS
path: src/external-reports
```
Для нового изолированного workspace полный минимальный пример имеет также обязательный runtime-контекст:
```yaml
workPath: build/runtime
execution_timeout: 300000
format: DESIGNER
builder: DESIGNER
infobase:
connection: 'File=build/ib'
source-set:
- name: external-reports
type: EXTERNAL_REPORTS
path: src/external-reports
```
- Текущий applied `operation=init` не допускается даже по явному запросу пользователя: он возвращает fail-closed до запуска процесса. Не выполнять `init` ради scaffold или существующей проектной базы. Для существующей connection сохранить настройки без переинициализации; `db-auth-check` может классифицировать только уже предоставленное runtime evidence и не запускает auth probe.
+ Не выполняй applied `operation=init` ради scaffold или существующей проектной базы: он инициализирует runtime-состояние и несёт непрерываемую фазу, а для scaffold это не нужно. Для существующей connection сохранить настройки без переинициализации; `db-auth-check` может классифицировать только уже предоставленное runtime evidence и не запускает auth probe.
## Параметры
| Параметр | Назначение |
| --- | --- |
| `Name` | Имя внешнего отчёта, обязательно |
| `Synonym` | Русский синоним; по умолчанию равен `Name` |
| `OutputDir` | Корень external source-set, обязательно |
| `FormName` | Опциональная пустая управляемая форма |
## Примеры
Preview отчёта с пустой управляемой формой:
```json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "unica.erf.init",
"arguments": {
"cwd": "<workspace>",
"Name": "Остатки",
"Synonym": "Остатки товаров",
"OutputDir": "src/external-reports",
"FormName": "ФормаОтчета",
"dryRun": true
}
}
}
```
Создание отчёта с пустой управляемой формой:
```json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "unica.erf.init",
"arguments": {
"cwd": "<workspace>",
"Name": "Остатки",
"Synonym": "Остатки товаров",
"OutputDir": "src/external-reports",
"FormName": "ФормаОтчета",
"dryRun": false
}
}
}
```
## Верификация
`unica.erf.init` разбирает весь сгенерированный XML до публикации. Проверить, что созданы `<Name>.xml`, `<Name>/Ext/ObjectModule.bsl` и, если запрошена форма, три файла под `<Name>/Forms/`. Форму дополнительно проверить через `unica.form.validate` с путём к её `Ext/Form.xml`. Отдельный generic Meta validator не использовать: он не принимает root `ExternalReport`. Не создавать `Configuration.xml`, platform-generated CDFI sidecar или СКД без запроса; legitimate external descriptor может называться `ConfigDumpInfo.xml`, если пользователь выбрал такое имя объекта.
Предпросмотреть будущую команду сборки только с `dryRun: true`:
```json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "unica.runtime.execute",
"arguments": {
"cwd": "<workspace>",
"operation": "make",
"sourceSet": "external-reports",
"output": "build/external",
"dryRun": true
}
}
}
```
- Не заменять `dryRun` на `false`: applied `make` сейчас fail-closed.
+ Перед заменой `dryRun` на `false` предупреди: applied `make` публикует артефакт без ограниченного восстановления.
Не использовать `operation=load` для `.erf`.