Specifying the authentication type for a data source in a document specification

When a data source requires authentication, each authentication type that is supported by Rational® Publishing Engine (Form, Basic, or OAuth) is tested until the correct type is found. You can circumvent the testing process by designating an authentication type.

When you specify the authentication type, Rational Publishing Engine ensures that the correct protocol is used first and unnecessary requests are not performed. You might see a significant performance improvement in document generation time if your data source requires Basic, or OAuth authentication or if you are using a complex template that requires many requests from the data source. If no authentication type is specified, each type is tested.

About this task

Complete this task to improve the performance of generating HTML, XSL-FO, and Legacy PDF documents.
Note: For the Rational RequisitePro® adapter provided by Data Services, you must specify Basic authentication.

Procedure

  1. Open the Launcher application.
  2. Create a document specification.
  3. Configure a data source.
  4. Select the data source. The Properties view opens.
  5. In the authentication field, enter the authentication type that applies to your data source. You can enter one of the following case-sensitive authentication types:
    • Form
    • Basic
    • OAuth
  6. If necessary, enter the credentials to authenticate with the data source including the user name and password.
  7. Save the document specification.

What to do next

Update the authentication properties in existing document specifications.

Feedback