XDOC WPS报表设计指南

1. 简介

XDOC WPS报表是一个带标记的WPS文档,技术人员会用数据替换这些标记,生成目标文档。WPS报表需要用WPS编辑,格式必须是docx、xlsx、pptx。建议使用WPS 2019,本文档中的操作截图也是使用WPS 2019完成的。

标记的格式是: ${名称}。注意:前后都是半角字符,名称要简洁明了,不要带标点符号。

2. 文字报表

标记可以加在文本、图片、表格、文本框和图表上面。页眉、页脚中也可以包含标记。

2.1. 文本

在文档中直接输入标记,可以设置各种格式,如:${姓名}。实际传入的内容可以是单行文本、多行文本、html、图片、二维码、WPS文档等。标记前加”!”,表示只接收纯文本,例如:${!姓名}

2.2. 试一试

报表做好后,在浏览器中打开:http://www.xdocin.com/xdoc?_func=resource,看看效果。

点击【去注册】,注册一个账号:

输入邮箱地址,点击【注册】。

注册成功后,点击【调试】按钮,选中你的报表文件,系统会自动生成一份测试数据,点击【运行】就可以看到你的成果了。如下图:

模板

结果

2.3. 图片

插入文本框,如下图:

在【可选文字】-【标题】中输入标记,如下图:

在文本框中插入示例图片,如下图:

实际传入的内容可以是一张或多张图片,也可能是文档附件。结果图片的大小和位置与文本框一致,样式与示例图片一致。

注意:作为图片标记的文本框中只能有示例图片,不能有其它内容。

示例

2.4. 文本框

插入文本框,将文本框的【布局选项】设置为【嵌入型】,如下图:

在【可选文字】-【标题】中输入标记,如下图:

在文本框中输入内容,内容可以包含文本标记。

文本框会根据传入的数据条数,重复显示。如果无数据传入,文本框不显示。

示例

${名称}

市值:${市值}亿美元

2.5. 图表

插入示例图表,如下图:

在【可选文字】-【标题】中输入标记,如下图:

示例

2.6. 段落

可选

可选标记以${?名称}开始,以${/名称}结束,开始标记和结束标记分别占独立的段落。运行时传入值为true时,开始标记和结束标记中间的内容显示,否则不显示,例如:

${?自我描述}

本人性格开朗、为人诚恳、乐观向上、兴趣广泛、拥有较强的组织能力和适应能力、并具有较强的管理策划与组织管理协调能力。

${/自我描述}

重复

重复标记以${@名称}开始,以${/名称}结束,开始标记和结束标记分别占独立的段落。

运行时开始标记和结束标记中间的内容会根据传入的数据条数,重复显示。如果无数据传入,不显示。例如:

${@部门}

${部门名称} ${部门成立时间}

${/部门}

重复标记可以嵌套多层,例如:

${@部门}

${部门名称} ${成立时间}

${@员工}

${姓名} ${年龄}

${/员工}

${/部门}

2.7. 表格

可选表格行

可选表格行标记为${?名称/},只能放在表格行的左边第一个单元格中。运行时传入值为true时,当前表格行显示,否则不显示,例如:

${?教育经历1/}${学校} 

${专业}

${毕业年份}

支持合并单元格跨多行,例如:

${?教育经历1/}${学校}

${专业}

${毕业年份}

重复表格行

重复表格行标记为${@名称/},只能放在表格行的左边第一个单元格中。运行时会根据传入的数据条数,重复显示。如果无数据传入,不显示。例如:

${@教育经历2/}${学校} 

${专业}

${毕业年份}

支持合并单元格跨多行,例如:

${@教育经历2/}${学校}

${专业}

${毕业年份}

2.8. 超链接

超链接也可以做标记,如下图:

2.9. 文字水印

插入水印,如下图:

选择【文字水印】,【内容】中输入标记,如下图:

2.10. 子模板

格式:${子模板地址},如:${http://www.xdocin.com/demo/hello.docx}

支持协议:ftp、http、datauri,xdoc服务器中模板引用以“./”开始,如:${./hello.docx}

子模板可以接收来之父模板环境的参数。

模板格式支持:WPS模板、图片模板和XDOC模板。

子模板可以用在【文本标记】和【图片标记】中。

模板类型

文本标记结果

图片标记结果

docx

内容

文件附件

xlsx、pptx

文件附件

文件附件

jpg、png

图片

图片

xdoc

内容

图片

3. 表格报表

标记可以加在文本、图片和单元格上。

3.1. 文本

文本标记在单元格中直接输入,多行文本要设置自动换行。

3.2. 图片

插入示例图片,在【可选文字】-【标题】中输入标记,如下图:

3.3. 单元格

在需要设置重复行的第一个单元格中插入批注,批注中输入标记,如下图:

通过合并单元格,可以实现多行重复。重复区可以放入图片,通过设置【可选文字】,实现图片列表。如下图:

注意:批注中只能包含标记,原来的用户信息要删除。

在重复行的单元格中输入标记。行会根据传入的数据条数,重复显示。如果无数据传入,不显示。

3.4. 单行可选、重复

单行可选标记为${?名称/},只能放在表格行的左边第一个单元格中。运行时传入值为true时,当前表格行显示,否则不显示。

单行重复标记为${@名称/},也只能放在表格行的左边第一个单元格中。运行时会根据传入的数据条数,重复显示。

例如:

3.5. 多行可选、重复

多行可选标记以${?名称}开始,以${/名称}结束,开始标记和结束标记分别占独立的行。运行时传入值为true时,开始标记和结束标记中间的内容显示,否则不显示,例如:

多行重复标记以${@名称}开始,以${/名称}结束,开始标记和结束标记分别占独立的行。运行时开始标记和结束标记中间的内容会根据传入的数据条数,重复显示。如果无数据传入,不显示。例如:

4. 演示报表

标记可以加在文本、图片、图表和幻灯片上。

4.1. 文本

幻灯片中直接输入标记。

4.2. 图片

插入示例图片,在【可选文字】-【标题】中输入标记,如下图:

4.3. 图表

插入示例图表,在【可选文字】-【标题】中输入标记,如下图:

4.4. 幻灯片

在幻灯片备注中输入标记,在幻灯片内容中输入标记,内容中标记的名称是传入数据列表的字段名。

幻灯片会根据传入的数据条数,重复显示,生成多张幻灯片。如果无数据传入,幻灯片不显示。

5. 调用

调用参见:《XDOC Office报表调用指南》

目录
目录
XDOC WPS报表设计指南
1.简介
2.文字报表
2.1.文本
2.2.试一试
2.3.图片
2.4.文本框
2.5.图表
2.6.段落
2.7.表格
2.8.超链接
2.9.文字水印
2.10.子模板
3.表格报表
3.1.文本
3.2.图片
3.3.单元格
3.4.单行可选、重复
3.5.多行可选、重复
4.演示报表
4.1.文本
4.2.图片
4.3.图表
4.4.幻灯片
5.调用