Sun Java logo     上一頁      目錄      索引      下一頁     

Sun logo
Sun Java System Portal Server 6 2005Q4 管理指南 

第 9 章
管理 Web Services for Remote Portlets (WSRP) 服務

本章說明如何管理 Sun Java™ System Portal Server Web Services for Remote Portlets (WSRP) 服務。

本章包含下列章節:


WSRP 標準簡介

WSRP 1.0 是一項 OASIS 標準,可簡化遠端應用程式與內容整合至入口網站的程序。WSRP 標準定義了兩項內容:1. 呈現導向的互動式 Web 服務。具備常見的、明確定義的介面,以及用於處理使用者互動與提供某些呈現區段 (適合於依入口網站進行調解和聚集) 的協定。2. 用於發佈、尋找與連結此類服務的慣例。

由於 WSRP 介面常見同時也有明確定義,因此實作 WSRP 標準的所有 Web 服務會連接至所有與 WSRP 相容的入口網站 - 入口網站端只要具備一個與服務無關的配接卡,就足以整合任何 WSRP 服務。因此,內容與應用程式提供者若使用 WSRP 給執行入口網站的組織提供服務,不需要額外的程式設計。

更多資訊,請參閱 WSRP 1.0 標準:

http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsrp

在 Portal Server 中實作 WSRP 1.0 標準將包括 WSRP 用戶與 WSRP 產生程式。WSRP 產生程式實作支援發佈 JSR 168 portlet 以供遠端 WSRP 用戶使用 (如需 JSR 168 portlet 的詳細資訊,請參閱第 8 章「管理 Portal Desktop 服務」 管理 Portlet)。JSR 168 portlet 部署於本地 Portal Server。WSRP 產生程式的實例將會發佈這些 portlet。

其他入口網站伺服器可以透過其 WSRP 用戶訂閱這些遠端 portlet。雖然可預期本機 portlet 將為 portal 提供大部份的基礎功能,但是遠端 portlet 仍允許連結至各種遠端 portlet,而不需要任何安裝動作或在 Portal Server 本機上執行的代碼。

圖 9-1  遠端 Portlet 的 Web 服務

遠端 Portlet 的 Web 服務


管理 WSRP 產生程式

本節將描述管理 WSRP 產生程式的工作:

若要新增 WSRP 產生程式實例


備註   

有關 Access Manager 管理主控台最新的完整資訊,請參閱「Sun Java System Access Manager 2005Q4 管理指南」。


  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。
  2. 依預設,位置窗格中的 [身份管理] 及 [瀏覽] 窗格中的 [組織] 皆已選取。

  3. 瀏覽至想要的組織或子組織,然後選取 [檢視] 功能表中的 [服務]。
  4. 所有已建立的組織會顯示在瀏覽窗格中。

  5. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 產生程式] 旁邊的特性箭頭。
  6. WSRP 產生程式屬性隨即顯示在資料窗格中。


    備註       

    根據您的需求與配置,您可能有能力在相同的組織或子組織 (甚至不同的組織或子組織) 下建立與啟用多個 WSRP 產生程式。其限制是 WSRP 產生程式的名稱在整個 Portal Server 系統中必須是唯一的。


  7. 按一下 [產生程式] 下的 [新增] 以加入產生程式實例。
  8. [指定基本參數] 頁面隨即顯示。

  9. 輸入下列特性的值:
    • 產生程式實例的名稱 (在整個 Portal Server 中必須是唯一的)
    • 必須要註冊
    • 當必須要註冊時,所有 WSRP 用戶都必須先使用此產生程式實例註冊,之後才能夠進行請求。來自未註冊用戶的請求將會被拒絕。

  10. 如果您選取 [必須要註冊],則會出現 [指定註冊特性]。請指定是否:
    • 支援頻帶內註冊 (如果 WSRP 用戶能夠線上註冊產生程式實例)。
    • 頻帶內註冊允許 WSRP 用戶有計劃性的註冊。否則,頻帶外註冊需要在 WSRP 用戶管理員與 WSRP 產生程式管理之間進行人工連絡 (例如電子郵件或電話),方可設定與交換對註冊控點的存取。

    • WSRP 用戶在註冊期間將會提供的註冊特性描述。
    • WSRP 用戶在註冊時必須提供的註冊特性。


      備註  

      註冊驗證程式是實現 Registration Validator 介面的 Java 類別。您可以根據自己需要編寫個人的註冊驗證程式類別,並且套用任何驗證用戶註冊所需的邏輯。


  11. 按一下 [下一步]。
  12. [檢閱頁] 頁面隨即顯示。

  13. 驗證您所提供的資訊,然後按一下 [完成]。

若要編輯 WSRP 產生程式實例


備註   

有關 Access Manager 管理主控台最新的完整資訊,請參閱「Sun Java System Access Manager 2005Q4 管理指南」。


  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。
  2. 依預設,位置窗格中的 [身份管理] 及 [瀏覽] 窗格中的 [組織] 皆已選取。

  3. 瀏覽至想要的組織或子組織,然後選取 [檢視] 功能表中的 [服務]。
  4. 所有已建立的組織會顯示在瀏覽窗格中。

  5. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 產生程式] 旁邊的特性箭頭。
  6. WSRP 產生程式屬性隨即顯示在資料窗格中。

  7. 按一下您要修改的產生程式實例旁邊的 [編輯特性] 連結。
  8. 選取 [一般特性] 標籤,然後視需要修改特性:
    • 產生程式實例的狀態 — 對於使用中的 WSRP 產生程式為「已啟用」,對於非使用中的產生程式實例為「已停用」。
    • 已停用的產生程式實例不會接受來自 WSRP 用戶的請求。依預設,WSRP 產生程式會維持停用狀態,直到發佈一個或多個 portlet 為止。

    • 必須要註冊 — 如果 WSRP 用戶需要註冊,則會核取此選項。
    • 頻帶內註冊 — 如果 WSRP 用戶可以有計劃地使用產生程式實例註冊,則支援此項。如果 WSRP 用戶只能以手動 (頻帶外) 的方式使用 WSRP 產生程式註冊,則不支援此項。
    • 頻帶內註冊允許 WSRP 產生程式有計劃性的連絡與傳送註冊資料,而 WSRP 用戶會從 WSRP 產生程式收到註冊控點。頻帶外註冊需要在 WSRP 用戶管理員與 WSRP 產生程式管理員之間進行人工連絡 (例如電子郵件或電話),方可設定與交換對註冊控點的存取。

    • 註冊驗證程式類別 — 用於驗證註冊的 Java 類別。當用戶註冊產生程式時,它會為產生程式在其服務描述中定義的每個註冊特性傳送註冊特性值。產生程式會使用註冊驗證程式類別以驗證此產生程式實例可接受用戶所傳送的值。

    • 提示  

      註冊者驗證程式是實現 Registrator Validator 介面的 Java 類別。您可以根據自己需要編寫個人的註冊者驗證程式類別,並且套用任何驗證用戶註冊所需的邏輯。


  9. 按一下 [確定] 將儲存 Netlet 服務。
  10. 選取 Portlet 標籤以修改 WSRP 用戶可用的已部署 portlet 清單,然後按一下 [儲存]。
  11. 如果支援註冊,請選取 [註冊特性] 標籤以新增或刪除特性 (所有 WSRP 用戶必須提供此特性才能夠註冊產生程式實例),然後按一下 [儲存]。

若要新增 WSRP 用戶註冊

用戶註冊允許 WSRP 用戶向 WSRP 產生程式描述其功能。正在於頻帶外新增 WSRP 用戶 (例如透過電子郵件或電話)。在新增用戶註冊時輸入的資訊必須符合已提供註冊控點之 WSRP 用戶的功能。用戶註冊允許 WSRP 產生程式設定由 WSRP 產生程式中的 WSRP 用戶所建立的 Artifact (例如 portlet 喜好設定) 的範圍。


備註   

有關 Access Manager 管理主控台最新的完整資訊,請參閱「Sun Java System Access Manager 2005Q4 管理指南」。


  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。
  2. 依預設,位置窗格中的 [身份管理] 及 [瀏覽] 窗格中的 [組織] 皆已選取。

  3. 瀏覽至想要的組織或子組織,然後選取 [檢視] 功能表中的 [服務]。
  4. 所有已建立的組織會顯示在瀏覽窗格中。

  5. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 產生程式] 旁邊的特性箭頭。
  6. WSRP 產生程式屬性隨即顯示在資料窗格中。

  7. 按一下您要修改的 WSRP 產生程式旁邊的 [編輯特性] 連結。
  8. 選取 [用戶註冊] 標籤。
  9. 按一下 [用戶註冊] 底下的 [新增]。
  10. [建立新用戶註冊] 頁面隨即顯示。

  11. 依需要指定基本特性:
    • WSRP 用戶的名稱。
    • 用戶註冊的狀態 — 對於使用中的用戶註冊為已啟用。而對於非使用中的用戶註冊為已停用。如果用戶註冊為非使用中,則產生程式將不會接受包括已停用用戶註冊之註冊控點的請求。
    • 用戶代理程式 — 應用程式名稱與版本的識別碼。
    • 識別碼的格式為 productName.majorVersion.minorVersion,例如 Sun Java(tm) System Portal Server.6.3

    • Method=“get” — 如果 WSRP 用戶已經以支援 HTML 標記 (包含 method=get 的形式) 的方式實作了 Portlet URL,則支援此項。否則不支援此項。
  12. 按一下 [下一步]。
  13. [指定註冊參數] 頁會在 WSRP 產生程式已配置為需要註冊時出現。

  14. 指定註冊特性的值。
  15. 按一下 [下一步]。
  16. [檢閱頁] 頁面隨即顯示。

  17. 驗證您所提供的資訊,然後按一下 [完成]。

若要編輯 WSRP 用戶註冊


備註   

有關 Access Manager 管理主控台最新的完整資訊,請參閱「Sun Java System Access Manager 2005Q4 管理指南」。


  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。
  2. 依預設,位置窗格中的 [身份管理] 及 [瀏覽] 窗格中的 [組織] 皆已選取。

  3. 瀏覽至想要的組織或子組織,然後選取 [檢視] 功能表中的 [服務]。
  4. 所有已建立的組織會顯示在瀏覽窗格中。

  5. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 產生程式] 旁邊的特性箭頭。
  6. WSRP 產生程式屬性隨即顯示在資料窗格中。

  7. 按一下您要修改的 WSRP 產生程式旁邊的 [編輯特性] 連結。
  8. 選取 [用戶註冊] 標籤。
  9. 按一下您要修改的用戶註冊旁邊的 [編輯特性] 連結。
  10. [編輯用戶註冊] 頁面隨即顯示。

  11. 依需要修改特性:
    • WSRP 用戶的名稱。
    • 用戶註冊的狀態 (「已啟用」用於使用中的客戶註冊,「已停用」用於非使用中的用戶註冊)。如果用戶註冊為非使用中,則產生程式將不會接受包括已停用用戶註冊之註冊控點的請求。
    • 用戶代理程式 (應用程式名稱與版本的識別碼)。
    • 識別碼的格式為 productName.majorVersion.minorVersion,例如 Sun Java(tm) System Portal Server.6.3

    • Method=“get” (如果 WSRP 用戶已經以支援 HTML 標記 (包含 method=get 的形式) 的方式實作 Portlet URL,則支援此項。否則不支援此項)。
    • 用戶模式 (WSRP 用戶願意管理的模式陣列。請參閱 WSRP 1.0 規格以取得更多資訊)。
    • 用戶視窗狀態 (WSRP 用戶願意管理的視窗狀態陣列。請參閱 WSRP 1.0 規格以取得更多資訊)。
    • 用戶使用者範圍 (WSRP 用戶願意處理以取得使用者環境的值。請參閱 WSRP 1.0 規格以取得更多資訊)。
    • 自訂使用者設定檔資料 (命名使用者設定檔副檔名的字串陣列。請參閱 WSRP 1.0 規格以取得更多資訊)。
    • 註冊特性 (註冊特性的清單。請參閱 WSRP 1.0 規格以取得更多資訊)。
  12. 按一下 [儲存]。

若要停用所有 WSRP 產生程式

  1. 選取位置窗格中的 [服務配置]。
  2. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 產生程式] 旁邊的特性箭頭。
  3. WSRP 產生程式屬性隨即顯示在資料窗格中。

  4. 選取 [全域] 底下的 [停用所有 WSRP 產生程式]。
  5. 按一下 [確定] 將儲存 Netlet 服務。


管理 WSRP 用戶

本節將描述管理 WSRP 用戶的工作:

建立遠端 Portlet 通道


備註   

有關 Access Manager 管理主控台最新的完整資訊,請參閱「Sun Java System Access Manager 2005Q4 管理指南」。


  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。
  2. 依預設,位置窗格中的 [身份管理] 及 [瀏覽] 窗格中的 [組織] 皆已選取。

  3. 瀏覽至想要的組織或子組織,然後選取 [檢視] 功能表中的 [服務]。
  4. 所有已建立的組織會顯示在瀏覽窗格中。

  5. 按一下 [Portal Desktop] 服務旁的特性箭頭。
  6. [Portal Desktop] 屬性隨即顯示在資料窗格中。

  7. 按一下 [通道與容器管理] 連結。
  8. [通道] 頁面隨即顯示。容器路徑顯示於頂端。已定義的通道會顯示在清單中。

  9. 按一下 [新增遠端 (WSRP) 通道] 以新增遠端通道。
  10. [新通道] 頁面隨即顯示。

  11. 從 [產生程式] 清單中選取 WSRP 產生程式。
  12. 從 Portlet 清單選取遠端 portlet。
  13. 在 [通道名稱] 中鍵入遠端通道的名稱。
  14. 按一下 [確定]。

若要編輯 WSRP 用戶的一般特性


備註   

有關 Access Manager 管理主控台最新的完整資訊,請參閱「Sun Java System Access Manager 2005Q4 管理指南」。


  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。
  2. 依預設,位置窗格中的 [身份管理] 及 [瀏覽] 窗格中的 [組織] 皆已選取。

  3. 瀏覽至想要的組織或子組織,然後選取 [檢視] 功能表中的 [服務]。
  4. 所有已建立的組織會顯示在瀏覽窗格中。

  5. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 用戶] 旁邊的特性箭頭。
  6. WSRP 用戶屬性隨即顯示在資料窗格中。

  7. 按一下 [一般] 標籤。
  8. 依需要修改特性:
    • 名稱 — WSRP 用戶會在註冊期間將用戶名稱傳送至產生程式。
  9. 按一下 [確定] 將儲存 Netlet 服務。

若要新增配置的 WSRP 產生程式


備註   

有關 Access Manager 管理主控台最新的完整資訊,請參閱「Sun Java System Access Manager 2005Q4 管理指南」。


  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。
  2. 依預設,位置窗格中的 [身份管理] 及 [瀏覽] 窗格中的 [組織] 皆已選取。

  3. 瀏覽至想要的組織或子組織,然後選取 [檢視] 功能表中的 [服務]。
  4. 所有已建立的組織會顯示在瀏覽窗格中。

  5. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 用戶] 旁邊的特性箭頭。
  6. WSRP 用戶屬性隨即顯示在資料窗格中。

  7. 按一下 [配置的產生程式] 標籤。
  8. 按一下 [產生程式] 下的 [新增] 以加入配置的 WSRP 產生程式。
  9. [指定基本參數] 頁面隨即顯示。

  10. 指定新配置的 WSRP 產生程式的名稱,以及想要的 WSRP 產生程式的 WSDL 之 URL。
  11. 按一下 [下一步]。
  12. 如果想要的 WSRP 產生程式需要註冊並支援頻帶內註冊,請指定 WSRP 用戶是否會:
    • 有計劃的在線上註冊想要的 WSRP 產生程式
    • 提供以人工方式從想要的 WSRP 產生程式獲得的註冊控點
    • 頻帶內註冊允許 WSRP 產生程式有計劃性的連絡與傳送註冊資料,而 WSRP 用戶會從 WSRP 產生程式收到註冊控點。頻帶外註冊需要在 WSRP 用戶管理員與 WSRP 產生程式管理員之間進行人工連絡 (例如電子郵件或電話),方可設定與交換對註冊控點的存取。如果必須要註冊,但是無法使用頻帶內註冊,則需要輸入從頻帶外獲得的註冊控點。

  13. 按一下 [下一步]。
  14. 提供在「註冊特性」中請求的資訊。
  15. WSRP 產生程式可能要求正在註冊的 WSRP 用戶傳回密鑰值 (或產生程式在其服務描述中描述的註冊特性,例如公司名稱或郵遞區號)。如果產生程式定義了註冊特性,此頁將會出現這些特性,而且應該會提供值。

  16. 按一下 [下一步]。
  17. [檢閱頁] 頁面隨即顯示。

  18. 驗證您所提供的資訊,然後按一下 [完成]。

  19. 備註  

    您可能需要編輯您新增的已配置 WSRP 產生程式,以設定角色對映的使用者種類。否則,部份的 portlet 可能無法正常運作。


若要編輯配置的 WSRP 產生程式


備註   

有關 Access Manager 管理主控台最新的完整資訊,請參閱「Sun Java System Access Manager 2005Q4 管理指南」。


  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。
  2. 依預設,位置窗格中的 [身份管理] 及 [瀏覽] 窗格中的 [組織] 皆已選取。

  3. 瀏覽至想要的組織或子組織,然後選取 [檢視] 功能表中的 [服務]。
  4. 所有已建立的組織會顯示在瀏覽窗格中。

  5. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 用戶] 旁邊的特性箭頭。
  6. WSRP 產生程式屬性隨即顯示在資料窗格中。

  7. 按一下 [配置的產生程式] 標籤。
  8. 按一下您要修改的已配置 WSRP 產生程式旁邊的 [編輯特性] 連結。
  9. [編輯基本特性] 頁面隨即顯示。

  10. 依需要修改特性:
    • WSRP 產生程式的名稱
    • WSRP 產生程式的狀態 —「已啟用」用於使用中的 WSRP 產生程式,「已停用」用於未使用的 WSRP 產生程式。
    • 以停用產生程式為目標的遠端 portlet 通道在 Portal Desktop 上將無法看見。在停用 WSRP 產生程式時要倍加小心。

    • 服務描述 — 按一下 [更新服務描述] 以取得 WSRP 產生程式最新的服務描述。
  11. 按一下 [確定] 將儲存 Netlet 服務。
  12. 如果顯示,請按一下 [角色對映的使用者種類] 連結。
  13. [角色對映的使用者種類] 頁面隨即顯示。

  14. 如果顯示,請指定 WSRP 使用者種類至本機的 Access Manager 角色。

  15. 備註

    並非所有 WSRP 產生程式都支援 WSRP 使用者種類。


  16. 按一下 [儲存]。
  17. 如果顯示,請按一下 [註冊特性] 連結。
  18. [註冊特性] 頁面隨即顯示。

  19. 依需要修改註冊特性的值。
  20. 按一下 [儲存]。

若要停用所有 WSRP 用戶

  1. 選取位置窗格中的 [服務配置]。
  2. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 用戶] 旁邊的特性箭頭。
  3. WSRP 用戶屬性隨即顯示在資料窗格中。

  4. 選取 [全域] 下的 [停用所有 WSRP 用戶]。
  5. 按一下 [儲存]。

若要編輯標準使用者設定檔對映

Portal Server 維持一組標準的一般使用者屬性,以此作為個人化目前使用者作為的一種方法。

  1. 選取位置窗格中的 [服務配置]。
  2. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 用戶] 旁邊的特性箭頭。
  3. WSRP 用戶屬性隨即顯示在資料窗格中。

  4. 使用下列格式修改 [全域] 底下的 [標準使用者設定檔對映] 值:
  5. WSRP-defined profile|LDAP-attribute

    請參閱 WSRP 1.0 規格以取得更多資訊。

  6. 按一下 [儲存]。

指定用戶名稱

WSRP 用戶會在註冊期間將用戶名稱傳送至產生程式。為用戶名稱指定的值會用來作為預設值,但是如果為用戶名稱指定的值是位於組織或子組織層級者例外。

  1. 選取位置窗格中的 [服務配置]。
  2. 在 [遠端 Portlet (WSRP)] 底下按一下 [WSRP 用戶] 旁邊的特性箭頭。
  3. WSRP 用戶屬性隨即顯示在資料窗格中。

  4. 在 [用戶名稱] 中輸入值。
  5. 按一下 [確定] 將儲存 Netlet 服務。



上一頁      目錄      索引      下一頁     


Copyright 2005 Sun Microsystems, Inc. 版權所有。