Jasper 报告的执行
在 Windchill 中加载报告
加载 Jasper 报告时需要创建加载程序规范文件。请按照以下步骤执行:
1. 对于加载程序 XML,csvname 表示加载程序规范文件的名称,此名称应与 JRXML 文件的名称相同。报告对象与其关联的 JRXML 在名称本身方面存在一对一关系。
◦ csvinputPage 是指此报告对象所需的输入 jsp 页面。开发人员可以在其模块的 src_web 位置检入自己的 jsp,并且应在此标记下指定该路径。
◦ csvfolderPath 是指将在 Windchill 用户界面内创建报告对象的文件夹。
◦ csvreportTemplateName 是指 Windchill 用户界面中存在的报告模板名称。此字段是可选的,因此可将其留空,因为已在 JRXML 中捕获了所有报告模板信息。
◦ csvthirdPartyReport 是指应在值为 1 的第三方报告系统中执行的报告对象。
◦ csvreportingSystem 是指应在其中执行报告对象的报告系统的名称。值 JASPER 表明它应为 JASPER 系统的一部分,而值为空或 COGNOS 则会将其指定为在 Cognos 系统中运行。
◦ csvreportExportFormatType 是一个可选参数,以执行时所使用的默认格式加载报告。您可以稍后通过 Windchill 用户界面对此进行编辑。
2. 创建加载程序规范文件后,您可以编写自己的自定义 input.JSP 页面并将其部署到 Windchill 代码库中。
3. 将 jrxml 和相关的构件放在各自的文件夹中,但要确保这些文件夹位于 JasperReports 目录下。使用下面的命令对其进行编译。
windchill com.ptc.wbr.jasper.util.JRXMLCompiler {your_jrxml_filename}.jrxml
4. 从 Windchill shell 执行以下命令以加载报告对象。
windchill wt.load.LoadFromFile -u wcadmin -p wcadmin -d $WT_HOME/loadFiles/reports/{your_spec_filename}.xml
5. 执行完步骤 3 后,您可以验证通过 JRXML 文件创建的 .jasper 文件。完成对 JRXML 文件的编译。此文件极易受到安全攻击,因此会执行 jasper 文件格式的二进制表示。
6. 请确保将图像、字体或本地化资源等资源与 JRXML 文件位置放在一起。Jasper 引擎预期所有这些资源均相对于 JRXML 或 JASPER 文件进行保存。默认情况下,Windchill 支持 JVM 和 Jasper 引擎所支持的全部默认字体,而对于某些特殊字体,您需要在 Windchill 中进行手动添加。
7. 保留在 Windchill 内部的任何本地化资源束均应相对于 JRXML 位置。
在 Windchill 用户界面中的执行过程
必须遵循以下步骤:
1. 下图说明了报告对象的执行过程。导航到 Windchill 容器,然后在 Report 文件夹下的给定文件夹下找到此报告对象。
2. 如果指定了任何输入页面,则会在单击报告对象时显示该 jsp。
3. 如果不存在输入文件,则会如下显示输出:
4. 您可以在 QML 中定义任何条件/参数,并且这些条件/参数应为 input.JSP 页面的一部分。您通过 jsp 输入的每个条件均有效。