執行巨集

巨集用來更新從 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

可以執行巨集的 Scripting 檔。

rpe.dotrpe_signed.dot 兩者都包含相同的樣式和巨集,但 rpe_signed.dot 版本包含驗證來源的電子簽章。 這些檔案包含一些巨集,可供內嵌 OLE,以及更新「目錄」、「圖例目錄」和「表格目錄」元素的輸出欄位。 runmacro.vbs 巨集接受 Microsoft Word 巨集的 0 至 10 個引數。 您可以使用這些巨集,也可以記錄您自己的巨集。

關於這項作業

當您使用 macro 內容時,巨集是從 Rational Publishing Engine 執行,資料會在產生輸出之前更新。 當您使用 post-command 內容時,Microsoft Word 會在輸出產生之後,執行巨集來更新資料。
註: 如果在巨集引數中使用變數,您必須利用 post-command 內容來執行您的巨集。

利用 macro 內容來執行巨集

關於這項作業

在您的引數中,無法使用變數。

程序

  1. 在用來作為樣式表的 Microsoft Word 文件中,記錄或指定巨集。
  2. 在 Launcher 應用程式中,選取文件規格視圖中所列的範本。
  3. 如果您使用包含巨集的樣式表,請針對 stylesheet 內容,輸入包含巨集的文件或樣式表的路徑。
  4. 對於 macro 內容,請輸入一個引數。 範例:macro_name macro_argument
  5. 產生輸出。

結果

Rational Publishing Engine 執行巨集,資料會在產生輸出之前更新。

利用 post-command 內容來執行巨集

關於這項作業

您可以在指令中,使用系統變數名稱、輸出名稱及範本變數。

程序

  1. 在用來作為樣式表的 Microsoft Word 文件中,記錄或指定巨集。
  2. 在 Launcher 應用程式中,選取文件規格視圖中所列的範本。
  3. 如果您使用包含巨集的樣式表,請針對 stylesheet 內容,輸入包含巨集的文件或樣式表的路徑。
  4. 對於 post-command 內容,請利用 cscript 指令來輸入一個引數。 cscript 指令用來啟動 Windows Script 直譯器以執行巨集。 範例:cmd /c cscript "RPE_HOME\utils\word\runmacro.vbs" "${Word}" macro_name "${varA}"
    註: 如果您的引數包含間距,您必須用引號 (" ") 來括住引數。
  5. 產生輸出。 varA 會取代為範本指定的變數值。

結果

Microsoft Word 會在輸出產生之後,執行巨集來更新資料。 varA 會取代為範本指定的變數值。

意見