在将 Rational DOORS 用作数据源的情况下生成文档

完成报告模板的创建并使用数据点填充该模板之后,可采用各种格式生成报告。

开始之前

如果从 Launcher 应用程序预览数据,那么会使用缺省基线和视图来检索数据。

可以从 Rational® DOORS® 数据源抽取对象链接与嵌入 (OLE)。请参阅OLE 对象

通过使用附加组件来生成文档

如果已安装 Rational DOORS 附加组件,那么可以从 Rational DOORS 用户界面直接生成文档。

关于此任务

  • 通过用户界面或命令行从 Rational Publishing Engine 附加组件启动了本地文档生成时,会在计算机上使用许可证。当远程文档生成开始时,会将该许可证检出。然后,在文档生成完成之后,会将该许可证检入。
  • 通过用户界面或命令行从 Rational Publishing Engine 附加组件启动了远程文档生成时,会在服务器上使用许可证。当远程文档生成开始时,会将该许可证检出。然后,在文档生成完成之后,会将该许可证检入。
注: 在使用 Rational Publishing Engine 附加组件来发布文档时,无法访问 Document Studio 或 Launcher 用户界面。

过程

从“数据库”视图或“模块”视图,单击Publish
  • 当您从“数据库”视图单击Publish时,将如您在 Rational Publishing Engine 中单击文档规范 > 生成 > 配置和生成文档时一样,提示您进行模板和文档规范配置。
  • 从“模块”视图单击Publish时,可以选择新的文档规范并向其中添加模板,也可以选择已添加了模板的现有文档规范。然后,如果模板使用 Rational DOORS 数据源,那么 Rational Publishing Engine 将使用打开的“模块”中的信息为您配置数据源以生成文档。如果文档规范中任何现有配置信息与打开的“模块”中的信息不匹配,那么打开的“模块”中的信息将覆盖现有信息。当至少选择了一个模板以及一种输出格式时,会启用完成
    要点: 对于本地文档生成,Rational Publishing Engine 可以连接至正在运行的 Rational DOORS 客户机,但是对于远程文档生成,该选项不可用。如果您从“数据库”或“模块”视图使用远程生成引擎进行发布,那么在生成文档之前,必须在文档规范中输入认证凭证,以使远程 Rational Publishing Engine 服务可以将新 Rational DOORS 无头客户机实例化,以便拉取报告数据。

通过使用 Rational Publishing Engine 文档生成向导来生成文档

可使用文档生成向导来配置报告需求。

过程

  1. 在 Document Studio 或 Launcher 应用程序中,通过单击文档规范 > 生成 > 配置和生成文档来打开文档生成向导。
  2. 在“模板”部分中,模板已列示在文档规范显示中。 要添加模板,请执行下列操作:
    1. 选择要添加的模板的位置:
      • 来自中央库:用于选择存储在“中央管理”组件中的模板
      • 来自本地或远程文件:要选择本地或远程模板,可输入模板的 URL,或单击浏览以选择模板。
    2. 选择一个或多个要添加的模板。
      • 如果选择自中央库,并已从“中央管理”组件中选择模板,请单击添加所选项,以将这些模板添加至文档规范。
      • 如果已选择自本地或远程文件并已输入单个模板的 URL,请单击添加 URL,以将该模板添加至文档规范。
      • 如果已选择自本地或远程文件并已进行浏览来添加模板,那么当单击打开时,这些模板会添加至文档规范。
    3. 可选: 重复操作,以添加来自其他位置的其他模板。
    4. 可选: 通过选择模板并单击上移下移来对文档规范中的模板进行重新排序。
    5. 单击下一步 添加模板后,还会将模板中指定的数据源和变量添加到向导。
  3. 在“数据源”部分中,配置每个数据源。
    注:
    • 如果对于数据源,存在缺省值,或者已输入缺省 URI 值,那么该数据源会显示为已配置,并且除非选择了除缺省值之外的另一个值,否则会在输出中使用缺省值。
    • 如果移经“数据源”部分,并单击返回以对数据源进行其他更改,那么此部分会始终打开列表中的第一个数据源。
    1. 数据库:输入要连接至的数据库名称。缺省情况下,使用 -data 36677@localhost 如果没有指定 -data,那么会自动为您追加此项。如果没有指定任何值,那么 Rational Publishing Engine 会尽可能从注册表中检索缺省值。
    2. doors.exe 的路径:输入 doors.exe 的完整路径。 如果该路径无效或无法访问,那么向导会尽可能为您更正该路径。 示例:C:\Program Files\IBM\Rational\DOORS\version\bin\doors.exe
    3. 模块 URI视图基线:可输入这些值,或单击发现来使用向导从值列表中进行选择。 如果选择使用发现向导,请单击下一步并完成下列其中一个步骤:
      • 单击下一步以选择模块 URI视图基线的值。如果您在“从 DOORS 数据库中选择视图”窗口中单击了下一步,那么可从模块、视图和基线的列表中选择。然后单击完成
      • 输入一个模块 URI。输入一个模块 URI 之后,将启用完成,然后您可单击该框来使用视图和基线的缺省值。要使用不同于缺省值的视图和基线,请输入要改用的视图基线值,然后单击完成
        注: 如果您手动编辑模块 URI 值并输入不正确的值,那么可能无法生成输出。如果为视图基线提供不正确的值或空值,那么会从当前模块版本的标准视图生成输出。将生成输出,但是数据可能不正确。
    4. 用户名:输入 Rational DOORS 帐户名称。
    5. 密码:输入 Rational DOORS 帐户密码。
    6. 选择是否使用文档生成期间使用“运行的 DOORS 实例”选项:
      • 如果希望 Rational DOORS 在您从生成此文档规范中的文档时从您为 doors.exe 的路径字段所指定的位置运行,请选择文档生成期间使用“运行的 DOORS 实例”选项。使用运行的 Rational DOORS 实例时,处理时间会缩短。
      • 如果不希望 Rational DOORS 在您生成此文档规范中的文档时从您为 doors.exe 的路径字段所指定的位置运行,请取消选中文档生成期间使用“运行的 DOORS 实例”选项以启动新实例。
        注: 如果使用远程服务应用程序,那么 doors_homenew_instance 属性总是会由远程服务应用程序重写。上载文档规范之后,Rational Publishing Engine 会重写属性以匹配服务器配置。

    当在向导中 Rational Publishing Engine 对不正确的值进行了替换时,系统也会在数据源的“属性”视图中以及运行时标志值中更新这些值。

  4. 在“变量”部分中,配置每个变量。
    注:
    • 如果对于变量,存在缺省值,那么该变量会显示为已配置,并且除非选择了除缺省值之外的另一个值,否则会在输出中使用缺省值。
    • 如果移经“变量”部分,并单击返回以对变量进行其他更改,那么此部分会始终打开列表中的第一个变量。
    1. 从下拉菜单中选择下列其中一个选项:
      • 手动配置:用于对该变量输入任何值,因为对于此变量,在配置层或“中央管理”组件中,不存在任何其他配置信息
      • 从配置层:从您为模板中的变量输入的配置元数据选择值
      • 使用中央库中的变量值:选择存储在中央管理组件中的变量
    2. 为配置输入或选择值。
    3. 单击下一步
  5. 在“输出”部分中,选择要用于生成文档的输出类型:
    • Microsoft Word
    • PDF
    • HTML
    • XSL-FO
    • 旧 PDF
    1. 可选: 对于保存位置,单击浏览,以选择用于为每种输出类型保存该文件的路径。 您可以编辑文档规范中的路径,使其成为相对路径。如果没有指定用于输出的保存位置,那么会在临时位置中生成该文件。
    2. 可选: 对于样式表,单击浏览,以选择在生成输出时要对每种输出类型使用的样式表。
    3. 可选: 仅 Microsoft Word 输出:对于,输入包含在样式表内的宏的名称。
    4. 可选: 要输入其他元数据或者配置向导中不包含的其他文档属性,请单击编辑元数据属性
    5. 单击下一步
  6. 验证摘要窗口中的模板和输出信息是否正确。
  7. 选择当您单击完成时要执行的操作:
    • 运行文档生成:生成您指定的输出类型。
    • 运行文档生成并退出 RPE:生成您指定的输出类型,并在您退出“结果”窗口后关闭 Rational Publishing Engine 应用程序。
    • 保存并关闭向导,而不生成文档:关闭文档生成向导,但是 Launcher 应用程序仍处于打开状态。
    注: 如果您正在使用 Rational DOORS 插件中的文档生成向导,请选择保存并关闭此向导,而不生成文档以关闭向导和 Launcher 应用程序。

反馈