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

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

Rational Rhapsody 生成文档

您可直接从 Rational Rhapsody 用户界面生成文档。

过程

  1. 装入模型。
  2. 单击工具 > Rational Publishing Engine > 生成报告
  3. 完成向导以选择模板并复查其报告配置。
  4. 单击完成

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

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

开始之前

发布文档之前,必须打开正确的 Rational Rhapsody 项目,并且必须正在运行 Rational Rhapsody Web 服务器。Rational Rhapsody 项目打开且您从 Rational Publishing Engine 生成文档时,会自动启动 Rational Rhapsody Web 服务器。如果关闭 Web 服务器窗口,那么在后续文档生成时,Rational Publishing Engine 无法重新启动服务器。您可以手动运行批处理文件以再次启动服务器,而无需重新启动 Rational Publishing EngineRational_Rhapsody_HOME/ApplicationServer/startserver.bat
注: 如果 REST 请求 URL 较长,那么可能不会将该请求传递至 Rational Rhapsody 服务器,这将防止从其软件包嵌套级别高于 3 的 Rhapsody 模型中生成文档。要解决此问题,在 Rational Rhapsody Web 服务器上,修改 Web 服务器配置以增大允许的 URL 长度。

过程

  1. 在 Document Studio 或 Launcher 应用程序中,通过单击文档规范 > 生成 > 配置和生成文档来打开文档生成向导。
  2. 在“模板”部分中,模板已列示在文档规范显示中。 要添加模板,请执行下列操作:
    1. 选择要添加的模板的位置:
      • 来自中央库:选择存储在文档构建器中的模板
      • 来自本地或远程文件:要选择本地或远程模板,可输入模板的 URL,或单击浏览以选择模板。
    2. 选择一个或多个要添加的模板。
      • 如果选择来自中央库,并已从文档构建器中选择模板,请单击添加所选项,以将这些模板添加至文档规范。
      • 如果已选择自本地或远程文件并已输入单个模板的 URL,请单击添加 URL,以将该模板添加至文档规范。
      • 如果已选择自本地或远程文件并已进行浏览来添加模板,那么当单击打开时,这些模板会添加至文档规范。
    3. 可选: 重复操作,以添加来自其他位置的其他模板。
    4. 可选: 通过选择模板并单击上移下移来对文档规范中的模板进行重新排序。
    5. 单击下一步 添加模板后,还会将模板中指定的数据源和变量添加到向导。
  3. 在“数据源”部分中,配置每个数据源。
    注:
    • 如果对于数据源,存在缺省值,或者已输入缺省 URI 值,那么该数据源会显示为已配置,并且除非选择了除缺省值之外的另一个值,否则会在输出中使用缺省值。
    • 如果移经“数据源”部分,并单击返回以对数据源进行其他更改,那么此部分会始终打开列表中的第一个数据源。
    1. 从以下其中一个位置选择数据源:
      • 手动配置:用于选择本地或远程数据源,因为对于此数据源,配置层中不存在任何其他配置信息
      • 从配置层装入:用于从已为模板中的数据源输入的配置元数据选择值
    2. 根据您在上一个步骤中所做的选择,可以通过输入 URL,并单击浏览以选择一个位置或从配置层选择一个值,为数据源选择值。 无论该值是 URL 还是包含 URL 的值,都可通过执行下列操作来确定 Rational Rhapsody 的典型数据源 URL:
      1. 识别已用于将模式添加至模板的数据源模式 URL。
      2. 从数据源模式 URL 中,除去 ?metadata=schema 后缀。示例:
        • 数据源模式 URL:https://server:port/Rational/Rhapsody/?metadata=schema
        • 数据源 URL:https://server:port/Rational/Rhapsody/

      不需要使用与数据源模式相同的 URL。可指向其他 Rational Rhapsody 存储库,以访问包含在其中的数据,因为 Rational Rhapsody 存储库全部都使用相同的 REST API。

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