Inicialización y preparación de la API Java

Antes de empezar a configurar especificaciones de documento y generar documentos, debe inicializar la API Java™ y seleccionar un método de registro.

Procedimiento

  1. Necesario: Seleccione un método para inicializar la API:
    • Automáticamente: La variable de entorno RPE_HOME se utiliza para identificar la vía de acceso de los directorios config y source en la instalación de Rational Publishing Engine,
    • Mediante programas: Establezca la vía de acceso en los directorios config y source en la instalación de Rational Publishing Engine utilizando AppUtils.setProductHome(path).
    Consejo: La inicialización de la API mediante programas es el método recomendado. Al inicializar la API mediante programas, la aplicación se entrega con directorios config y source, en lugar de basarse en los directorios de la instalación de Rational Publishing Engine.
  2. Opcional: Seleccione un método para el registro:
    • Configure Rational Publishing Engine para utilizar el registrador en la aplicación:
      • Cree una instancia de la clase org.apache.commons.logging.Log para el registro.
      • Si la aplicación no utiliza el registro común, puede proporcionar Rational Publishing Engine con una instancia de una clase que implementa la interfaz IRPELogger. Esta clase transforma las llamadas de registro de Rational Publishing Engine a llamadas al registro para la aplicación.
    • Configure el registrador de Rational Publishing Engine en la aplicación:
      • Utilice el registrador de Rational Publishing Engine en la aplicación. Ejemplo:
        AppUtils.getLogger().info( "Starting RPE");
      • Configure el registrador Log4j antes de utilizar cualquier función de Rational Publishing Engine:
        • Si el archivo log4j.properties está en la carpeta raíz del proyecto, inicialice el registro Log4j mediante:
          PropertyConfigurator.configure( this.class.getClassLoader().getResource("./log4j.properties"));
        • Si el archivo log4j.properties no está en la carpeta raíz del proyecto, inicialice el registrador Log4j mediante:
          PropertyConfigurator.configure( new File( AppUtils.getConfigFilePath(), "log4j.properties").getAbsolutePath());
  3. Opcional: Conéctese a notificaciones de progreso. Los generadores de informes pueden enviar mensajes de notificación a través de RPEListener. Estos mensajes son los mismos mensajes que muestra la aplicación Launcher en la ventana de programa mientras se genera un documento.