Les administrateurs peuvent créer un plug-in de post-traitement afin d'ajouter des capacités de post-traitement au niveau du déploiement pour
tous les utilisateurs de votre organisation, au lieu de coder ces capacités de post-traitement dans chaque spécification de document individuelle.
Par exemple, vous pouvez ajouter des capacités de post-traitement telles que la copie, l'archivage ou le renommage des fichiers de sortie, l'envoi des
résultats par courrier électronique ou le téléchargement des documents générés sur un serveur.
Pourquoi et quand exécuter cette tâche
- Les postprocesseurs ne peuvent pas modifier la liste des résultats et émettent une exception si une tentative de modification est effectuée.
Les processeurs ne peuvent pas ajouter ni supprimer des résultats dans une liste, mais ils peuvent changer le chemin d'un résultat.
- Rational
Publishing Engine crée les postprocesseurs une fois
seulement pour la première génération de document et utilise ces instances pour l'intégralité de la génération de document.
- Si les postprocesseurs sont utilisés hors du contexte Eclipse (dans le service Web RPE ou une application Java™
personnalisée), ils ne peuvent pas avoir de fichiers .jar imbriqués et toutes leurs dépendances doivent déjà se trouver dans leur chemin d'accès aux
classes parent.
Procédure
Pour créer un nouveau plug-in pour le post-traitement et le déployer dans le client :
- Créez un nouveau projet de plug-in.
- Ajoutez une nouvelle extension, où le point d'extension est RRDGPostProcessor.
- Indiquez un ID et un nom pour la nouvelle extension. Par exemple, si la nouvelle extension s'appelle PostProcessor1,
une entrée similaire à la suivante doit apparaître dans votre fichier plugin.xml :
<extension id="PostProcessor1" name="PostProcessor1" point="com.ibm.rational.rrdg.RRDGPostProcessor">
<RRDGPostProcessor class="com.ibm.rational.rpe.postprocessor.PostProcessor1">
</RRDGPostProcessor>
</extension>
- Créez une classe PostProcessor1 avec le code suivant :
public class PostProcessor1 implements IPostProcessor
{
@Override
public void processResults(List <RPEResult> results)
{
//L'intégralité du code des résultats de traitement doit être placé ici.
}
}
- Le code des résultats de traitement doit être ajouté à la méthode PostProcessor1.processResults.
- Compilez le plug-in et conditionnez-le en tant que fichier .jar.
- Pour la génération de document locale, placez le fichier .jar conditionné dans le dossier
<rép_install_RPE>/launcher/plugins ; il doit être chargé lorsque Launcher démarre. Pour Document Studio,
ajoutez le fichier .jar au dossier <rép_install_RPE>/studio/plugins.
- Pour les services distants, ajoutez le fichier .jar conditionné au dossier
<rép_install_RPE>/webapps/WEB-INF/lib/plugins.
Si le dossier plugins n'existe pas, créez-le manuellement.