高级自定义 > 业务逻辑自定义 > 报告生成 > 报告加载 > 目标
  
目标
目标
您想要向 Windchill Business Reporting (WBR) 系统中加载报告对象。
背景
Windchill Business Reporting (WBR) 解决方案使用系统中的 Windchill 和 Cognos 对象。通常,这些对象是在其他系统 (例如开发系统) 中开发的,随后会被移至生产中使用它们的其他系统中。本文档介绍了如何将这些报告对象加载到系统中。
对于 Windchill 业务对象,使用标准 Windchill 数据加载机制。这些工具基于 XML 文件中的描述对象及其属性。加载是通过实例化业务对象、填充 XML 文件中指定的属性以及使用标准 Windchill 创建 API 来完成的。
对于 Cognos 报告对象,使用标准 Cognos SOAP API。Cognos 报告属性在 Java 特性文件中指定,而报告的定义在关联的 XML 文件中指定。对这些文件进行处理,并将数据传递到 Cognos SOAP API 以创建报告。
范围/适用性/假设
本文档假定已成功安装并配置了 Windchill Business Reporting (WBR) 解决方案 (即 Cognos)。Windchill 实例名称称为 <WindchillInstanceName>。Cognos 的根 URL 称为 <WBRHomeURL>。通常,如果 WBR 解决方案安装在 <WBRHost> 上,则 <WBRHomeURL> 将为 http://<WBRHost>/Cognos/cgi-bin/cognos.cgi。假定您可以登录到 <WBRHomeURL>,并且您具有足够的 Cognos 权限来查看 Windchill 数据源对象和创建报告。
假定您有权访问 Windchill 服务器任务目录 <WindchillHome>\tasks,能够在其关联的子目录 <MyTaskPackage> 中创建 Info*Engine 任务 <MyTask>。假定已在其他源系统 <WindchillSourceHome> 上开发出此任务并进行了测试。
假定您有权在其他源系统 <WindchillSourceHome> 的站点上下文中访问 Windchill UI 和 ReportTemplate <MyReportTemplate>。
假定您将加载新的 Windchill 报告对象 <MyReport>,且该对象将使用 <MyReportTemplate> 从 Windchill 检索数据。此外,假定您能够在 Windchill 的站点上下文中创建报告对象。
在进行 WBR 集成时,您还必须具有更新报告元模型的访问权限。
解决方案
为报告对象构造加载文件并加以执行。
自定义点
过程 - 加载多个任务数据源
在上述主要过程“过程 - 加载 Info*Engine 任务数据源”中,加载了单个 Info*Engine 任务。要加载多个任务,请对每个任务重复步骤 1。
其余的每个步骤只需执行一次。在最后一步中,验证是否已加载所有数据源。
过程 - 加载多个 ReportTemplate 数据源
在上述主要过程“过程 - 加载 ReportTemplate 数据源”中,加载了单个 ReportTemplate。要加载多个 ReportTemplate,请在步骤 2 中为每个 ReportTemplate 指定一个单独的 "csvReportTemplate" 元素。
其余的每个步骤只需执行一次。在最后一步中,验证是否已加载所有数据源。
过程 - 加载多个 Windchill 报告对象
在上述主要过程“过程 - 加载 Windchill 报告对象”中,加载了单个 Windchill 报告对象。要加载多个 Windchill 报告对象,请在步骤 2 中为每个对象指定一个单独的 "csvReport" 元素。
其余的每个步骤只需执行一次。在最后一步中,验证是否已加载所有 Windchill 报告对象。
过程 - 指定 Windchill 报告对象属性
在上述主要过程“过程 - 加载 Windchill 报告对象”中,仅指定了基本 Windchill 报告对象属性。以下是可指定的其他属性。有关其他信息,请参阅报告 Javadoc。
csvReport 元素
说明
csvname
必需。此条目用于指定报告的名称。
csvcontainerPath
可选。此条目用于指定应将报告存储到的容器。如果未指定任何值,则默认情况下会使用站点容器。
csvdescription
可选。此条目用于指定报告的说明。
csvinputPage
可选。此条目用于指定报告的输入页面。
csvresourceBundle
可选。此条目用于指定报告的资源束。
csvuiContext
可选。此条目用于指定用来控制报告在 Windchill UI 中的显示位置的 UI 上下文掩码。
csvreadyForUse
可选。此条目用于指定报告是否可供最终用户使用。如果未指定任何值,则默认值为 false。
csvsoapClass
可选。如果报告使用报告任务作为其数据源,则此条目用于指定 soap 类。此元素与 "csvsoapMethod" 元素一起使用以完全指定报告任务。报告必须将报告任务或 ReportTemplate 指定为其数据源。
csvsoapMethod
可选。如果报告使用报告任务作为其数据源,则此条目用于指定 soap 方法。此元素与 "csvsoapClass" 元素一起使用以完全指定报告任务。报告必须将报告任务或 ReportTemplate 指定为其数据源。
csvreportTemplateName
可选。如果报告使用 ReportTemplate 作为其数据源,则此条目用于指定 ReportTemplate 名称。此元素与 "csvreportTemplateContainerPath" 元素一起使用以完全指定 ReportTemplate。报告必须将报告任务或 ReportTemplate 指定为其数据源。
csvreportTemplateContainerPath
可选。如果报告使用 ReportTemplate 作为其数据源,则此条目用于指定 ReportTemplate 名称。此元素与 "csvreportTemplateName" 元素一起使用以完全指定 ReportTemplate。报告必须将报告任务或 ReportTemplate 指定为其数据源。
过程 - 加载多个 Cognos 报告
在上述主要过程“过程 - 加载 Cognos 报告”中,加载了单个 Cognos 报告。
要加载多个 Cognos 报告,请对每个 Cognos 报告重复步骤 3 和步骤 4。其余的每个步骤只需执行一次。在最后一步中,验证是否已加载所有 Cognos 报告。
过程 - 指定 Cognos 报告属性
在上述主要过程“过程 - 加载 Cognos 报告”中,仅指定了基本 Cognos 报告属性。以下是可指定的其他属性。
特性名称
说明
type
可选。此条目用于指定报告的类型。有效值为 report、query 和 reportTemplate。如果未指定值,则默认值为 "report"。
defaultName
必需。此条目用于指定报告的名称。
defaultDescription
可选。此条目用于指定报告的说明。
resourceBundle
可选。此条目用于指定用来本地化相应 Cognos 报告规范 XML 文件中条目的 Java 资源束的名称。
限制
对于 Cognos 报告加载,存在用于 Windchill 预设报告的加载文件目录。这些目录不应用于自定义加载文件。保留目录为 <WindchillHome>\loadFiles\cognosReports 和 <WindchillHome>\loadFiles\cognosReports\<assemblyId>,其中 <assemblyId> 是标准 Windchill 装配 ID,如 wnc、pdml、pjl 等。
示例代码
Windchill 代码中的使用示例
有多个预设报告使用了本文档中所述的加载文件。这些报告位于 <WindchillHome>\loadFiles、<WindchillHome>\loadFiles\reports 和 <WindchillHome>\loadFiles\cognosReports 目录中。
随附的示例
<WindchillHome>\loadXMLFiles\DemoReports.xml 中提供了 Windchill ReportTemplate 和报告对象的演示加载文件。
更多资源
报告 Info*Engine 任务数据源自定义
ReportTemplate 数据源自定义
Cognos 演示自定义
相关的包/类 Javadoc
Foundation 模块
wt.query.qml
Reporting 模块
Reporting 模块
com.ptc.windchill.enterprise.report
其他相关 Windchill 文档
Info*Engine User's Guide (《Info*Engine 用户指南》)
数据加载和 LoadFromFile 框架简介
Info*Engine 实施
专业化管理
报告管理联机帮助
相关网站
http://www.ibm.com/cognos/support