前置指令和後置指令內容可以包含指令程式碼,以便在文件發佈程序之前與之後執行。
關於這項作業
您可以使用
後置指令內容,來複製輸出檔、保存輸出檔、根據變數來重新命名輸出檔、郵寄輸出檔,或是呼叫協力廠商應用程式。
程序
- 在文件規格視圖中,按一下 meta 資料。 這時會顯示內容視圖。
- 選取前置指令或後置指令內容,並按一下「配置」圖示
。 這時會開啟「設定前置指令或後置指令的值」視窗。
- 輸入值。 您可以在指令中使用 RPE_HOME 之類的系統變數,或使用外部範本變數。格式一律是 ${variable}。當範本變數和系統變數同名時,會優先採用範本變數。您也可以使用輸出格式作為變數,來指出輸出內容中指定的路徑。您必須寫入變數,因為會將其名稱顯示在文件規格中。 範例:
- ${RPE_HOME}
- ${Html}
- ${Word}
- ${PDF}
- ${New PDF}
- ${XslFo}
- ${ModuleName}
註: 您不能使用這些名稱的任何變異,例如 ${WORD} 或 ${word}。Rational® Publishing Engine 無法辨識這些變異。
舉例來說,只有 ${Word} 變數才會插入指定給 Microsoft Word 輸出的路徑內容值。在日誌中,變數會顯示成值。
- 選擇性的: 針對在前置指令失敗時停止內容,輸入 true 或 false。 當設為 true,且前置指令失敗時,文件產生作業會停止執行。當設為 false 或未輸入值時,如果前置指令失敗,則文件產生作業會繼續執行。
- 按一下確定。
範例

如果要將輸出複製到第二個位置,請使用下列指令:
cmd /c copy ${output_format} D:\path\filename.output_extension
當將指令撰寫成 JavaScript 時,請在程式碼開頭輸入
//!JavaScript,以使用內部 JavaScript 引擎來評估指令:
//!JavaScript
var x = output;
var y = variable;
java.lang.System.out.println( "X+Y=" + x + y);
1;