Инициализация и подготовка API Rational Publishing Engine Java

Перед тем как приступить к настройке спецификаций документов и созданию документов необходимо выполнить инициализацию API Java™ и выбрать способ ведения протокола.

Процедура

  1. Обязательно: Выберите способ инициализации API:
    • Автоматически: переменная среды %RPE_HOME% применяется для определения пути к каталогам config и source экземпляра Rational Publishing Engine.
    • Программно: укажите путь к каталогам config и source экземпляра Rational Publishing Engine с помощью метода AppUtils.setProductHome(path).
    Совет: Программная инициализация API является рекомендуемым методом. В случае программной инициализации API приложению передаются каталоги config и source вместо каталогов, доступных в экземпляре Rational Publishing Engine.
  2. Необязательно: Выберите способ ведения протокола:
    • Настройте Rational Publishing Engine для применения программы ведения протокола в приложении:
      • Создайте экземпляр класса org.apache.commons.logging.Log для ведения протокола.
      • Если приложение не использует общие средства ведения протоколов, то для Rational Publishing Engine можно указать экземпляр класса, реализующего интерфейс IRPELogger. Этот класс преобразует вызовы ведения протокола Rational Publishing Engine в вызовы, соответствующие требованиям приложения.
    • Настройте программу ведения протокола Rational Publishing Engine в приложении:
      • Добавьте в приложение программу ведения протокола Rational Publishing Engine. Пример:
        AppUtils.getLogger().info( "Starting RPE");
  3. Если на предыдущем шаге была выбрана программа ведения протокола Rational Publishing Engine, настройте Log4j перед применением любых функций Rational Publishing Engine.
    • Если файл log4j.properties расположен в корневой папке проекта, выполните инициализацию программы ведения протокола Log4j:
      PropertyConfigurator.configure( this.class.getClassLoader().getResource("./log4j.properties"));
    • Если файл log4j.properties расположен в корневой папке проекта, выполните инициализацию программы ведения протокола Log4j:
      PropertyConfigurator.configure( new File( AppUtils.getConfigFilePath(), "log4j.properties").getAbsolutePath());
  4. Необязательно: Подключитесь к уведомлениям о выполнении. Генераторам отчетов можно отправить уведомления с помощью RPEListener. Эти сообщения приложение Панель запуска отображает в окне состояния выполнения в ходе создания документа.

Комментарии