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.调用