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

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

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

關於這項作業

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

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

程序

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

下一步

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

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

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

關於這項作業

依預設,產品會在 RPE_HOME/config 目錄之下尋找 oslcServiceProviders.xml 檔。 在這個預設的 RPE_HOME/config 目錄之下建立您的 oslcServiceProviders.xml 檔的好處是不需要進一步的配置。 不過,當想要升級至產品更新的版本時,您必須記得建立這個檔案的備份。 安裝和升級之後,您可以將檔案的 oslcServiceProviders.xml 檔放在新安裝產品的 RPE_HOME/config 目錄之下。
您可以在預設的 RPE_HOME/config 目錄之外指定 oslcServiceProviders.xml 檔,但您必須在 com.ibm.rational.rpe.config.oslcServiceProviders 內容中指定 oslcServiceProviders.xml 檔的位置。 如果該位置是一個 HTTP 安全路徑,您必須使用 com.ibm.rational.rpe.config.oslcServiceProviders.usrcom.ibm.rational.rpe.config.oslcServiceProviders.pwd 內容,來指定鑑別認證。請使用下列其中一個範圍,來指定這些內容:

在預設的 RPE_HOME/config 目錄之外建立 oslcServiceProviders.xml 檔可支援團隊協同作業環境。 當 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://server:port/oslcCatalog
  6. pattern 標籤中,提供資料來源的 URL 型樣。 當您在 oslcServiceProviders.xml 檔中指定一份資料來源清單時,會使用型樣來識別哪些資料來源詳細資料符合資料來源需求。 範例:https://server:port/contextroot
  7. consumer_key 標籤中,提供資料來源中的消費者金鑰。
  8. secret 標籤中,提供資料來源中的密碼值。
  9. oslcServiceProviders.xml 檔儲存到 Rational Publishing Engine 安裝目錄以外的位置中。