XDOC Office报表设计指南
1. 简介
XDOC Office报表是一个带标记的Office文档，技术人员会用数据替换这些标记，生成目标文档。
文档格式必须是：docx、xlsx、pptx。
标记的格式是： ${名称}。注意：前后都是半角字符，名称要简洁明了，不要带标点符号。
目前支持的编辑器有：微软Office2010/2013/2016/2019和WPS Office2019。
本文档中的操作说明是针对微软Office2010的，其他版本的操作说明地址如下：
2. Word报表
标记可以加在文本、图片、表格、文本框和图表上面。页眉、页脚中也可以包含标记。
2.1. 文本
在文档中直接输入标记，可以设置各种格式，如：${姓名}。实际传入的内容可以是单行文本、多行文本、html、图片、二维码、Office文档等。标记前加”!”，表示只接收纯文本，例如：${!姓名}
2.2. 试一试
报表做好后，在浏览器中打开：http://www.xdocin.com/xdoc?_func=resource，看看效果。
注意：企业版用户请将http://www.xdocin.com替换为本地部署的地址，如：http://192.168.40.2:8080/xdoc/xdoc?_func=resource，下面不再累述。
点击【去注册】，注册一个账号：
输入邮箱地址，点击【注册】，系统会将账号口令发送到你的邮箱中，如下图：
注册成功后登录，点击【调试】按钮，选中你的报表文件，系统会自动生成一份测试数据，点击【运行】就可以看到你的成果了。如下图：
|
模板 |
结果 |
|
|
|
2.3. 图片
插入示例图片，打开【设置图片格式】，在【可选文字】-【标题】中输入标记，如下图：
实际传入的内容可以是一张或多张图片，也可能是文档附件。
由于【可选文字】-【标题】标记不直观，可以为图片添加【批注】，方便技术人员查看。批注不是必须的，也不会出现在目标文档中。
示例
2.4. 表格
重复表格行
重复表格行标记为${@名称/}，只能放在表格行的左边第一个单元格中。运行时会根据传入的数据条数，重复显示。如果无数据传入，不显示。例如：
|
员工 |
|
${@员工/}${姓名} |
结果：
|
员工 |
|
关羽 |
|
张飞 |
|
赵云 |
可以加入${#}标记，对具有相同内容的同列相邻单元格进行合并，如：
|
公司 |
员工 |
|
${@公司员工/}${公司}${#} |
${员工} |
结果：
|
公司 |
员工 |
|
蜀 |
刘备 |
|
关羽 |
|
|
吴 |
孙权 |
通过合并单元格可以实现多行重复，例如：
|
${@教育经历1/}${学校} |
${专业} |
|
${毕业年份} |
可选表格行
可选表格行标记为${?名称/}，只能放在表格行的左边第一个单元格中。运行时传入值为true时，当前表格行显示，否则不显示，例如：
|
${?教育经历2/}${学校} |
${专业} |
${毕业年份} |
通过合并单元格可以实现多行可选，例如：
|
${?教育经历2/}${学校} |
${专业} |
|
${毕业年份} |
一个表格中可以有多个重复和可选行
2.5. 文本框
插入文本框，将文本框的【位置】设置为【嵌入文本行中】，如下图：
打开【设置形状格式】，在【可选文字】-【标题】中输入标记，如下图：
在文本框中输入标记，文本框中可以包含图片或表格。
文本框会根据传入的数据条数，重复显示。如果无数据传入，文本框不显示。
示例
${名称}
市值：${市值}亿美元
2.6. 图表
插入示例图表，打开【设置图表区格式】，在【可选文字】-【标题】中输入标记，如下图：
示例
2.7. 段落
重复
重复标记以${@名称}开始，以${/名称}结束，开始标记和结束标记分别占独立的段落。
运行时开始标记和结束标记中间的内容会根据传入的数据条数，重复显示。如果无数据传入，不显示。例如：
${@部门}
${部门名称} ${部门成立时间}
${/部门}
重复标记可以嵌套多层，例如：
${@部门}
${部门名称} ${成立时间}
${@员工}
${姓名} ${年龄}
${/员工}
${/部门}
可选
可选标记以${?名称}开始，以${/名称}结束，开始标记和结束标记分别占独立的段落。运行时传入值为true时，开始标记和结束标记中间的内容显示，否则不显示，例如：
${?自我描述}
本人性格开朗、为人诚恳、乐观向上、兴趣广泛、拥有较强的组织能力和适应能力、并具有较强的管理策划与组织管理协调能力。
${/自我描述}
2.8. 超链接
超链接也可以做标记，如下图：
2.9. 水印
文字水印
插入自定义水印，如下图：
选择【文字水印】，【文字】中输入标记，如下图：
图片水印
插入图片水印，如下图：
用鼠标双击页眉区域，进入页眉编辑状态，在水印图片上右击鼠标，弹出菜单，设置图片格式，如下图：
在【可选文字】中输入标记，如下图：
2.10. 签名
插入形状【自由曲线】，如下图：
随意绘制后，打开【设置形状格式】，在【可选文字】-【标题】中输入标记，如下图：
如果设置【形状填充】为黑色，【形状轮廓】为无轮廓，结果为普通黑色签名，如下图：
调用时传入的图片会自动转换为形状，显示打印清晰无马赛克。
2.11. 子模板
格式：${子模板地址}，如：${http://www.xdocin.com/demo/hello.docx}
支持协议：ftp、http、datauri，xdoc服务器中模板引用以“./”开始，如：${./hello.docx}
子模板可以接收来之父模板环境的参数。
模板格式支持：office模板、图片模板和xdoc模板。
子模板可以用在【文本标记】和【图片标记】中。
|
模板类型 |
文本标记结果 |
图片标记结果 |
|
docx |
内容 |
文件附件 |
|
xlsx、pptx |
文件附件 |
文件附件 |
|
jpg、png |
图片 |
图片 |
|
xdoc |
内容 |
图片 |
3. Excel报表
标记可以加在文本、图片和单元格上。
3.1. 文本
文本标记在单元格中直接输入，多行文本要设置自动换行。
3.2. 图片
插入示例图片，打开【设置图片格式】，在【可选文字】-【标题】中输入标记，如下图：
3.3. 单元格
在需要设置重复行的第一个单元格中插入批注，批注中输入标记，如下图：
可以加入${#}标记，对具有相同内容的同列相邻单元格进行合并。
通过合并单元格，可以实现多行重复。重复区可以放入图片，通过设置【可选文字】，实现图片列表。如下图：
注意：批注中只能包含标记，原来的用户信息要删除。
在重复行的单元格中输入标记。行会根据传入的数据条数，重复显示。如果无数据传入，不显示。
3.4. 单行可选/重复
单行可选标记为${?名称/}，只能放在表格行的左边第一个单元格中。运行时传入值为true时，当前表格行显示，否则不显示。
单行重复标记为${@名称/}，也只能放在表格行的左边第一个单元格中。运行时会根据传入的数据条数，重复显示。
例如：
3.5. 多行可选/重复
多行可选标记以${?名称}开始，以${/名称}结束，开始标记和结束标记分别占独立的行。运行时传入值为true时，开始标记和结束标记中间的内容显示，否则不显示，例如：
多行重复标记以${@名称}开始，以${/名称}结束，开始标记和结束标记分别占独立的行。运行时开始标记和结束标记中间的内容会根据传入的数据条数，重复显示。如果无数据传入，不显示。例如：
4. PowerPoint报表
标记可以加在文本、图片、图表和幻灯片上。
4.1. 文本
PPT文档中直接输入标记。
4.2. 图片
插入示例图片，打开【设置图片格式】，在【可选文字】-【标题】中输入标记，如下图：
可以图片添加批注，方便技术人员查看：
4.3. 图表
插入示例图表，打开【设置图表格式】，在【可选文字】-【标题】中输入标记，如下图：
可以为图表添加批注，方便便技术人员查看：
4.4. 幻灯片
在幻灯片备注中输入标记，在幻灯片内容中输入标记，内容中标记的名称是传入数据列表的字段名。
幻灯片会根据传入的数据条数，重复显示，生成多张幻灯片。如果无数据传入，幻灯片不显示。
5. 调用
调用参见：《XDOC Office报表调用指南》