指定文件規格中資料來源的鑑別類型

當資料來源需要鑑別時,會測試 Rational® Publishing Engine 支援的每個鑑別類型(FormBasicOAuthOAuth-OSLC),直到找到正確的類型為止。您可以透過指定鑑別類型來回避測試程序。

當您指定鑑別類型時,Rational Publishing Engine 會先確定所用的通訊協定是正確的,不會執行任何非必要的要求。 如果您的資料來源需要 BasicOAuthOAuth-OSLC 鑑別,或者您使用的是需要許多資料來源要求的複式範本,在產生文件時,您可能會感受到效能上有明顯的改進。如果沒有指定鑑別類型,就會測試每一個類型。

關於這項作業

請完成這項作業,以改進產生 HTML、XSL-FO 和舊式 PDF 文件的效能。

如需如何儲存使用者名稱與密碼的相關資訊,請參閱 IBM® Rational Publishing Engine 安全考量

程序

  1. 開啟 Launcher 應用程式。
  2. 建立文件規格。
  3. 配置資料來源。
  4. 選取資料來源。 這時會開啟「內容」視圖。
  5. 鑑別欄位中,輸入要套用於資料來源的鑑別類型。 您可以輸入下列其中一個區分大小寫的鑑別類型:
    • 表單
    • 基本
    • OAuth
    • OAuth-OSLC
  6. 必要的話,請輸入認證來進行資料來源鑑別,其中包括使用者名稱和密碼。
  7. 儲存文件規格。

下一步

更新現有文件規格中的鑑別內容。

建立 oslcServiceProviders.xml 檔以進行 OAuth-OSLC 鑑別

如果您使用的「通用 XML」、REST 第 1 版或 REST 第 2 版資料來源需要 OAuth-OSLC 鑑別,您必須先建立 oslcServiceProviders.xml,來儲存 base_urlconsumer_keysecret 內容值。

程序

  1. 針對 Rational Publishing Engine 安裝目錄中的範例來建立副本:RPE_HOME/config/oslcServiceProviders-sample.xml
  2. title 標籤中,提供資料來源提供者的名稱。
  3. description 標籤中,提供資料來源提供者的說明或附註。
  4. base_url 標籤中,提供資料來源的基本 URL。 範例:https://server:port/oslcCatalog
  5. pattern 標籤中,提供資料來源的 URL 型樣。 當您在 oslcServiceProviders.xml 檔中指定一份資料來源清單時,會使用型樣來識別哪些資料來源詳細資料符合資料來源需求。 範例:https://server:port/contextroot
  6. consumer_key 標籤中,提供資料來源中的消費者金鑰。
  7. secret 標籤中,提供資料來源中的密碼值。
  8. oslcServiceProviders.xml 檔儲存到 Rational Publishing Engine 安裝目錄以外的位置中。

下一步

使用 -Dcom.ibm.rational.rpe.config.oslcServiceProviders 旗標來指定 oslcServiceProviders.xml 的位置,使用 -Dcom.ibm.rational.rpe.config.oslcServiceProviders.pwd-Dcom.ibm.rational.rpe.config.oslcServiceProviders.usr 旗標來指定鑑別認證。

如需針對 WebSphere® Application ServerApache Tomcat用戶端應用程式配置旗標的相關資訊,請參閱下列其中一個主題。


意見