可以从 Launcher 和 Document Studio 生成文档。
开始之前
缺省情况下,每一个模板都与空白文档规范相关联。从 Document Studio 应用程序预览或发布模板时,无论是否对该空白文档规范进行定制,都可以使用此空白文档规范来生成输出。当您打开或保存模板时,Document Studio 会将该模板与缺省文档规范保持同步。注: 这些指示信息适用于大多数的数据源,但并非适用于所有数据源。
有关特定于数据源的指示信息,请参阅关于数据源的
集成文档。
关于此任务
可使用若干不同方法来生成文档:
- 可以从 Launcher 和 Document Studio 应用程序生成文档。下面的任务概括了如何从应用程序用户界面生成文档。
- 从文件系统上文档规范的位置,可右键单击该文件并单击使用
Rational Publishing Engine 来进行发布。
会阻止所有错误,以生成文档。
- 还可以在已安装附加组件的情况下从
Rational DOORS 用户界面和
Rational Tau 用户界面发布文档。
从 Launcher 应用程序或 Document Studio 应用程序生成文档的过程中不存在任何差别。使用向导来生成文档时,在这两个应用程序中,会提供相同选项。但是,在
Launcher 应用程序中,您能够在“文档规范”和“属性”视图中针对文档生成配置详细信息而不必使用向导。
过程
要从 Launcher 或 Document Studio 应用程序生成文档,请执行下列操作:
- 在 Launcher 或 Document Studio 中,单击。
还可单击工具栏中的配置和生成文档图标
。
配置向导会打开,以允许您在生成文档之前为文档生成进行其他选择。进度条会显示以下五个部分中必须配置的信息:
您可以单击一个部分或单击进度条中的一个项以跳转至向导中的此页面。
提示: 只要至少选择了一个数据源以及一种输出格式,就可随时单击完成以开始文档生成,或单击下一步以继续使用配置向导。
- 在“模板”部分中,模板已列示在文档规范显示中。
要添加模板,请执行下列操作:
- 选择要添加的模板的位置:
- 来自中央库:用于选择存储在“中央管理”组件中的模板
- 来自本地或远程文件:要选择本地或远程模板,可输入模板的 URL,或单击浏览以选择模板。
- 选择一个或多个要添加的模板。
- 如果选择自中央库,并已从“中央管理”组件中选择模板,请单击添加所选项,以将这些模板添加至文档规范。
- 如果已选择自本地或远程文件并已输入单个模板的 URL,请单击添加 URL,以将该模板添加至文档规范。
- 如果已选择自本地或远程文件并已进行浏览来添加模板,那么当单击打开时,这些模板会添加至文档规范。
- 可选: 重复操作,以添加来自其他位置的其他模板。
- 可选: 通过选择模板并单击上移或下移来对文档规范中的模板进行重新排序。
- 单击下一步。 添加模板后,还会将模板中指定的数据源和变量添加到向导。
- 在“数据源”部分中,配置每个数据源。
注: - 如果对于数据源,存在缺省值,或者已输入缺省 URI
值,那么该数据源会显示为已配置,并且除非选择了除缺省值之外的另一个值,否则会在输出中使用缺省值。
- 如果移经“数据源”部分,并单击返回以对数据源进行其他更改,那么此部分会始终打开列表中的第一个数据源。
- 从以下其中一个位置选择数据源:
- 手动配置:用于选择本地或远程数据源,因为对于此数据源,在配置层或“中央管理”组件中,不存在任何其他配置信息
- 使用来自中央库的数据源值:用于选择存储在“中央管理”组件中的数据源
- 从配置层装入:用于从已为模板中的数据源输入的配置元数据选择值
- 根据您在上一个步骤中所做的选择,可以通过输入 URL,并单击浏览以选择一个位置或从配置层选择一个值,为数据源选择值。
- 输入要向数据源应用程序认证的用户名和密码。
- 选择认证类型。 如果没有选择类型,那么会测试每种类型,直到找到正确的类型,这会延长文档生成时间。
- Auto
- Basic
- Form
- OAuth
- OAuth-OSLC
- 可选: 输入接受头。 缺省值为 application/xml,
*/*。
- 可选: 如果要将已输入的凭证应用于每个数据源,请选择将这些用户名和密码值应用于每个已配置和未配置的数据源选项。
- 单击下一步。
- 在“变量”部分中,配置每个变量。
注: - 如果对于变量,存在缺省值,那么该变量会显示为已配置,并且除非选择了除缺省值之外的另一个值,否则会在输出中使用缺省值。
- 如果移经“变量”部分,并单击返回以对变量进行其他更改,那么此部分会始终打开列表中的第一个变量。
- 从下拉菜单中选择下列其中一个选项:
- 手动配置:用于对该变量输入任何值,因为对于此变量,在配置层或“中央管理”组件中,不存在任何其他配置信息
- 从配置层:从您为模板中的变量输入的配置元数据选择值
- 使用中央库中的变量值:选择存储在中央管理组件中的变量
- 为配置输入或选择值。
- 单击下一步。
- 在“输出”部分中,选择要用于生成文档的输出类型:
- Microsoft Word
- PDF
- HTML
- XSL-FO
- 旧 PDF
- 可选: 对于保存位置,单击浏览,以选择用于为每种输出类型保存该文件的路径。 您可以编辑文档规范中的路径,使其成为相对路径。如果没有指定用于输出的保存位置,那么会在临时位置中生成该文件。
- 可选: 对于样式表,单击浏览,以选择在生成输出时要对每种输出类型使用的样式表。
- 可选: 仅 Microsoft Word 输出:对于宏,输入包含在样式表内的宏的名称。
- 可选: 要输入其他元数据或者配置向导中不包含的其他文档属性,请单击编辑元数据属性。
- 单击下一步。
- 验证摘要窗口中的模板和输出信息是否正确。
- 选择当您单击完成时要执行的操作:
- 运行文档生成:生成您指定的输出类型。
- 运行文档生成并退出 RPE:生成您指定的输出类型,并在您退出“结果”窗口后关闭 Rational Publishing Engine 应用程序。
- 保存并关闭向导,而不生成文档:关闭文档生成向导,但是 Launcher 应用程序仍处于打开状态。
- 单击完成。
提示: 如果要以远程方式生成文档,那么您可以在文档生成完成之前关闭 Document Studio 或 Launcher 应用程序,而不会干扰生成过程。如果要在本地生成文档,请不要关闭 Document Studio 或 Launcher 应用程序,直到文档生成完成为止。
结果
文档规范会装入到 Launcher 中,并根据所作的选择来生成或保存文档。
下一步做什么
在“控制台”或“问题”视图中复查来自文档生成的信息以识别问题。修订问题后,再次生成输出。
配置一次文档生成后,在后续文档生成时,可以单击以生成文档,而无需完成配置向导。