在Sheet-to-Doc中，占位符是连接Excel数据和Word模板的桥梁。通过使用不同类型的占位符，我们可以实现数据自动填入Word指定位置，创建个性化的文档。今天，我将详细介绍Sheet-to-Doc的占位符系统，帮助你掌握各种占位符的使用技巧。
什么是占位符？
占位符是在Word模板中使用特殊语法标记的位置，Sheet-to-Doc工具会将这些位置替换为Excel数据中的对应值。占位符的基本格式是{占位符名称}，工具会根据占位符的类型和名称进行不同的处理。
1. 数据占位符：最基础的占位符类型
数据占位符是最常用的占位符类型，用于将Excel中的单个数据值填入Word模板中。
语法
使用方法
- 在Excel表格中定义列名，例如「姓名」、「年龄」、「邮箱」等
- 在Word模板中使用
{列名}的格式添加占位符
- 工具会自动将占位符替换为Excel中对应行的列值
示例
Excel数据
Word模板
1
2
3
4
5
| 个人信息表
姓名：{姓名}
年龄：{年龄}
邮箱：{邮箱}
|
生成的文档
2. 图片占位符：在Word中插入动态图片
图片占位符用于将图片动态插入到Word文档中。使用图片占位符，你可以根据Excel数据中的图片名称，将不同的图片插入到生成的文档中。
语法
1
2
| {@图片列名 | _inline_image:width:height}
{@图片列名 | _block_image:width:height}
|
使用说明
@图片列名：图片占位符必须以@开头，图片列名是Excel中存储图片名称的列名_inline_image：内联图片，与文本紧密结合_block_image：块级图片，与段落独立width和height：可选参数，指定图片宽度和高度（厘米为单位）
使用方法
- 在Excel表格中添加一列，用于存储图片名称
- 在Word模板中使用
{@图片列名 | _inline_image}或{@图片列名 | _block_image}的格式添加图片占位符
- 上传图片文件到Sheet-to-Doc工具
- 工具会根据Excel数据中的图片名称，将对应的图片插入到文档中
示例
Excel数据
| 姓名 |
产品 |
产品图片 |
| 张三 |
手表 |
watch.png |
| 李四 |
充电宝 |
batterybank.png |
Word模板
1
2
3
4
5
6
7
8
9
10
11
| 产品推荐
尊敬的{姓名}先生/女士：
我们为您推荐以下产品：
产品名称：{产品}
产品图片：
{@产品图片 | _inline_image}
感谢您的关注！
|
生成的文档
1
2
3
4
5
6
7
8
9
10
11
| 产品推荐
尊敬的张三先生/女士：
我们为您推荐以下产品：
产品名称：手表
产品图片：
[watch.png图片](说明，此处为图片哈，本博客文章就不显示了)
感谢您的关注！
|
3. 循环占位符：处理重复数据
循环占位符用于处理Excel中的多行数据，实现重复内容生成。Sheet-to-Doc支持两种循环占位符。
3.1 循环占位符1：固定语法，仅支持生成模式2
语法
3.1.1 使用说明
- 固定语法，不可自定义名称
- 只能在生成模式2（单文档）下生效
- 用于将所有数据生成到一个文档中
3.1.2 示例
Excel数据
Word模板
1
2
3
| {#data}
{姓名},{年龄},{性别}。
{/data}
|
生成的文档
3.2 循环占位符2：通用版本，支持生成模式1和2
语法
3.2.1 使用说明
- 可自定义循环名称（不能是
data）
- 支持生成模式1和2
- 需要特殊处理Excel数据（添加前缀）
3.2.2 示例
Excel数据（需添加前缀）
| 资料.姓名 |
资料.年龄 |
资料.性别 |
| 张三 |
25 |
男 |
| 李四 |
30 |
女 |
Word模板（生成模式1）
1
2
3
| {#资料}
{姓名},{年龄},{性别}。
{/资料}
|
Word模板（生成模式2）
1
2
3
4
5
| {#data}
{#资料}
{姓名},{年龄},{性别}。
{/资料}
{/data}
|
5. 判断占位符：根据条件显示内容
判断占位符用于根据Excel数据中的值，决定是否显示某些内容。Sheet-to-Doc支持三种判断占位符。
5.1 判断占位符1：True/False判断
语法
使用说明
- 当条件列值为
true时，显示内容
- 当条件列值为
false时，不显示内容
示例
Excel数据
| 姓名 |
年龄 |
获奖 |
| 张三 |
25 |
true |
| 李四 |
30 |
false |
Word模板
1
2
3
4
5
| {#data}
{#获奖}
{姓名}获得了奖项！
{/获奖}
{/data}
|
生成的文档
5.2 判断占位符2：等于/不等于判断
语法
1
2
| {#条件 == "值"}显示内容{/}
{#条件 != "值"}显示内容{/}
|
使用说明
- 支持字符串和数字比较
- 字符串需要用英文双引号包裹
- 数字可以直接使用，不需要引号
示例
Excel数据
Word模板
1
2
3
4
5
6
7
8
9
| {#data}
{姓名}获得了{奖品}。
{#奖品 == "手表"}
这是一块手表！
{/}
{#奖品 == "充电宝"}
这是一个充电宝！
{/}
{/data}
|
5.3 判断占位符3：大小比较
语法
1
2
3
4
| {#条件 > 值}显示内容{/}
{#条件 >= 值}显示内容{/}
{#条件 < 值}显示内容{/}
{#条件 <= 值}显示内容{/}
|
使用说明
示例
Excel数据
Word模板
1
2
3
4
5
6
| {#data}
{姓名}今年{年龄}岁。
{#年龄 >= 30}
{姓名}是30岁及以上的人。
{/}
{/data}
|
生成的文档
1
2
3
| 张三今年25岁。
李四今年35岁。
李四是30岁及以上的人。
|
占位符使用最佳实践
1. 保持占位符名称与Excel列名一致
确保Word模板中的占位符名称与Excel表格中的列名完全一致，包括大小写和空格。
2. 使用清晰的列名
选择简洁明了的列名，避免使用过于复杂或容易混淆的名称。
3. 测试占位符
在生成大量文档之前，先使用少量数据进行测试，确保占位符能正确替换为对应的数据。
4. 利用数据比对功能
Sheet-to-Doc提供了数据比对功能，可以帮助你发现模板中存在的错误占位符，建议每次生成文档前都进行数据比对。
5. 嵌套使用占位符
你可以嵌套使用不同类型的占位符，例如在循环占位符中使用数据占位符和判断占位符，创建更复杂的文档结构。
总结
Sheet-to-Doc的占位符系统非常强大，支持多种类型的占位符，包括数据占位符、图片占位符、循环占位符和判断占位符。通过灵活使用这些占位符，你可以创建各种复杂的文档模板，实现从Excel到Word的自动化转换。
在接下来的系列文章中，我们将深入探讨Sheet-to-Doc的高级功能，包括循环占位符的使用技巧、图片处理、数据格式支持等。请持续关注！