Инициализация и подготовка API 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");
      • Настройте функцию ведения протокола 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());
  3. Необязательно: Подключитесь к уведомлениям о выполнении. Генераторам отчетов можно отправить уведомления с помощью RPEListener. Эти сообщения приложение Панель запуска отображает в окне состояния выполнения в ходе создания документа.

Комментарии