跳到主要内容

Word 与 Excel 模板

点击 新模板,选择 Word 或 Excel,即可使用 .docx 或 .xlsx 文件制作可重复使用的打印模板。在 Word 或 Excel 中调整内容、样式并插入字段占位符,再上传到打印设计。

上传和替换模板​

  1. 新建对应格式的模板
  2. 在 模板信息 中填写名称、设置作用范围
  3. 在 上传模版 下点击 点击上传,选择对应的 .docx 或 .xlsx 文件,大小不超过 20 MB
  4. 按钮下方显示上传的文件列表,右侧工作区预览源文件
  5. 保存后,在 预览 中选择真实记录,检查填充后的结果

未上传文件时,工作区显示 暂未上传模版。需要替换时,在本地修改文件,再重新上传同一格式的文件。

Office 模板使用文件自身的布局。纸张大小、页边距、横向或纵向、Word 表格和 Excel 打印设置,都在源文件中调整。PDF 模板使用画布工具设计。

填写字段占位符​

从 数据字段 复制准确的 API 名称,外面加上双大括号。字段显示名称不等于 API 名称。以下名称仅用于示例,请替换成当前表单的真实 API 名称。

文件内容预览时填入的值
客户:{{customer_name}}主记录的客户名称
{{salesperson}}人员字段的显示名称
{{department}}部门字段的显示名称
{{product.name}}关联记录中的字段
{{customer_location.full}}完整定位文本

人员、部门、组织和关联字段会在当前用户权限范围内解析为显示值。关联字段使用字段面板中复制的完整路径。

重复打印子表行​

模板信息 → 子表 会自动显示当前表单的子表。复制对应表的 开始标记 和 结束标记 即可,标记直接使用子表表单的真实 API 名称,不需要另外配置别名。

假设子表 API 名称为 order_items,在同一个 Word 表格或 Excel 工作表内,连续准备以下三行:

行说明产品数量金额
开始标记行{{#order_items}}
样例数据行{{order_items.name}}{{order_items.quantity}}{{order_items.amount}}
结束标记行{{/order_items}}

上表第一列只用于解释,不要把“开始标记行”等说明写进文件。每个标记行只能包含一个标记,其余单元格留空。列标题放在开始标记行上方。生成结果时,样例行会按当前主记录下的子表记录重复,开始和结束标记行会移除。行号使用 {{order_items.__index}}。

在 子表 下按需设置排序和 打印范围。打印范围使用字段筛选弹窗,只筛选当前主记录关联的子表记录。没有子表记录时,结果保留一行空白样例行。

子表行里的关联字段可使用 {{order_items.products.name}} 这样的路径。需要把子表中的关联记录单独重复成表格时,使用 {{#order_items.products}}、{{order_items.products.name}}、{{/order_items.products}} 三行结构。请使用真实来源路径,并单独放置该循环块,不支持嵌套循环行。关联表字段在 数据字段 中查找,无需在模板信息中增加关联表配置。

定位字段​

打印模板提供九个定位子项,全部为字符串:

子项占位符示例
完整定位{{customer_location.full}}
国家{{customer_location.country}}
省{{customer_location.province}}
市{{customer_location.city}}
区{{customer_location.district}}
详细地址{{customer_location.address}}
邮编{{customer_location.postcode}}
经度{{customer_location.longitude}}
纬度{{customer_location.latitude}}

完整定位使用 / 拼接非空的国家、省、市、区、详细地址,不额外添加空格。缺失的子项输出为空,值为零的经纬度输出为 0。子表和关联字段也使用相同的子项。

预览和打印格式​

编辑工作区预览上传的源文件,其中仍保留字段占位符。在 预览 中选择记录后,生成填充数据的文档。Word、Excel 结果使用各自格式的文件预览。在模板信息中将 打印格式 设为 当前格式,输出 .docx 或 .xlsx;选择 PDF 则转换为 PDF 输出。

前台打印弹窗使用所选模板的输出和预览。生成结果不会替换可重复使用的源模板。

让 AI 制作模板​

可以上传文件,让 AI 填入表单字段占位符,也可以让 AI 从零创建 Word 或 Excel 模板。例如:

用这份 Excel 制作订单打印模板,填好客户和定位字段,订单明细逐行重复,再用一条已有订单生成预览。

AI 会读取真实字段路径和子表绑定,校验文件,保存模板,再生成填充后的文件供检查。具体命令和定义格式见 Office 打印模板 CLI 操作。

文字/图片水印、颜色、透明度、尺寸和密度的配置请参阅 PDF 水印。水印仅作用于 PDF 输出。