管理者可以在部署層次上建立後處理外掛程式,為組織中的所有使用者新增後處理功能,而不是在每個個別文件規格中編寫程式碼。
例如,您可以新增的後處理功能包括複製、保存或重新命名輸出檔、以電子郵件寄送結果,或將產生的文件上傳至伺服器。
關於這項作業
- 後處理器無法修改結果清單,如果試圖修改,則會擲出異常狀況。
雖然處理器無法在清單中新增或移除結果,但可以變更任何結果的路徑。
- Rational® Publishing Engine 只會在第一次產生文件時建立一次後處理器,之後,在整個文件產生過程中都會使用這些實例。
- 如果後處理器在 Eclipse 環境定義之外使用(在 RPE Web 服務或自訂的 Java™ 應用程式中),則不能有內嵌的 .jar 檔,而且其所有相依關係必須已存在於其上層類別路徑中。
程序
- 建立新的外掛程式專案。
- 新增延伸功能,延伸點應該為:RRDGPostProcessor。
- 提供新延伸功能的 ID 和名稱。 例如,如果新的延伸功能稱為 PostProcessor1,您的 plugin.xml 檔中應該會出現如下的項目:
<extension id="PostProcessor1" name="PostProcessor1" point="com.ibm.rational.rrdg.RRDGPostProcessor">
<RRDGPostProcessor class="com.ibm.rational.rpe.postprocessor.PostProcessor1">
</RRDGPostProcessor>
</extension>
- 使用下列程式碼建立 PostProcessor1 類別:
public class PostProcessor1 implements IPostProcessor
{
@Override
public void processResults(List <RPEResult> results)
{
//負責處理結果的所有程式碼都寫在這裡。
}
}
- 應該將處理結果的程式碼新增至 PostProcessor1.processResults 方法。
- 編譯外掛程式並包裝為 .jar 檔。
- 若是產生本端文件,請將包裝的 .jar 檔放入 <RPE_installdir>/launcher/plugins 資料夾,Launcher 啟動時就會載入它。
若為 Document Studio,請將 .jar 檔新增至 <RPE_installdir>/studio/plugins 資料夾。
- 若為「遠端服務」,請將包裝的 .jar 檔新增至 <RPE_installdir>/webapps/WEB-INF/lib/plugins 資料夾。
如果 plugins 資料夾不存在,請手動建立資料夾。