Inicializando e preparando a API Java

Antes de começar a configurar especificações de documentos e gerar documentos, você deve inicializar a API Java™ e selecionar um método de criação de log.

Procedimento

  1. Necessário: Selecione um método para inicializar a API:
    • Automaticamente: A variável de ambiente RPE_HOME é usada para identificar o caminho para os diretórios config e source na instalação do Rational Publishing Engine.
    • Programaticamente: Configure o caminho para os diretórios config e source na instalação do Rational Publishing Engine usando AppUtils.setProductHome(path).
    Dica: Inicializar a API programaticamente é o método recomendado. Quando você inicializa a API programaticamente, o aplicativo é fornecido com os diretórios config e source em vez de contar com os diretórios na instalação do Rational Publishing Engine.
  2. Opcional: Selecione um método para criação de log:
    • Configure Rational Publishing Engine para usar o criador de logs em seu aplicativo:
      • Crie uma instância da classe org.apache.commons.logging.Log para criação de log.
      • Se seu aplicativo não usar a criação de log comum, poderá fornecer Rational Publishing Engine com uma instância de uma classe que implementa a interface IRPELogger. Essa classe transforma as chamadas de criação de log do Rational Publishing Engine em chamadas para a criação de log de seu aplicativo.
    • Configure o criador de logs do Rational Publishing Engine em seu aplicativo:
      • Use o criador de logs do Rational Publishing Engine em seu aplicativo. Por exemplo:
        AppUtils.getLogger().info( "Starting RPE");
      • Configure o criador de logs Log4j antes de usar qualquer função do Rational Publishing Engine:
        • Se o arquivo log4j.properties estiver na pasta raiz de seu projeto, inicialize o criador de logs Log4j por:
          PropertyConfigurator.configure( this.class.getClassLoader().getResource("./log4j.properties"));
        • Se o arquivo log4j.properties não estiver na pasta raiz de seu projeto, inicialize o criador de logs Log4j por:
          PropertyConfigurator.configure( new File( AppUtils.getConfigFilePath(), "log4j.properties").getAbsolutePath());
  3. Opcional: Conecte-se às notificações de progresso. Mensagens de notificação podem ser enviadas aos geradores de relatórios por meio de RPEListener. Essas mensagens são as mesmas mensagens que o aplicativo Launcher exibe na janela de progresso enquanto um documento está sendo gerado.