XML数据源

准备工作:新建XML和XML Schema文件。

1 设计器中xml数据源的创建及使用

1.1  创建xml数据源

单击“语义”菜单的“数据源映射”命令,或选择某个项目,右击——新建——数据源映射,出现“新建数据源”对话框,选择需要创建关系数据源的项目,输入数据源名称,选择数据源类型为“xml数据源”,如图:

单击“下一步”,在XML数据源文件设置界面有三个操作按钮【新建】、【编辑】、【删除】,编辑和删除按钮是对已经设计好的文件进行操作,即选择需要操作的XML数据源文件,然后点击按钮,即可进行后续操作。这里重点说明新建XML数据源文件的操作。如图:

单击“新建”按钮,出现“设置xml数据源相关文件”对话框,输入定义名称,选择xml文件和xml schema文件的存放路径,xml文件和xml schema文件的编码是可选项,如果需要可以填写。如图:

编辑完成后,点击【确定】,这样,配置好的xml数据源信息将会显示在xml数据源信息列表中。如图:

单击【完成】按钮即可。

1.2  在报表中的使用

创建一张新的报表,然后单击“摘要”视图中“”按钮,打开“新建数据集”对话框,如图:

然后输入数据集名称,选择数据源,这里选择我们刚刚创建的“xml”数据源,类型这里选择“Xpath”,单击“下一步”,如图:

选择数据源中的xml文件定义后,单击“下一步”,出现“设置行映射”对话框,即设置报表数据行与XML数据源的映射关系。窗口左侧显示XML文档结构,如果节点含有子节点,则该节点前会显示“+”号,鼠标单击节点前的“+”号,则展开节点,显示所有子节点。

窗口右侧是选择的XML节点,即XPath表达式。

用户可以选中左侧文档结构中的节点,单击中间的【设置行映射】按钮,弹出【行映射】设置页面,根据需要进行设置,也可以直接在选择xml节点中,直接编写XPath表达式。如图:

编辑完成后,单击“下一步”,即设置报表数据列与XML数据源的映射关系。

可以在左侧的【XML文档结构】中的某一个节点,然后单击中间的“添加一列”()或“添加多列”()按钮,将某一节点或其子节点添加到右侧的列映射中,如图:

也可以在右侧的【列映射】中点击“新建”按钮,弹出“列映射表达式”编辑界面,编辑好列名、数据类型、XPath,点击“确定”即可,如图:

设置完成后,单击“完成”按钮即可在报表中使用了。

2 服务器端数据源的配置

 xml数据源直接在报表应用的WEB-INF\resources\report_config.xml文件中配置就可以了,如下:

  <dataSource type="xml">
    <Name>xml</Name><!—xml数据源名称,与设计器中一致 -->
    <Def name="test" xml="E:\server\xml\test.xml"  encode=""/>
    <!-- 配置XML文件定义,同一个XML数据源可以配置多个XML文件定义,其中,“name”为XML文件定义名称,与设计器中一致;“xml”为xml数据文件的路径-->
  </dataSource>

这样服务器端的xml数据源就配置完成了,将报表放到报表应用的WEB-INF\reports文件下,然后启动Tomcat,在web地址栏输入然后单击报表名称,查看一下报表是否正常显示。