创建报告资源
通过导入 Engineering Publishing 模板来创建资源。
过程
在 Web 客户机或 Eclipse 客户机中,创建包含 Engineering Publishing 模板及其关联文件的报告资源:
- 要在 Web 客户端中导入模板,请执行以下操作:
- 在主菜单中,单击 “报告” > “报告资源 ”。
- 单击 创建资源。
- 输入报告资源的名称。
- 可选: 编辑描述。
- 在 标识 字段中,指定报告资源的标识。了解更多关于标识符的使用方式:当您添加报告资源或在流程模板中定义报告资源时,存在一个标识符字段。 其他工件有时会引用报告,在这种情况下,报告资源标识很重要。 示例:
- 在仪表板中,“趋势报告”viewlet 将搜索具有特定标识的报告。 如果找到这些报告,那么仪表板 viewlet 将显示并可用。
- 在迭代计划编辑器中,图表选项卡将首先查找标识为
apt.WorkItems的报告模板。 如果找不到该标识,那么会使用workitems.OpenWorkItemsByType标识。 - 仪表板 viewlet 提供了从 viewlet 到实际尺寸报告的追溯支持。 这些引用通过标识进行。
- 一些报告提供了从一个报告到另一个报告的追溯功能。 这些引用通过标识进行。 例如,可从工作项(按团队区域)追溯至工作项(按所有者),或从构建运行状况追溯至构建结果。
对标识符的唯一要求是它在项目区域内是唯一的(同一项目中不能有两个具有相同标识符的报告资源)。
如果仅部署报告以供独立使用(没有仪表板或其他报告引用该报告),那么可以使用任意标识,也可以完全不使用任何标识。
- 在 内容 区域中,单击 浏览 并选择 工程发布 模板 (.dta)。
- 如果模板需要关联的文档规范文件或样式表,请在 文件 区域中单击 新建文件 图标以选择文档。
- 文档规范文件 (.dsx)
- 不是每个模板都需要文档规范。 如果仅包含用于提供数据源 URL 或变量值的文档规范,那么可以在 IBM® Engineering Lifecycle Management 应用程序中配置这些项,而不是在文档规范中进行配置。 使用样式表进行 Microsoft Word 输出时需要 .dsx 文件,也可以用于 PDF 输出。
- 重要信息: 如果包含文档规范,请验证其中是否配置了 HTML 输出类型。 您必须具有可用于在 Engineering Lifecycle Management 应用程序中生成报告的 HTML 输出。 要将报告从 Engineering Lifecycle Management 应用程序导出到 Microsoft Word 或 PDF 输出,还必须在文档规范中指定这些输出类型。
- 在 .dsx 文件中,模板的路径不是必需的,但是模板字段是必需的。
- 在 .dsx 文件中,数据源 URL 应该留白。
- 样式表文件(.css 和 .dot)
- 如果在文档规范中对输出类型指定了样式表,那么还必须将该样式表添加至资源。
- 在文档规范中,当您为输出配置样式表时,请确保 stylesheet 属性的值仅是文件名。 请勿包含文件路径。
- 必须将 Microsoft Word 文档生成的模板文件重命名为 template.dot,再将其上载到“质量管理”中的报告资源。
要编辑文档规范中的样式表属性:- 在启动应用程序中打开文档规范。
- 右键单击输出类型。
- 单击配置样式表。
- 选择样式表。
- 除去样式表的路径以便仅显示文件名。
- 不正确:C:\stylesheets\template.dot
- 正确:template.dot
- 单击确定并保存变更。
重复以上步骤以添加每个关联文件。
- 可选: 要使此报告可供项目区域或团队区域的所有成员访问,请在 "项目区域/团队区域" 部分中选择 共享 复选框。
- 可选: 在 "高速缓存" 区域中,选择 支持数据高速缓存。
- 可选: 要在规划编辑器中将报告设置为缺省值,请在 "规划" 区域中选择 设置为缺省报告。
- 单击保存。现在,该报告资源将更新为使用新的报告设计文件。
- 要在 Eclipse 客户机中导入模板,请执行以下操作:
- 在 " 团队工件 " 视图中,展开项目区域和 报告。
- 右键单击 “报告资源 ”,然后单击 “新建 ”> “报告资源 ”。
- 输入报告资源的名称。
- 可选: 编辑描述。
- 在 标识 字段中,指定报告资源的标识。了解更多关于标识符的使用方式:当您添加报告资源或在流程模板中定义报告资源时,存在一个标识符字段。 其他工件有时会引用报告,在这种情况下,报告资源标识很重要。 示例:
- 在仪表板中,“趋势报告”viewlet 将搜索具有特定标识的报告。 如果找到这些报告,那么仪表板 viewlet 将显示并可用。
- 在迭代计划编辑器中,图表选项卡将首先查找标识为
apt.WorkItems的报告模板。 如果找不到该标识,那么会使用workitems.OpenWorkItemsByType标识。 - 仪表板 viewlet 提供了从 viewlet 到实际尺寸报告的追溯支持。 这些引用通过标识进行。
- 一些报告提供了从一个报告到另一个报告的追溯功能。 这些引用通过标识进行。 例如,可从工作项(按团队区域)追溯至工作项(按所有者),或从构建运行状况追溯至构建结果。
对标识符的唯一要求是它在项目区域内是唯一的(同一项目中不能有两个具有相同标识符的报告资源)。
如果仅部署报告以供独立使用(没有仪表板或其他报告引用该报告),那么可以使用任意标识,也可以完全不使用任何标识。
- 可选: 要使此报告可供项目区域或团队区域的所有成员访问,请在 "项目区域/团队区域" 部分中选择 共享 复选框。
- 在 内容 区域中,单击 浏览 并选择 工程发布 模板 (.dta)。
- 可选: 在 "高速缓存" 区域中,选择 支持数据高速缓存。
- 如果模板需要关联的文档规范文件或样式表,请在 文件 区域中单击 添加 以选择文档。
- 文档规范文件 (.dsx)
- 不是每个模板都需要文档规范。 如果仅包含用于提供数据源 URL 或变量值的文档规范,那么可以在 IBM Engineering Lifecycle Management 应用程序中配置这些项,而不是在文档规范中进行配置。 使用样式表进行 Microsoft Word 输出时需要 .dsx 文件,也可以用于 PDF 输出。
- 重要信息: 如果包含文档规范,请验证其中是否配置了 HTML 输出类型。 您必须具有可用于在 Engineering Lifecycle Management 应用程序中生成报告的 HTML 输出。 要将报告从 Engineering Lifecycle Management 应用程序导出到 Microsoft Word 或 PDF 输出,还必须在文档规范中指定这些输出类型。
- 在 .dsx 文件中,模板的路径不是必需的,但是模板字段是必需的。
- 在 .dsx 文件中,数据源 URL 应该留白。
- 样式表文件(.css 和 .dot)
- 如果在文档规范中对输出类型指定了样式表,那么还必须将该样式表添加至资源。
- 在文档规范中,当您为输出配置样式表时,请确保 stylesheet 属性的值仅是文件名。 请勿包含文件路径。
- 必须将 Microsoft Word 文档生成的模板文件重命名为 template.dot,再将其上载到“质量管理”中的报告资源。
要编辑文档规范中的样式表属性:- 在启动应用程序中打开文档规范。
- 右键单击输出类型。
- 单击配置样式表。
- 选择样式表。
- 除去样式表的路径以便仅显示文件名。
- 不正确:C:\stylesheets\template.dot
- 正确:template.dot
- 单击确定并保存变更。
重复以上步骤以添加每个关联文件。
- 可选: 要在规划编辑器中将报告设置为缺省值,请在 "规划" 区域中选择 设置为缺省报告。
- 单击 确定。现在,该报告资源将更新为使用新的报告设计文件。