可以包括要在运行时定义的动态数据源元素。数据源配置元素允许您重新配置数据源。
Rational® Publishing Engine 在文档生成开始时计算静态数据源的 URL,而不是在访问来自数据源的第一个查询时进行计算。
使用数据源配置元素,您可以控制文档生成期间元素的求值时间。
如果开始设计文档时不知道连接信息,那么数据源配置元素非常有用。例如,如果从两个产品(A 和 B)链接工件,那么可以在运行时从 B 获得数据源信息。通过重新配置数据源,可以更改属性,例如 URI、用户名、密码和任何其他特定于数据源的属性(抽取数据时由 Rational Publishing Engine 使用)。
开始之前
在文档模板中,数据源配置元素必须放在包含已配置数据源的查询的元素之前。
关于此任务
使用数据源配置元素来重新配置数据源。必须将数据源配置元素连接至模板中使用的数据源模式。根据数据源配置,动态数据源元素包含的属性类似于文档规范中的属性。生成文档时,此元素会初始化或重新初始化数据源。使用数据源配置元素,仅定义运行时未知的属性。对所有属性(例如用户名、密码和
exe 文件的位置)使用此元素会减弱模板的移植性。
虽然数据源配置元素属性类似于文档规范中定义给数据源元素的那些元素属性,但文档规范中的属性具有静态值,而来自数据源配置元素的属性则使用其上下文中其他可用数据源的值。
过程
要重新配置数据源,请执行下列操作:
- 在“选用板”视图中,选择
数据源配置元素,然后将该元素拖到模板中。
- 选择数据源配置元素。
- 在属性视图中,选择数据选项卡。
- 在目标数据源属性中,输入数据源模式的名称。将数据源配置连接至数据源模式之后,其格式化属性会更新以反映数据源模式类型的运行时属性。
- 在继承数据配置属性中,输入模板中所使用数据源模式的名称。缺省情况下,此属性不含值。可以使用模板中所用的数据源模式名来更改此值。如果使用此属性,那么使用从继承数据源获取的设置以及数据源配置中定义的属性来配置目标数据源。
当未对目标数据源指定值时,将使用继承数据源中的属性。例如,只要目标数据源未填充 URL 属性,就将继承数据源的 URL 用于目标数据源。继承数据源属性的常见用途是仅为数据源提供凭证一次。
此外,也可以指定其他属性,或者从文档规范提供的值或
继承数据源属性下方定义的数据源提供的值获取其他属性。
注: 目标数据源和继承数据源可以是同一个数据源。如果将继承数据源留空,那么使用目标数据源。
除非数据源配置属性是空的,否则该属性优先于文档规范属性。Rational Publishing Engine 将数据源配置元素中定义的属性与文档规范中定义的那些属性合并。