SuperAPI AI 工具集

erf-build

编程与开发

查看项目

更新于 10-15 21:04

技能介绍

用途:从 XML 源文件构建 1С 外部报表(ERF)。当用户要求编译报表或从源文件生成 ERF 文件时使用。

用法:/erf-build <ReportName> [SrcDir] [OutDir]。ReportName 为必填,指根 XML 名称;SrcDir 默认 src;OutDir 默认 build。

连接参数:优先使用具体数据库,构建更可靠。从项目根目录读取 .v8-project.json 解析数据库:用户指定路径或服务器则直接使用;指定数据库名则按 id/alias/name 查找;未指定则按当前 Git 分支匹配 databases[].branches,未匹配则用 default。若无 .v8-project.json 或找不到数据库,则不传连接参数,脚本自动创建临时数据库,为引用类型(CatalogRef、DocumentRef 等)生成元数据占位符,构建后删除临时库。平台路径取数据库记录的 v8path,否则取根级 v8path;都没有则不传 -V8Path。

命令:使用 epf-build 的通用脚本:powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" <参数>。

脚本参数:-V8Path(可选,平台 bin 目录或 1cv8.exe/ibcmd.exe 完整路径)、-InfoBasePath(文件库)、-InfoBaseServer(服务器)、-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 导出目录,默认取 .v8-project.json 中该库的 configSrc)、-AdditionalV8Arguments、-AdditionalIbcmdArguments。

构建前检查:平台检查模块语法与表单处理程序。有错误则不生成文件,输出平台消息(含行、列)及源文件路径。跳过检查用 -Checks off。若代码引用配置的公共模块(如 ОбщегоНазначения、УправлениеПечатью),检查需要该配置的导出;默认取指定库的 configSrc,没有则通过 -ConfigSrc 传入导出目录,完全没有导出则用 -Checks off 构建。调用全局公共模块方法但不带模块名的代码即使有导出也无法通过检查,同样需 -Checks off。

示例:文件库:powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBasePath "C:\Bases\MyDB" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf";服务器库:powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/../epf-build/scripts/epf-build.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -SourceFile "src/МойОтчёт.xml" -OutputFile "build/МойОтчёт.erf"。

限制:资料未提供收费、价格、平台支持范围等更多信息。