创建报告资源

通过导入 Engineering Publishing 模板来创建资源。

过程

在 Web 客户机或 Eclipse 客户机中,创建包含 Engineering Publishing 模板及其关联文件的报告资源:

  • 要在 Web 客户端中导入模板,请执行以下操作:
    1. 在主菜单中,单击 “报告” > “报告资源 ”。
    2. 单击 创建资源
    3. 输入报告资源的名称。
    4. 可选: 编辑描述。
    5. 标识 字段中,指定报告资源的标识。
      了解更多关于标识符的使用方式:
      当您添加报告资源或在流程模板中定义报告资源时,存在一个标识符字段。 其他工件有时会引用报告,在这种情况下,报告资源标识很重要。 示例:
      • 在仪表板中,“趋势报告”viewlet 将搜索具有特定标识的报告。 如果找到这些报告,那么仪表板 viewlet 将显示并可用。
      • 迭代计划编辑器中,图表选项卡将首先查找标识为 apt.WorkItems 的报告模板。 如果找不到该标识,那么会使用 workitems.OpenWorkItemsByType 标识。
      • 仪表板 viewlet 提供了从 viewlet 到实际尺寸报告的追溯支持。 这些引用通过标识进行。
      • 一些报告提供了从一个报告到另一个报告的追溯功能。 这些引用通过标识进行。 例如,可从工作项(按团队区域)追溯至工作项(按所有者),或从构建运行状况追溯至构建结果

      对标识符的唯一要求是它在项目区域内是唯一的(同一项目中不能有两个具有相同标识符的报告资源)。

      如果仅部署报告以供独立使用(没有仪表板或其他报告引用该报告),那么可以使用任意标识,也可以完全不使用任何标识。

    6. 内容 区域中,单击 浏览 并选择 工程发布 模板 (.dta)。
    7. 如果模板需要关联的文档规范文件或样式表,请在 文件 区域中单击 新建文件 图标以选择文档。
      文档规范文件 (.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,再将其上载到“质量管理”中的报告资源。
      要编辑文档规范中的样式表属性:
      1. 在启动应用程序中打开文档规范。
      2. 右键单击输出类型。
      3. 单击配置样式表
      4. 选择样式表。
      5. 除去样式表的路径以便仅显示文件名。
        • 不正确:C:\stylesheets\template.dot
        • 正确:template.dot
      6. 单击确定并保存变更。

      重复以上步骤以添加每个关联文件。

    8. 可选: 要使此报告可供项目区域或团队区域的所有成员访问,请在 "项目区域/团队区域" 部分中选择 共享 复选框。
    9. 可选: 在 "高速缓存" 区域中,选择 支持数据高速缓存
    10. 可选: 要在规划编辑器中将报告设置为缺省值,请在 "规划" 区域中选择 设置为缺省报告
    11. 单击保存
      现在,该报告资源将更新为使用新的报告设计文件。
  • 要在 Eclipse 客户机中导入模板,请执行以下操作:
    1. 在 " 团队工件 " 视图中,展开项目区域和 报告
    2. 右键单击 “报告资源 ”,然后单击 “新建 ”> “报告资源 ”。
    3. 输入报告资源的名称。
    4. 可选: 编辑描述。
    5. 标识 字段中,指定报告资源的标识。
      了解更多关于标识符的使用方式:
      当您添加报告资源或在流程模板中定义报告资源时,存在一个标识符字段。 其他工件有时会引用报告,在这种情况下,报告资源标识很重要。 示例:
      • 在仪表板中,“趋势报告”viewlet 将搜索具有特定标识的报告。 如果找到这些报告,那么仪表板 viewlet 将显示并可用。
      • 迭代计划编辑器中,图表选项卡将首先查找标识为 apt.WorkItems 的报告模板。 如果找不到该标识,那么会使用 workitems.OpenWorkItemsByType 标识。
      • 仪表板 viewlet 提供了从 viewlet 到实际尺寸报告的追溯支持。 这些引用通过标识进行。
      • 一些报告提供了从一个报告到另一个报告的追溯功能。 这些引用通过标识进行。 例如,可从工作项(按团队区域)追溯至工作项(按所有者),或从构建运行状况追溯至构建结果

      对标识符的唯一要求是它在项目区域内是唯一的(同一项目中不能有两个具有相同标识符的报告资源)。

      如果仅部署报告以供独立使用(没有仪表板或其他报告引用该报告),那么可以使用任意标识,也可以完全不使用任何标识。

    6. 可选: 要使此报告可供项目区域或团队区域的所有成员访问,请在 "项目区域/团队区域" 部分中选择 共享 复选框。
    7. 内容 区域中,单击 浏览 并选择 工程发布 模板 (.dta)。
    8. 可选: 在 "高速缓存" 区域中,选择 支持数据高速缓存
    9. 如果模板需要关联的文档规范文件或样式表,请在 文件 区域中单击 添加 以选择文档。
      文档规范文件 (.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,再将其上载到“质量管理”中的报告资源。
      要编辑文档规范中的样式表属性:
      1. 在启动应用程序中打开文档规范。
      2. 右键单击输出类型。
      3. 单击配置样式表
      4. 选择样式表。
      5. 除去样式表的路径以便仅显示文件名。
        • 不正确:C:\stylesheets\template.dot
        • 正确:template.dot
      6. 单击确定并保存变更。

      重复以上步骤以添加每个关联文件。

    10. 可选: 要在规划编辑器中将报告设置为缺省值,请在 "规划" 区域中选择 设置为缺省报告
    11. 单击 确定
      现在,该报告资源将更新为使用新的报告设计文件。