ActiveReports使用教程:如何添加数据集
ActiveReports 是一款专注于 .NET 平台的报表控件,全面满足 HTML5、WinForm、ASP.NET、.NET Core、WPF 等平台下的中国式复杂报表设计和跨平台报表开发需求,作为专业的报表工具为全球超过 300,000 名开发者提供全面的报表解决方案。
在Page报表或RDL报表中,将报表连接到数据源后,为了获取要在报表中使用的字段列表,需要添加数据集。使用以下说明将数据集添加到报表中。
注意:CSV 数据源的数据集是在添加数据源时自动创建的。
这些步骤假定您已经添加了Page Report / RDL Report模板并将其连接到数据源。
1、在“报表资源管理器”中,右键单击数据源节点(默认为DataSource1),然后选择“添加数据集”选项或从“添加”按钮中选择“数据集...”。
2、在出现的“数据集” 对话框中,选择“常规”页面,然后输入数据集的名称。此名称显示为报表资源管理器中数据源图标的子节点。
3、在此对话框的“查询”页面上,从下拉列表中选择“命令类型”。
- 文本-允许用户在“查询”框中输入SQL查询或XML路径。
- StoredProcedure-允许用户在“查询”框中输入存储过程的名称。
- TableDirect-允许用户在“查询”框中输入表的名称。
4、单击“查询”框上方右上角的“验证数据集”图标以验证查询。
5、这些字段将自动添加到“数据集”对话框的“字段”页面中。对于XML数据,请使用有效的XPath表达式在“字段”页面上手动输入字段。
6、您还可以在对话框的其他页面上设置参数、过滤器和数据选项。
7、单击确定按钮关闭对话框。您的数据集和查询字段在报告资源管理器中显示为节点。
注意:如果您使用的是XML或JSON数据源提供程序,则必须使用“查询”页面上的XPath或JSONPath表达式提供XML路径或JSON路径,并在“数据集”对话框的“字段”页面上生成字段。有关详细信息,请参见以下示例。
XML数据的查询和字段设置
连接字符串
xmldata连接字符串的示例
xmldata=<people>
<person>
<name>
<given>John</given>
<family>Doe</family>
</name>
</person>
<person>
<name>
<given>Jane</given>
<family>Smith</family>
</name>
</person>
</people>;
查询页面上的XMLPath
与查询一起评估时,XMLPath表达式从XML数据源返回一个值。XML路径用斜杠(/)表示,方括号([])表示元素集合上的迭代。
例如:/ people / person / name
您还可以使用XML数据集查询生成器来构建XMLPath。单击“使用XML查询设计器编辑”图标以打开“XML数据集查询生成器”对话框,然后从树节点中选择XPath。
领域
设置查询后,请使用包含以下名称和值对的两个字段来构建Fields集合:
名称:given; 值:given
名称:family; 值:family
JSON数据的查询和字段设置
连接字符串
JSON数据连接字符串的示例。
jsondoc=C:\Data\customers.json;schemadata={ "$schema": "//json-schema.org/draft-04/schema#", "type": "object", "properties": { "address": { "type": "object", "properties": { "streetAddress": { "type": "string" }, "city": { "type": "string" } }, "required": [ "streetAddress", "city" ] }, "phoneNumber": { "type": "array", "items": { "type": "object", "properties": { "location": { "type": "string" }, "code": { "type": "integer" } }, "required": [ "location", "code" ] } } }, "required": [ "address", "phoneNumber" ] }
查询页面上的JSONPath
与查询一起评估时,JSONPath表达式从JSON数据源返回一个值。JSON路径通常以点(.)表示,根对象为'$'。方括号([])表示元素的数组。
例如:$ .Customers [*]
您还可以使用JSON查询构建器构建JSONPath,可以通过JSON查询设计器图标编辑进行访问。JSON查询构建器显示从JSON模式获得的JSON数据的结构。您可以从树节点中选择JSONPath。您还可以选择创建多个数据集-只需选中“选择多个节点”选项,然后选择要添加为数据集的节点。
领域
设置查询后,请使用包含以下名称和值对的两个字段来构建Fields集合:
名称:CompanyName; 值:CompanyName
名称:ContactName; 值:ContactName
相关内容推荐:
ActiveReports使用教程:如何在.Net Core 平台中实现 HTTP Handlers 功能