使用文档生成向导来预览文档

对于数据量很大的文档,您可以从只具有数据子集的 Launcher 和 Document Studio 应用程序生成文档,从而减少生成时间。
缺省情况下,每一个模板都与空白文档规范相关联。从 Document Studio 应用程序预览或发布模板时,无论是否对该空白文档规范进行定制,都可以使用此空白文档规范来生成输出。当您打开或保存模板时,Document Studio 会将该模板与缺省文档规范保持同步。
注: 这些指示信息适用于大多数的数据源,但并非适用于所有数据源。 有关特定于数据源的指示信息,请参阅关于数据源的集成文档。
缺省情况下,预览中所包含的数据子集为前十个数据条目。您可以在引擎首选项中更改此数目:
  1. 单击窗口 > 首选项 > RPE > 引擎首选项
  2. 预览查询结果限制中,输入要包括在预览中的数据条目数。

从 Launcher 应用程序或 Document Studio 应用程序生成预览的过程中不存在任何差别。使用向导来生成文档时,在这两个应用程序中,会提供相同选项。但是,在 Launcher 应用程序中,您能够在“文档规范”和“属性”视图中针对文档预览配置详细信息而不必使用向导。

  1. 在 Launcher 或 Document Studio 中,单击文档规范 > 预览 > 配置和预览文档

    还可单击工具栏中的配置和预览文档图标 “配置和预览”图标

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

反馈