区域界定结构、字段标记填值点、区块是图表格式样本
这篇解决「做一份模板到底要标什么、系统认什么」的问题。记住一句话:版式全部在 Word 里排好,系统只认标记。
一、区域:文档的骨架
选中最外层的一段内容,插入书签,命名为 xh_区域_封面中文、xh_区域_摘要中文 这样的区间书签。区域的数量、名称、顺序由你的 docx 决定。
- 模板必须包含固定正文区域
xh_区域_正文,缺了上传会被拒。 - 至少要有 1 个区域,否则不能上传。
- 区域书签是外层容器,里面可以同时放字段和区块。
二、字段:要填值的位置
字段全名 = xh_类型_字段名,类型段只表示值从哪来:
| 类型 | 来源 | 例子 |
|---|---|---|
| 用户 | 生成时用户在表单里填 | xh_用户_姓名中文 |
| 草稿 | 从草稿正文里抽 | xh_草稿_图题名 |
| 系统 | 系统自动生成或取字典 | xh_系统_声明日期 |
字段有两种形态,同一个字段全名只能选一种:
- 点书签:书签名就是字段全名,适合单点锚定、需要保留审计锚点。
- 占位符:在文字里写
{##xh_用户_姓名中文##},同一字段可以出现多处。
注意:书签字段的范围里只能有示例文字,不能出现占位符、域、图片、表格或另一个书签;否则会报「书签字段范围内只能有纯示例文字」一类错误,禁止发布。
三、区块:图表的格式样本
用内容控件(SDT)圈出图表区域,Tag 写成 xh_区块_图 或 xh_区块_表。系统拿它当格式样本,按草稿里的每条记录复制一份。
- 图区块里必须有一张真实图片(既是位置也是版式样本)。
- 表区块里必须有一张示例表格;表格单元格里不能写任何 xh_ 标记。
- 题注用 Word「引用 → 插入题注 → 编号 → 包含章节号」生成,编号规则由模板里的域决定。
命名限制:书签不超过 40 字符、不能有空格、不能以数字开头、全局唯一。类型段不能省,否则系统判断不出来源。
下一步:配置项与上传动作看《模板配置 xh_配置 与上传流程》。
