Než začnete konfigurovat specifikace dokumentu a generovat dokumenty, musíte inicializovat rozhraní Java™ API a vybrat metodu protokolování.
Postup
- Požadované: Vyberte metodu inicializace rozhraní API:
- Automaticky: K identifikaci cesty k adresářům config a source v instalaci produktu
Rational Publishing Engine se používá proměnná prostředí %RPE_HOME%.
- Programově: Cestu k adresářům config a source v instalaci produktu Rational Publishing Engine nastavte příkazem AppUtils.setProductHome(cesta).
Tip: Doporučuje se programová metoda inicializace rozhraní API. Když inicializujete rozhraní API programově, aplikace je dodána s adresáři
config a source a nespoléhá na adresáře v instalaci produktu
Rational Publishing Engine.
- Volitelné: Vyberte metodu protokolování:
- Nakonfigurujte produkt Rational Publishing Engine k použití modulu protokolování ve vaší aplikaci:
- Vytvořte instanci třídy org.apache.commons.logging.Log pro protokolování.
- Pokud vaše aplikace nepoužívá běžné protokolování, můžete poskytnout produktu Rational Publishing Engine instanci třídy implementující rozhraní IRPELogger.
Tato třída transformuje volání protokolování produktu Rational Publishing Engine na volání protokolování vaší aplikace.
- Nakonfigurujte modul protokolování produktu Rational Publishing Engine ve své aplikaci:
- Pokud jste se v předchozím kroku rozhodli nakonfigurovat modul protokolování produktu Rational Publishing Engine ve své aplikaci,
nakonfigurujte modul protokolování Log4j před použitím jakékoli funkce produktu Rational Publishing Engine.
- Pokud se soubor log4j.properties nachází v kořenové složce vašeho projektu, inicializujte modul protokolování
Log4j takto:
PropertyConfigurator.configure( this.class.getClassLoader().getResource("./log4j.properties"));
- Pokud se soubor log4j.properties nachází v kořenové složce vašeho projektu, inicializujte modul protokolování
Log4j takto:
PropertyConfigurator.configure( new File( AppUtils.getConfigFilePath(), "log4j.properties").getAbsolutePath());
- Volitelné: Připojte se k oznámením o průběhu. Generátorům sestav lze odeslat zprávy oznámení přes RPEListener.
Jedná se o tytéž zprávy,
jaké zobrazuje spouštěcí aplikace v okně s postupem operace během generování dokumentu.