Word 与 Excel 模板
点击 新模板,选择 Word 或 Excel,即可使用 .docx 或 .xlsx 文件制作可重复使用的打印模板。在 Word 或 Excel 中调整内容、样式并插入字段占位符,再上传到打印设计。
上传和替换模板
- 新建对应格式的模板
- 在 模板信息 中填写名称、设置作用范围
- 在 上传模版 下点击 点击上传,选择对应的
.docx或.xlsx文件,大小不超过 20 MB - 按钮下方显示上传的文件列表,右侧工作区预览源文件
- 保存后,在 预览 中选择真实记录,检查填充后的结果
未上传文件时,工作区显示 暂未上传模版。需要替换时,在本地修改文件,再重新上传同一格式的文件。
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 输出。