Administratorzy mogą utworzyć wtyczkę przetwarzania końcowego pozwalającą dodać możliwości przetwarzania końcowego na poziomie programistycznym, które będą dostępne dla wszystkich użytkowników w organizacji (w zastępstwie kodowania tych możliwości w poszczególnych specyfikacjach dokumentów). Na przykład można dodać możliwości przetwarzania końcowego takie jak kopiowanie, archiwizowanie, zmiana nazwy plików wyjściowych, wysyłanie wyników pocztą elektroniczną lub przesyłanie wygenerowanych dokumentów na serwer.
O tym zadaniu
- Procesory przetwarzania końcowego nie mogą modyfikować listy wyników i jeśli zostanie podjęta próba modyfikacji, zgłoszony zostanie wyjątek. Mimo, że procesory nie mogą dodawać ani usuwać wyników z listy, mogą zmieniać ścieżkę do dowolnych wyników.
- Produkt Rational Publishing Engine tworzy procesory przetwarzania końcowego tylko raz, podczas generowania pierwszego dokumentu, i używa tych instancji przez cały proces generowania dokumentów.
- Jeśli procesory przetwarzania końcowego zostaną użyte poza kontekstem środowiska Eclipse (w usłudze WWW produktu RPE lub niestandardowej aplikacji Java™), nie mogą one zawierać wbudowanych plików .jar, a wszystkie ich zależności muszą znajdować się już w ich nadrzędnej ścieżce klasy.
Procedura
Aby utworzyć nową wtyczkę na potrzeby przetwarzania końcowego i wdrożyć ją w kliencie:
- Utwórz nowy projekt wtyczki.
- Dodaj nowe rozszerzenie, w którym punktem rozszerzenia powinien być punkt: RRDGPostProcessor.
- Podaj identyfikator i nazwę nowego rozszerzenia. Jeśli na przykład nowe rozszerzenie ma nazwę PostProcessor1, w pliku plugin.xml powinien pojawić się wpis podobny do poniższego:
<extension id="PostProcessor1" name="PostProcessor1" point="com.ibm.rational.rrdg.RRDGPostProcessor">
<RRDGPostProcessor class="com.ibm.rational.rpe.postprocessor.PostProcessor1">
</RRDGPostProcessor>
</extension>
- Utwórz klasę PostProcessor1 z następującym kodem:
public class PostProcessor1 implements IPostProcessor
{
@Override
public void processResults(List <RPEResult> results)
{
// Cały kod przetwarzania wyników powinien znaleźć się w tym miejscu.
}
}
- Kod przetwarzania wyników powinien zostać dodany do metody PostProcessor1.processResults.
- Skompiluj wtyczkę i pakiet jako plik .jar.
- W przypadku lokalnego generowania dokumentów umieść spakowany plik .jar w folderze <katalog_instalacyjny_produktu_RPE>/launcher/plugins, a powinien być on ładowany podczas uruchamiania programu Launcher. W przypadku produktu Document Studio dodaj plik .jar do folderu <katalog_instalacyjny_produktu_RPE>/studio/plugins.
- W przypadku usług zdalnych dodaj spakowany plik .jar do folderu <katalog_instalacyjny_produktu_RPE>/webapps/WEB-INF/lib/plugins.
Jeśli folder plugins nie istnieje, utwórz ten folder ręcznie.