Przed rozpoczęciem konfigurowania specyfikacji dokumentów i
generowania dokumentów należy zainicjować interfejs API języka
Java™ i wybrać metodę rejestrowania.
Procedura
- Wymagane: Wybierz metodę inicjowania interfejsu API:
- Automatycznie: zmienna środowiskowa %RPE_HOME%
służy do identyfikowania ścieżki do katalogów config i
source w instalacji produktu
Rational Publishing Engine.
- Programowo: ustaw ścieżkę do katalogów
config i source w instalacji produktu
Rational Publishing Engine
za pomocą metody
AppUtils.setProductHome(ścieżka).
Wskazówka: Zalecaną metodą jest programowe inicjowanie interfejsu API. Jeśli interfejs API zostanie zainicjowany programowo, aplikacja jest
dostarczana wraz z katalogami config i
source i nie jest zależna od katalogów w instalacji
produktu
Rational Publishing Engine.
- Opcjonalne: Wybierz metodę rejestrowania:
- Skonfiguruj produkt
Rational Publishing Engine,
aby użyć programu rejestrującego w aplikacji:
- Utwórz instancję klasy org.apache.commons.logging.Log na potrzeby rejestrowania.
- Jeśli aplikacja nie korzysta ze wspólnego rejestrowania, można udostępnić
produktowi
Rational Publishing Engine
instancję klasy implementującej interfejs IRPELogger.
Ta klasa transformuje wywołania rejestrowania produktu
Rational Publishing Engine
w wywołania do mechanizmu rejestrowania aplikacji użytkownika.
- Skonfiguruj program rejestrujący produktu
Rational Publishing Engine
w aplikacji użytkownika:
- Jeśli została wybrana opcja skonfigurowania programu rejestrującego
produktu
Rational Publishing Engine
w aplikacji użytkownika (opisana w poprzednim kroku), przed użyciem
jakiejkolwiek funkcji produktu
Rational Publishing Engine
należy skonfigurować program rejestrujący Log4j.
- Jeśli plik log4j.properties znajduje się w głównym
folderze projektu, zainicjuj program rejestrujący Log4j, wykonując następującą
operację:
PropertyConfigurator.configure( this.class.getClassLoader().getResource("./log4j.properties"));
- Jeśli plik log4j.properties znajduje się w głównym
folderze projektu, zainicjuj program rejestrujący Log4j, wykonując następującą
operację:
PropertyConfigurator.configure( new File(
AppUtils.getConfigFilePath(), "log4j.properties").getAbsolutePath());
- Opcjonalne: Nawiąż połączenie z powiadomieniami o postępie. Komunikaty powiadomień mogą być wysyłane do generatorów raportów za pośrednictwem komendy RPEListener. Te komunikaty są tymi samymi komunikatami, które
są wyświetlane przez aplikację Launcher w oknie postępu podczas generowania
dokumentu.