輸出的前處理和後處理

pre-commandpost-command 內容可以包含程式設計碼,以便在文件發佈程序之前與之後執行指令。

關於這項作業

您可以利用 post-command 內容來複製輸出檔、保存輸出檔、根據變數來重新命名輸出檔、郵寄輸出檔,或是呼叫協力廠商應用程式。 請參閱您作業系統的說明文件,以進一步瞭解您可以使用的指令。 範例:Microsoft Windows 指令行參照

程序

  1. 文件規格視圖中,按一下 meta 資料 這時會顯示內容視圖。
  2. 選取前置指令後置指令內容,並按一下「配置」圖示 「配置」圖示 這時會開啟「設定前置指令或後置指令的值」視窗。
  3. 輸入值。 您可以在指令中使用 RPE_HOME 之類的系統變數,或使用外部範本變數。格式一律是 ${variable}。當範本變數和系統變數同名時,會優先採用範本變數。您也可以使用輸出格式作為變數,來指出輸出內容中指定的路徑。您必須寫入變數,因為會將其名稱顯示在文件規格中。 範例:
    • ${RPE_HOME}
    • ${Html}
    • ${Word}
    • ${PDF}
    • ${New PDF}
    • ${XslFo}
    • ${ModuleName}
    註: 您不能使用這些名稱的任何變異,例如 ${WORD}${word}Rational® Publishing Engine 無法辨識這些變異。
    舉例來說,只有 ${Word} 變數才會插入指定給 Microsoft Word 輸出的路徑內容值。在日誌中,變數會顯示成值。
  4. 選擇性的: 針對在前置指令失敗時停止內容,輸入 truefalse 當設為 true,且前置指令失敗時,文件產生作業會停止執行。當設為 false 或未輸入值時,如果前置指令失敗,則文件產生作業會繼續執行。
  5. 按一下確定

範例

Windows 圖示 如果要將輸出複製到第二個位置,請使用下列指令:

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;

意見