宏用于更新从 Rational® Publishing Engine
生成的 Microsoft Word 输出中的数据。在文档生成期间,Rational Publishing Engine
会自动更新 Microsoft Word 字段。如果稍后需要再次运行宏,那么可选择使用宏属性来直接从
Rational Publishing Engine
运行宏,也可将宏添加为后处理命令以对所生成输出运行该宏。
Rational Publishing Engine
随附三个包含可使用的宏的文件。从“中央管理”组件或安装文件中的
RPE_HOME\utils\word\ 目录内,可找到这些文件:
表 1. Rational Publishing Engine
随附的包含宏的文件文件路径和名称 |
描述 |
RPE_HOME\utils\word\rpe.dot |
包含宏的样式表。
|
RPE_HOME\utils\word\rpe_signed.dot |
包含宏的样式表。
|
RPE_HOME\utils\word\runmacro.vbs |
可运行宏的脚本编制文件。
|
rpe.dot
和
rpe_signed.dot 包含相同样式和宏,但是
rpe_signed.dot
版本包含用于源验证的电子签名。这些文件包含可嵌入 OLE 并更新“目录”、“图目录”和“表目录”元素的输出字段的宏。对于
Microsoft Word 宏,
runmacro.vbs
宏接受 0 到 10 个参数。可使用这些宏,也可记录您自己的宏。
使用
宏属性时,会从
Rational Publishing Engine
运行宏,并且会在生成输出之前更新数据。使用
后命令属性时,Microsoft Word
会运行宏以在生成输出之后更新数据。
注: 如果要在宏参数中使用变量,那么必须使用后命令属性来运行宏。
通过使用后命令属性来运行宏
可在命令中使用系统变量名称、输出名称和模板变量。
- 记录或指定要用作样式表的 Microsoft Word
文档中的宏。
- 在 Launcher 应用程序中,选择文档规范视图中列出的模板。
- 如果要使用包含宏的样式表,那么对于样式表属性,请输入包含宏的文档或样式表的路径。
- 对于后命令属性,请使用
cscript 命令来输入参数。cscript
命令用于启动 Windows
脚本解释器以运行宏。 示例:cmd /c cscript "RPE_HOME\utils\word\runmacro.vbs"
"${Word}" macro_name "${varA}"
注: 如果参数包含空格,那么必须用引号 (" ") 将该参数引起来。
- 生成输出。 此时,会将 varA 替换为模板中指定的变量的值。
Microsoft Word
会运行宏以在生成输出之后更新数据。此时,会将 varA 替换为模板中指定的变量的值。