管理者は、個々の各文書仕様内にコーディングするのではなく、
後処理プラグインを作成して、組織に属するすべてのユーザー用にデプロイメント・レベルで後処理機能を追加できます。
例えば、出力ファイルのコピー、アーカイブ、名前変更を行ったり、結果を E メールで送信したり、生成した文書をサーバーにアップロードしたりする
後処理機能を追加できます。
このタスクについて
- 後処理プログラムでは結果リストを変更できません。
変更を行おうとすると、後処理プログラムから例外がスローされます。
後処理プログラムで結果をリストに追加したりリストから削除したりすることはできませんが、
いずれの結果についてもパスを変更することはできます。
- Rational® Publishing Engine は、
後処理プログラムを最初の文書生成に対して 1 回のみ作成し、その後処理プログラムを文書生成全体に対して使用します。
- 後処理プログラムが 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)
{
//All the code for processing results should go here.
}
}
- 処理結果のコードを PostProcessor1.processResults メソッドに追加します。
- このプラグインをコンパイルして .jar ファイルに圧縮します。
- ローカル文書生成の場合は、圧縮後の .jar ファイルを
<RPE_installdir>/launcher/plugins フォルダーに入れます。
このファイルは、Launcher が開始されたときにロードされます。
Document Studio の場合は、.jar ファイルを <RPE_installdir>/studio/plugins フォルダーに追加します。
- リモート・サービスの場合は、圧縮後の .jar ファイルを
<RPE_installdir>/webapps/WEB-INF/lib/plugins フォルダーに追加します。
このプラグイン・フォルダーは、存在しなければ手動で作成してください。