mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-09-27 12:35:54 +03:00
90 lines
6.6 KiB
Markdown
90 lines
6.6 KiB
Markdown
---
|
||
name: erf-build
|
||
description: Собрать внешний отчёт 1С (ERF) из XML-исходников. Используй когда пользователь просит собрать, скомпилировать отчёт или получить ERF файл из исходников
|
||
argument-hint: <ReportName>
|
||
allowed-tools:
|
||
- Bash
|
||
- Read
|
||
- Glob
|
||
- Grep
|
||
---
|
||
|
||
# /erf-build — Сборка отчёта
|
||
|
||
## Usage
|
||
|
||
```
|
||
/erf-build <ReportName> [SrcDir] [OutDir]
|
||
```
|
||
|
||
| Параметр | Обязательный | По умолчанию | Описание |
|
||
|------------|:------------:|--------------|--------------------------------------|
|
||
| ReportName | да | — | Имя отчёта (имя корневого XML) |
|
||
| SrcDir | нет | `src` | Каталог исходников |
|
||
| OutDir | нет | `build` | Каталог для результата |
|
||
|
||
## Параметры подключения (опционально)
|
||
|
||
Предпочтительно использовать конкретную базу: сборка надёжнее, а `configSrc` базы из
|
||
`.v8-project.json` даёт проверке исходников общие модули конфигурации.
|
||
|
||
1. Прочитай `.v8-project.json` из корня проекта и разреши базу:
|
||
2. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
|
||
3. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
|
||
4. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
|
||
5. Если ветка не совпала — используй `default`
|
||
6. Если `.v8-project.json` нет или база не найдена — не указывай параметры подключения: скрипт автоматически создаст временную базу. Для ERF со ссылочными типами (CatalogRef, DocumentRef и т.д.) генерируются заглушки метаданных. Временная база удаляется после сборки.
|
||
|
||
Платформа — `v8path` найденной записи базы, иначе корневой `v8path`. Не задан ни там, ни там — `-V8Path` не передавай.
|
||
Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.
|
||
|
||
## Команда
|
||
|
||
Используй общий скрипт из epf-build:
|
||
|
||
```powershell
|
||
powershell.exe -NoProfile -File ".github/skills/epf-build/scripts/epf-build.ps1" <параметры>
|
||
```
|
||
|
||
### Параметры скрипта
|
||
|
||
| Параметр | Обязательный | Описание |
|
||
|----------|:------------:|----------|
|
||
| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
|
||
| `-InfoBasePath <путь>` | * | Файловая база |
|
||
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
|
||
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
|
||
| `-UserName <имя>` | нет | Имя пользователя |
|
||
| `-Password <пароль>` | нет | Пароль |
|
||
| `-SourceFile <путь>` | да | Путь к корневому XML-файлу исходников |
|
||
| `-OutputFile <путь>` | да | Путь к выходному ERF-файлу |
|
||
| `-Checks <список>` | нет | Что проверить перед сборкой: `modules`, `handlers`, `unreferenced`, `empty-handlers`, `config`; `off` — не проверять. По умолчанию `modules,handlers` |
|
||
| `-Context <список>` | нет | Контексты проверки `modules`: `ThinClient`, `Server`, `ExternalConnection`, `ThickClientOrdinaryApplication`. По умолчанию `ThinClient,Server` |
|
||
| `-ConfigSrc <путь>` | нет | Каталог XML-выгрузки конфигурации, в которой будет работать отчёт. По умолчанию — `configSrc` указанной базы из `.v8-project.json` |
|
||
| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
|
||
| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
|
||
|
||
> `*` — опционально. Если не указано — автоматически создаётся временная база со заглушками метаданных
|
||
|
||
## Проверка перед сборкой
|
||
|
||
Перед сборкой платформа проверяет исходники: синтаксис модулей и наличие обработчиков форм.
|
||
Если есть ошибки, файл не создаётся, а в выводе — сообщение платформы со строкой и колонкой
|
||
и путь к файлу исходника. Собрать без проверки — `-Checks off`.
|
||
|
||
Если код обращается к общим модулям конфигурации (`ОбщегоНазначения`, `УправлениеПечатью` и т.п.),
|
||
проверке нужна выгрузка этой конфигурации. По умолчанию берётся `configSrc` указанной базы из
|
||
`.v8-project.json`; если его нет — передай каталог выгрузки в `-ConfigSrc`, а если выгрузки нет
|
||
совсем — собирай с `-Checks off`. Код, который вызывает методы глобальных общих модулей без
|
||
имени модуля, проверку не пройдёт и с выгрузкой — его тоже собирай с `-Checks off`.
|
||
|
||
## Примеры
|
||
|
||
```powershell
|
||
# Сборка отчёта (файловая база)
|
||
powershell.exe -NoProfile -File ".github/skills/epf-build/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
|
||
|
||
# Серверная база
|
||
powershell.exe -NoProfile -File ".github/skills/epf-build/scripts/epf-build.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"
|
||
```
|