Указание типа идентификации для источника данных в спецификации документа

Если источник данных требует идентификации, проверяется каждый тип идентификации, поддерживаемый Rational Publishing Engine (Form, Basic, OAuth или OAuth-OSLC), пока не будет найден правильный тип. Можно обойти процесс проверки, назначив тип идентификации.

Когда вы указываете тип идентификации, Rational Publishing Engine обеспечивает использование правильного протокола в первую очередь и излишние запросы не выполняются. Вы можете ощутить значительное улучшение производительности при генерации документа, если источник данных требует идентификации Basic, OAuth или OAuth-OSLC или если используется сложный шаблон, который требует многих запросов из источника данных. Если тип идентификации не задан, проверяется каждый тип.

Об этой задаче

Выполните эту задачу для повышения производительности при генерации документов HTML, XSL-FO и Legacy PDF.

Дополнительная информация о хранении имени пользователей и паролей приведена в разделе Замечания о защите для IBM® Rational Publishing Engine.

Процедура

  1. Откройте приложение Панель запуска.
  2. Создайте спецификацию документа.
  3. Настройте источник данных.
  4. Выберите источник данных. Откроется панель Свойства.
  5. В поле идентификация введите тип идентификации, применяемый для источника данных. Можно ввести один из следующих типов идентификации с учетом регистра:
    • Form
    • Базовая
    • OAuth
    • OAuth-OSLC
  6. Если необходимо, введите идентификационные данные для источника данных, включая имя пользователя и пароль.
  7. Сохраните спецификацию документа.

Дальнейшие действия

Измените свойства идентификации в существующих спецификациях документов.

Создание файла oslcServiceProviders.xml для идентификации OAuth-OSLC

В случае применения источника данных Базовый XML, REST v1 или REST v2 с идентификацией OAuth-OSLC необходимо создать oslcServiceProviders.xml для хранения значений свойств base_url, consumer_key и secret.

Об этой задаче

По умолчанию продукт выполняет поиск файла oslcServiceProviders.xml в каталоге RPE_HOME/config. Преимущество создания файла oslcServiceProviders.xml в каталоге RPE_HOME/config заключается в том, что не требуется дополнительная настройка. Обратите внимание, что перед обновлением продукта необходимо создать резервную копию этого файла. После установки и обновления поместите резервную копию файла oslcServiceProviders.xml в каталог RPE_HOME/config нового экземпляра продукта.
Файл oslcServiceProviders.xml можно разместить за пределами каталога RPE_HOME/config, однако в этом случае расположение файла oslcServiceProviders.xml должно быть указано в свойстве com.ibm.rational.rpe.config.oslcServiceProviders. В случае применения защищенного пути HTTP необходимо указать идентификационные данные в свойствах com.ibm.rational.rpe.config.oslcServiceProviders.usr и com.ibm.rational.rpe.config.oslcServiceProviders.pwd. Эти свойства можно указать в следующих областях:
  • Переменные среды в операционной системе
  • Свойства Java в виртуальной машине Java (JVM)
  • Флаги в среде выполнения. Дополнительная информация о настройке флагов для WebSphere Application Server, Apache Tomcat или клиентских приложений приведена в одном из следующих разделов.

Возможность создания файла oslcServiceProviders.xml за пределами каталога по умолчанию RPE_HOME/config в особенности актуальна для сред совместной работы. Файл oslcServiceProviders.xml в общем расположении может использоваться несколькими пользователями. Общее расположение должно быть указано в свойстве com.ibm.rational.rpe.config.oslcServiceProviders.

Процедура

  1. Создайте копию примера в установочном каталоге Rational Publishing Engine: RPE_HOME/config/oslcServiceProviders-sample.xml
  2. В текстовом редакторе откройте копию файла oslcServiceProviders.xml.
  3. В тегах title укажите имя провайдера источника данных.
  4. В тегах description укажите описание или примечания провайдера источника данных.
  5. В тегах base_url укажите базовый URL источника данных. Пример: https://сервер:порт/oslcCatalog
  6. В тегах pattern укажите шаблон URL источника данных. Если в файле oslcServiceProviders.xml указан список источников данных, то шаблон применяется для выбора источника данных, соответствующего требованиям. Пример: https://сервер:порт/contextroot
  7. В тегах consumer_key укажите ключ приемника из источника данных.
  8. В тегах secret укажите пароль из источника данных.
  9. Сохраните файл oslcServiceProviders.xml за пределами установочного каталога Rational Publishing Engine.