ActiveReports11 新特性(3): JSON数据的使用

发布时间:2016/10/31 00:10 发布者:Lenka.Guo

返回博客中心

 

JSON数据格式已成为互联网的DNA。因此在AR11中我们智慧的开发者们也教会AR来使用JSON 数据源,增加了对JSON 数据的支持:

  • 文件系统
  • Web服务
  • REST API

AR不仅支持静态时直连JSON数据,也支持为报表绑定运行时JSON数据;页面和RDL 报表均提供了JSON 数据提供器。

使用场景

1. 第三方产品支持导出JSON 格式数据,如Google Analytics,开发人员经常与这些JSON数据打交道,无论是本地的或网络的。

2. Web Service或REST API 调用返回的JSON数据。开发人员可以绑定这些数据到报表上。

JSON 连接字符串和查询语句定义

JSON 数据源的连接字符串支持:

  • Json schema 可以是URL 或文件路径
  • 内嵌JSON Schema
  • JSON 数据文件可以是引用外部json 文件的url或路径,这些文件中必须包含 ”xmldoc”关键字。如:

jsondoc=http://www.xmlfiles.com/examples/cd_catalog.json

使用”jsondata”关键字将数据内嵌到报表中,如:

jsondata={"employees":[
{"firstName":"John", "lastName":"Doe"},
{"firstName":"Anna", "lastName":"Smith"},
{"firstName":"Peter", "lastName":"Jones"}
]}

支持表达式的使用,表达式可以在运行时使用,如依赖用户使用上下文的json数据源。

数据集查询语句遵循JSON PATH的规范。

设计时支持

JSON 数据源属性对话框

clip_image002

用户需要指定json Schema,JSon 数据内容。

Json Schema可以是外部文件或网址,也可以是内嵌的用于解析Json数据的格式。

JSON 内容是用户绑定的具体的JSON数据源,可以是外部文件或URL,内嵌或表达式。

外部数据,可以选择本机文件,URL可以是其他网络数据。

内嵌,则是用户能够选择一个文件来读取数据源,并增加到报表定义中。

表达式类型是用户手动选择的类型(支持复制粘贴)连接字符串。

设计时必须输入Schema的文件或URL,如果是运行时数据源,JSON data不需要指定。

JSON可视化查询设计器展示了数据结构,这个数据结构也是通过我们提供JSON Schema获得的。并不是实际的JSON 文件。

clip_image004

1. 新建RDL 报表

clip_image006

2. 添加数据源

选择JSON 类型

clip_image008

选择Schema

如果您不知道具体的JSON Schema ,推荐网站可根据您的Json Data生成对应的Schema:

http://jsonschema.net/#/

 

clip_image010

设置内容

clip_image012

查看连接字符串

clip_image014

添加数据集

右键单击“DataSource1”选择添加数据集

clip_image015

选择可视化查询设计器

JSON查询生成器,会根据您指定的JSON Schema生成具体的Json结构,可根据选择生成查询语句

clip_image017
clip_image019

选择节点后,点击确定,自动生成查询语句,点击确定后,会生成可选的字段名称。

clip_image021

在数据控件中绑定数据

clip_image023

 

 

您在使用产品过程中有任何疑问,可以登录葡萄城开发者社区和经验丰富的技术工程师、ActiveReports开发人员交流:了解更多

了解ActiveReports产品更多特性:

/developer/activereports

下载产品体验产品功能:

/download/?pid=16


关于葡萄城

赋能开发者!葡萄城是专业的集开发工具、商业智能解决方案、低代码开发平台于一身的软件和服务提供商,为超过 75% 的全球财富 500 强企业提供服务。葡萄城专注控件软件领域30年,希望通过模块化的开发控件、灵活的低代码应用开发平台等一系列开发工具、解决方案和服务,帮助开发者快速响应复杂多变的业务需求,最大程度地发挥开发者的才智和潜能,让开发者的 IT 人生更从容更美好。

了解详情,请访问葡萄城官网