SuperAPI AI 工具集

docyrus-print-pdf-template-design

设计与创作

查看项目

更新于 10-15 21:11

技能介绍

用途:设计可打印、绑定数据的 Docyrus 报表(导出)模板,并完成校验与渲染测试。模板是 tenant_html_template 中的一行,包含 HTML 正文(可选页眉/页脚/CSS)、{{field}} Handlebars 占位符、绑定的数据源和页面设置。

主要能力:用 docyrus studio create-html-template 创建模板(--name 与数据源必填);用 list/get/update/delete-html-template 管理,get 返回完整内容,list 仅元数据,update 为部分 PUT,delete 为软删除(204)。渲染无 CLI 命令,需用 docyrus curl 调用应用端点 /html 与 /pdf。

使用方式:先确认应用与认证并解析数据源字段,例如 docyrus auth who --json、docyrus apps list --json、docyrus studio list-data-sources --appSlug crm --json、docyrus studio list-fields --appSlug crm --dataSourceSlug quotes --json。创建示例:docyrus studio create-html-template --appSlug crm --dataSourceSlug quotes --name "Quote PDF" --body '<h1>{{name}}</h1>' --pageFormat A4 --pageOrientation portrait --json。渲染:docyrus curl "/v1/apps/crm/data-sources/quotes/items/<recordId>/templates/TEMPLATE_ID/html",PDF 用 /pdf。

限制:数据源绑定必填,缺失返回 422;source_type 是选项集 UUID,不是格式,格式由渲染端点决定;page_orientation 传 portrait/landscape 字符串;无 DOCX 渲染路径;PDF 依赖外部 html2pdf 服务,本地可能 500,以 /html 渲染作为可靠校验;未知 JSON 键被静默忽略;占位符缺失渲染为空不报错;{{x}} 转义 HTML,需用 {{{x}}} 输出原始 HTML。创建后应回读校验并针对真实记录测试,最后删除临时模板。