ReportTemplate 数据源自定义

高级自定义 > 业务逻辑自定义 > 报告生成 > ReportTemplate 数据源自定义

目标

您想要创建一个新的 Windchill 数据查询以在报告中使用。

背景

Windchill Business Reporting (WBR) 解决方案使用数据源对象从 Windchill 检索数据。ReportTemplate 是一种数据源类型。ReportTemplate 是通过报告管理实用程序维护的标准持续 Windchill 业务对象。它会启动查询构建器，以创建和编辑作为 ReportTemplate 的一部分而存储的查询。执行 ReportTemplate 查询时，使用的标准 Windchill API 将应用所有 Windchill 业务逻辑 (例如调用 Windchill 对象方法、应用访问控制等)。创建新的 ReportTemplate 对象后，可从报告对象中对其进行引用，或将其作为自定义数据源在 WBR 解决方案中显示和使用。

范围/适用性/假设

本文档假定已成功安装并配置了 Windchill Business Reporting (WBR) 解决方案 (即 Cognos)。Windchill 实例名称称为 <WindchillInstanceName>。Cognos 的根 URL 称为 <WBRHomeURL>。通常，如果 WBR 解决方案安装在 <WBRHost> 上，则 <WBRHomeURL> 将为 http://<WBRHost>/cognos8/cgi-bin/cognos.cgi。假定您可以登录到 <WBRHomeURL>，并且您具有足够的 Cognos 权限来查看 Windchill 数据源对象和创建报告。

假定您具有一定的访问权限，能够在站点上下文中创建 ReportTemplate 业务对象 <MyReportTemplate>。

在进行 WBR 集成时，您还必须具有更新报告元模型的访问权限。

此文档不包含有关如何构造 ReportTemplate 查询的详细信息。有关此类信息，请参阅查询构建器联机教程和帮助。

预期结果

此解决方案的最终结果是创建可用于创作 Cognos 报告的数据源。

解决方案

使用报告管理和查询构建器构造 ReportTemplate 数据源。

必备知识

要实现此目标，需要了解以下内容：

• 报告管理用户界面

• 查询构建器用户界面

• 与将在 ReportTemplate 查询中使用的 Windchill 业务对象相关的区域的 Windchill 数据模型

• JConsole 用户界面

• Cognos 用户界面

解决方案元素

元素	类型	说明
<MyReportTemplate> Windchill ReportTemplate	Windchill 对象	用于指定供检索 Windchill 数据之用的查询的 Windchill 对象。

过程 - 创建 ReportTemplate 数据源

1. 导航到 Windchill“站点”>“实用程序”并启动“报告管理”实用程序。

2. 在“报告管理”UI 中，单击“新建”以启动查询构建器。

3. 创建 ReportTemplate 查询并加以保存。这将在 Windchill 中创建一个可用作 WBR 数据源的 ReportTemplate 业务对象。

4. 更新 Cognos 模型以识别此新数据源。从已安装的 Windchill 快捷方式启动 JConsole。连接到 Embedded Servlet Engine (基于 Tomcat) JVM 实例。从 MBeans 选项卡的 "com.ptc > Monitors > ReportingSystem" 中选择报告管理 bean。在 Operations 选项卡中，单击 "updateModel"。

5. 验证数据源是否存在于 Cognos 中。使用 <WBRHomeURL> 登录到 Cognos，并启动 "Report Studio"。在 "Insertable Objects" 窗口中 "Source" 选项卡的 "Windchill > Report Templates" 下查找 <MyReportTemplate> 数据源。

自定义点

过程 - 在非站点上下文中创建 ReportTemplate 数据源

在上述主要过程中，在站点上下文中创建了 ReportTemplate。Windchill 的站点上下文与 "Source" 选项卡的 "Windchill > Report Templates" 级别相关联。主要过程的变化是在非站点上下文 (如组织) 中创建 ReportTemplate。

1. 假定您在组织 <MyOrg> 中具有 ReportTemplate 创建权限。

2. 在步骤 1 中，导航至 <MyOrg> 下的“实用程序”页面，而不是“站点”>“实用程序”页面。

3. 在步骤 5 中，数据源现可在 "Windchill > Report Templates > <MyOrg>" 下找到。

过程 - 删除 ReportTemplate 数据源

可从系统中移除不再需要的 ReportTemplate 数据源，具体方法是将其从 Windchill 中删除并更新 Cognos 模型。

1. 从与 ReportTemplate 关联的上下文启动“报告管理”，选择对象，然后单击“删除”。

2. 然后，使用上述“创建 ReportTemplate 数据源”过程中的步骤 4 更新 Cognos 模型。

限制

无。

示例代码

Windchill 代码中的使用示例

没有直接依赖于 ReportTemplate 数据源对象的预设功能。但是，有多个预设的 ReportTemplate 对象，它们在 Cognos 中可用作 ReportTemplate 数据源对象。这些数据源可用于创建 Cognos 报告。但是，不支持直接修改这些 ReportTemplate。

随附的示例

演示 ReportTemplate 数据源对象 PartList 可供使用。可通过以下命令对其进行加载：

wt.load.LoadFromFile -d
<WindchillHome>/loadXMLFiles/DemoReports.xml -CONT_PATH /

请注意，如果已加载这些对象，则运行此命令时可能会出现异常。PartList ReportTemplate 对象是一种简单的部件查询，用于返回具有部件编号信息的两列。该对象将在站点上下文中创建，并且在执行更新模型操作后将在 Cognos 中可用。