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

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

第 8 章
管理 Portal Desktop 服務

本章說明如何管理 Sun Java System Portal Server 桌面服務。

本章包含下列章節：

桌面簡介

本章會說明桌面元件、其基本架構以及如何管理該元件。

桌面詞彙

表 8-1 說明相關的桌面術語。

表格的第一欄會列出術語；第二欄會提供術語的定義。

表 8-1 桌面詞彙

術語

定義

桌面

提供 Portal Server 的一般使用者主要介面。

提供者

調整常規資源的介面以供 Portal Server 使用。JSP 提供者會編譯與執行 JSP 檔案以產生標記。XML 提供者會轉譯 XML 檔案以產生標記。入口網站伺服器也可以查詢提供者以獲取有關顯示入口網站頁面上標記的資訊。

Portlet

可插接式網路元件，處理請求與產生入口網站上下文中的內容。Portlet 是由 Portlet 容器 (如同由 JSR168 專家群組定義的 Portlet 規格的實作) 管理。其在概念上等同於軟體「提供者」。

通道

顯示桌面的內容，一般以列跟欄排列。執行時，通道是由提供者物件、配置、支援通道要求的所有資料檔案 (JSP、HTML 範本等等) 所組成。

容器或容器通道

通道主要藉由包括或集合其他通道 (稱為子通道) 內容的方法產生其內容。

Portal Desktop 架構與容器階層

桌面是主要的 Portal Server 一般使用者介面。其經由 servlet 執行，並由各種 API 與公用程式 (例如，Sun Java™ System Access Manager API、資源束、特性檔案、例如郵件伺服器的後端伺服器等等) 支援。

桌面透過提供者應用程式介面 (PAPI) 提供延伸與集合內容的機制。內容提供者或提供者，啟用容器階層與基本建立區塊以建立某些類型的通道。一般而言，通道會以列與欄排列，但其也可以用其他排列方式顯示，根據容器通道的實作而定。提供者是程式實體，負責產生顯示於通道的內容。已產生的內容可以由實體頁面、框架、通道；任何標記組成。

當入口網站上的內容增加，參照封鎖方法或參考內容群組可以促進入口網站配置、開發與一般使用者經驗。Portal Server 提供一組有彈性、可延伸的容器提供者以集合內容。

圖 8-1 可以提供桌面容器階層範例。在本圖中，[標籤] 容器是頂層容器。[標籤容器] 包含兩個 [標籤通道]、標籤 1 與標籤 2。標籤 2 是 [表格容器] 且包含五個通道。

圖 8-1    Portal Desktop 容器階層範例

本圖會說明範例桌面的容器層級。請參閱圖前的文字以取得容器詳細資訊。

圖 8-1 說明下列容器類型：

使用者定義的通道

標籤容器中的每個標籤包括內容連結。若您選取 [內容] 連結，則會顯示一個使用者可以選取通道 (其欲顯示於目前標籤的容器中) 的頁面。在這個版本中，本頁面右上方將新增一個連結，[建立新通道] 連結。選取 [建立新通道] 連結時，會出現使用者可以建立新通道的頁面。然而，由使用者建立的通道可以由管理員定義。

若要建立新通道 (從顯示的頁面)，則使用者必須指定顯示表單中概述於表 8-2 的資訊。

表 8-2    使用者定義的通道

表單欄位             

欄位類型             

欄位說明

通道名稱

文字欄位

通道名稱只可以包含字母 (a-z、A-Z) 和數字 (0-9)。

通道標題

文字欄位

這是將會顯示於 [通道] 標題列的標題。

通道說明

文字欄位

這是顯示於 [內容] 連結頁面的 [通道] 說明。

通道類型

組合方塊

這是使用者可以在其中建立新 [通道] 的 [提供者] 清單。

通道種類

組合方塊

這是 [標籤容器] 的 [種類] 清單。

顯示通道

[是] 與 [否] 單選按鈕

選取 [顯示通道] 中的 [是]，如此在選取 [建立] 按鈕重新整理 [瀏覽器] 之後，將自動顯示新 [通道]。選取 [否]，如此在選取 [建立] 按鈕重新整理 [瀏覽器] 之後，將不會自動顯示新 [通道]。但通道卻可以顯示於 [瀏覽器] 中，方法是在 [內容] 連結中選取 [通道]。在任一種情況中，一旦選取新 [通道] 且顯示於 [瀏覽器] 中，則必須選取 [編輯] 按鈕 (可以在新建立的 [通道] 標題列中找到) 更新其特性。

建立

按鈕

選取 [建立] 以建立新 [通道]。

取消

按鈕

選取 [取消] 以傳回使用者至 [桌面] 顯示。

[刪除通道] 連結會在使用者建立使用者定義通道之後顯示於 [內容] 頁面。當使用者按一下連結時，會顯示一個使用者建立的所有通道清單以供可能的刪除作業之用。

Portal Desktop 提供者

Sun Java System Portal Server 使用兩種提供者類型：

Portal Desktop 會使用顯示設定檔以儲存內容、提供者、portlet 與通道資料。如需更多資訊，請參閱第 10 章「管理顯示設定檔」。

Portal Desktop 服務

桌面服務會使用 Sun Java System Access Manager 服務以儲存每個機構與子機構的應用程式與使用者特定的屬性。之後可以建立顯示設定檔策略並將其指派至使用者。您也可以使用 Sun Java System Access Manager 管理主控台以修改桌面屬性。如需關於桌面屬性的更多資訊，請參閱「Sun Java System Portal Server 2005Q1 Technical Reference Guide」。

範例桌面

在桌面範例中，Portal Server 包括下列通道：

自訂與配置範例入口網站的這些通道。其可能會在部署之前要求修改使用者介面。

Portal Desktop 自訂

部署 Portal Server 時，其中一個主要工作為開發或自訂您自己的入口網站。您將建立與延伸提供者、通道與容器通道，部署您自己的線上說明、提供外觀等等。若有需要，您可以使用範例桌面作為自訂站台入口網站的起點。請參閱「Sun Java System Portal Server 6 2005Q1 Desktop Customization Guide」以取得有關自訂入口網站的詳細資訊。

通道線上部署的概述

Portal Server 讓您在使用中的系統中部署提供者與通道而無需重新啟動，也就是「線上部署」。您可以執行這些作業而無需中斷使用者階段作業。

三個促進線上部署的技術為：

提供者歸檔的簡介

par 公用程式可讓您在 Portal Server 系統內外封裝與傳輸通道、portlet、提供者與所有相關檔案。通道、portlet，或提供者儲存於 .par 檔案格式。.par 中包括的檔案：

管理 Portal Desktop 服務

桌面合併使用者顯示設定檔合併程式集中的所有文件並使用結果配置使用者桌面。顯示設定檔合併程式集由與使用者相關的顯示設定檔文件組成。顯示設定檔會在 Sun Java System Access Manager 機構樹的不同層級中定義。合併或結合該樹不同層級的顯示設定檔文件以建立使用者的顯示設定檔。例如，使用者的顯示設定檔文件會與角色顯示設定檔文件 (若有的話)、機構的顯示設定檔文件、全域顯示設定檔文件合併以組成使用者的顯示設定檔。

桌面顯示設定檔與其他配置資料會定義為 Sun Java System Access Manager 服務管理框架之下的 Portal Desktop 服務的服務屬性。當機構從 Sun Java System Access Manager 管理主控台新增 Portal Desktop 服務，所有機構中的使用者會繼承其使用者設定檔的 Portal Desktop 服務屬性。Portal Desktop 會查詢這些屬性以決定要如何集合與顯示資訊於 Portal Desktop。

依預設，「策略配置」服務會自動新增至頂層機構。子機構必須獨立於其父系機構新增其策略服務。您建立的任何策略服務必須新增於所有機構。

下列會說明您在 Sun Java System Access Manager 機構配置 Portal Desktop 服務的高層級步驟。

  1. 為機構新增「策略」服務。
  2. 為同等機構或子機構建立參照策略。
  3. 為同等機構或子機構建立一般策略。
  4. 指派預設重新導向 URL。
  5. 自訂桌面服務屬性。

    6. 備註      

    若您安裝範例入口網站，則安裝程式會為範例安裝所有必須的顯示設定檔 XML 檔案。您可以使用 Sun Java System Access Manager 主控台或指令行介面自訂設定檔。有關更多資訊，請參閱第 10 章「管理顯示設定檔」。

依預設，「策略配置」服務會自動新增於頂層組織。子機構必須獨立於其父系機構新增其策略服務。您建立的任何策略服務必須新增於所有機構。使用策略的高層級步驟為：

  1. 為機構新增「策略」服務。(此步驟會自動為安裝時指定的機構完成。) 子機構不會繼承其父系的服務，所以您必須新增子機構的「策略」服務。如需詳細資訊，請參閱若要為子機構新增策略服務。
  2. 為同等機構或子機構建立參照策略。您可以授權機構的策略定義與決定給其他機構。(另外也可以選擇將資源的策略決策授權給其他策略產品。)參照策略控制策略建立與評估兩者的策略授權。它是由規則與參照本身組成。如果策略服務包含不需要資源的動作，則無法為子機構建立參照策略。如需詳細資訊，請參閱若要為子機構建立參考策略。
  3. 為同等機構或子機構建立一般策略。您建立一般策略來定義存取權限。一般策略可由多個規則、物件與條件所組成。如需詳細資訊，請參閱為子機構建立一般策略。

若要為子機構新增策略服務

子機構不會繼承其父系的服務，所以您必須新增子機構的「策略」服務。

備註     

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

  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。

    2. 依預設，已選取位置窗格中的 [識別管理] 且 [所有已建立的機構] 已顯示於瀏覽窗格中。

  2. 選擇您要新增桌面服務的機構。
  3. 在瀏覽窗格中的 [檢視] 功能表中選擇 [服務]。
  4. 按一下瀏覽窗格中的 [新增]。

    5. 在資料窗格中出現服務屬性清單。

  5. 選取 [Portal Server 配置] 之下的 [Portal Desktop] 核取方塊，並按一下 [確定]。

    6. 使用 [Portal Server 配置] 之下的已新增桌面服務更新 [瀏覽] 窗格。

  6. 在瀏覽窗格中的 [檢視] 功能表中選擇 [服務]。
  7. 按一下瀏覽窗格中桌面旁邊的特性箭頭。
  8. 在資料窗格的訊息方塊中會顯示一個問題以確認是否應為桌面服務建立服務範本。按一下訊息方塊中的 [建立] 以建立範本。
  9. 在提交頁面並建立範本之後，資料窗格會顯示桌面服務屬性清單與其預設值 (若有的話)。依需要修改值。完成時，按一下 [儲存]，在服務範本中儲存最後的值。

    10. 新建立的服務範本顯示設定檔會使用輸入於 [服務管理] 之下的 [Portal Desktop] 動態部分的值。若那些值為空白，則此新建立範本的顯示設定檔也會為空白。

    備註     

    [衝突解析度級別] 屬性的預設值為 [最高]。在不同層級 (例如，機構與角色) 使用已新增服務的相同優先權設定服務範本可能會導致無法預期的結果。

若要為子機構建立參考策略

您可以授權機構的策略定義與決定給其他機構。參照策略控制策略建立與評估兩者的策略授權。它是由規則與參照本身組成。參照必須將上層機構定義為規則中的資源，而且它必須包含 SubOrgReferral，擁有機構名稱作為參照中的值。

備註     

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

  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。

    2. 依預設，已選取位置窗格中的 [識別管理] 且 [所有已建立的機構] 已顯示於瀏覽窗格中。

  2. 在瀏覽窗格中選取 [識別管理]。
  3. 從 [檢視] 功能表中選取 [策略]。
  4. 按一下 [新增] 以建立新策略。

    5. [建立策略] 的頁面出現在資料窗格中。

  5. 在 [名稱] 中鍵入 SubOrgReferral_Desktop。確定您在 [策略類型] 中選取 [參照]。然後按一下 [建立]。
  6. 選取 [服務] 中的桌面，然後按 [下一步]。
  7. 在資料窗格中按一下 [檢視] 功能表中的 [規則]，然後按一下 [新增]。確定已選取 [Portal Desktop]，並按一下 [下一步]。

    8. 隨即在資料窗格中會顯示 [新增規則] 範本。

  8. 在 [規則名稱] 中輸入 DesktopRule，然後按一下 [建立]。
  9. 在資料窗格中按一下 [檢視] 功能表中的 [參照]，然後按一下 [新增]。

    10. [新增參照] 範本隨即會出現在資料窗格中。

  10. 在 [名稱] 中鍵入 SubOrgReferral_Desktop。

    11. 確定已為資料窗格中的 [值] 選取子機構的名稱，並按一下 [建立] 以完成策略的配置。

  11. 在資料窗格中按一下 [儲存]。

    12. 當資料已儲存，會顯示訊息 [策略特性已儲存]。

為子機構建立一般策略

您建立一般策略來定義存取權限。一般策略可由多個規則、物件與條件所組成。

備註     

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

  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。

    2. 依預設，已選取位置窗格中的 [識別管理] 且 [所有已建立的機構] 已顯示於瀏覽窗格中。

  2. 瀏覽至您要指定策略的機構或子機構。

    3. 所有已建立的機構會顯示在瀏覽窗格中。

  3. 從 [檢視] 功能表中選擇 [策略]。

    4. 該機構的策略會顯示。

  4. 在瀏覽窗格中選取 [新增]。[新策略] 的頁面會在資料窗格中開啟。
  5. 在 [名稱] 中輸入 SubOrgNormal_Desktop。確定您在 [策略類型] 中選取 [一般]。按一下 [建立]。
  6. 在資料窗格中選擇 [檢視] 功能表中的 [規則]，然後按一下 [新增]。[新增規則] 頁隨即會在資料窗格中開啟。
  7. 從 [服務] 功能表選取 [Portal Desktop]，並按一下 [下一步]。在 [規則名稱] 中輸入 DesktopRule。確定已核取 [有權限執行 NetMail]。
  8. 從 [服務] 功能表選取 [Portal Desktop]，並按一下 [下一步]。確定已核取 [有權限執行 NetMail]。
  9. 從 [類型] 功能表中選取主旨的類型，然後按一下 [下一步] 以完成主旨配置。
  10. 在資料窗格中選擇 [檢視] 功能表中的 [主旨]，然後按一下 [新增]。[新增主旨] 頁隨即會在資料窗格中開啟。
  11. 按一下 [建立] 以完成策略的配置。

    12. 當資料已儲存，會顯示訊息 [策略特性已儲存]。

若要成功的重新導向登入使用者至 Portal Desktop URL

依預設，機構的使用者會在成功登入後收到桌面服務屬性與值。桌面 servlet 會查詢這些值以決定機構中任何使用者的 Portal Desktop 內容。若要指示 Sun Java System Access Manager 以在使用者成功登入之後自動呼叫 Portal Desktop servlet，您可以變更「預設重新導向 URL」的值為 Portal Desktop URL。

備註     

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

若要為指定機構設定預設重新導向為 Portal Desktop URL：

  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。

    2. 依預設，已選取位置窗格中的 [識別管理] 且 [所有已建立的機構] 已顯示於瀏覽窗格中。

  2. 選取您要設定 [入口網站 URL] 的機構。
  3. 從 [檢視] 功能表中選擇 [服務]。
  4. 按一下瀏覽窗格中 [核心] 旁邊的特性箭頭。
  5. 在資料窗格中，搜尋名為 [預設成功登入 URL] 的屬性。
  6. 將使用者預設重新導向 URL 的值設定為 Portal Desktop servlet 的 URL，例如，/portal/dt 是桌面範例的 URL。
  7. 按一下 [儲存]。
  8. 藉由登入 [Portal Desktop] 驗證預設重新導向 URL。

若要成功的重新導向登入使用者至 Portal Desktop URL (全域)

套用至全域屬性的值會套用至整個 Sun Java System Access Manager 配置且所有新建立的機構將繼承這些屬性。

備註     

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

若要全域設定 [預設重新導向 URL] 為 [Portal Desktop URL]：

  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。

    2. 依預設，已選取位置窗格中的 [識別管理] 且 [所有已建立的機構] 已顯示於瀏覽窗格中。

  2. 選擇位置窗格中的 [服務配置]。
  3. 按一下瀏覽窗格中 [核心] 旁邊的特性箭頭。
  4. 在資料窗格中，搜尋名為 [預設成功登入 URL] 的屬性。
  5. 設定 [預設重新導向 URL] 的值為 [Portal Desktop Servlet 的 URL]，例如，/portal/dt。
  6. 按一下 [儲存]。

若要修改 Portal Desktop 服務屬性的值

您可以自訂 Portal Desktop 服務，方法是修改其服務屬性。

備註     

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

  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。

    2. 依預設，已選取位置窗格中的 [識別管理] 且 [所有已建立的機構] 已顯示於瀏覽窗格中。

  2. 請選取您要變更桌面屬性的機構。
  3. 按一下瀏覽窗格中桌面旁邊的特性箭頭。

    4. [Portal Desktop] 服務屬性清單 (包括顯示設定檔)，會顯示於資料窗格中。

  4. 修改服務屬性值。

    5. 如需關於桌面屬性的更多資訊，請參閱「Sun Java System Portal Server 2005Q1 Technical Reference Guide」。

  5. 完成後按一下 [儲存]。

    6. 所做的變更僅會影響此特定機構或角色中的使用者。

若要修改 Portal Desktop 服務屬性的值 (全域)

有時候您會需要修改全域桌面服務屬性值，這些值會影響希望在未來新增桌面服務的所有機構。

套用至全域屬性的值會套用至整個 Sun Java System Access Manager 配置，並由各配置的機構繼承。

備註     

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

  1. 以管理員的身份登入 Sun Java System Access Manager 管理主控台。

    2. 依預設，已選取位置窗格中的 [識別管理] 且 [所有已建立的機構] 已顯示於瀏覽窗格中。

  2. 選擇位置窗格中的 [服務管理]。
  3. 按一下瀏覽窗格中桌面旁邊的特性箭頭。

    4. 全域桌面服務屬性清單 (包括顯示設定檔) 會顯示於資料窗格中。

  4. 修改服務屬性值。

    5. 如需關於桌面屬性的更多資訊，請參閱「Sun Java System Portal Server 2005Q1 Technical Reference Guide」。

  5. 完成後按一下 [儲存]。

    6. 變更會影響未來新增桌面服務的所有機構。

若要存取範例 Portal Desktop

  1. 自 Sun Java System Access Manager 管理主控台登出。
  2. 使用使用者帳戶 (非 amadmin 使用者) 登入，使用下列 URL：

    3. http://server:port/portal/dt

    若需要建立使用者帳戶，請參閱第 6 章「管理認證、使用者與服務」以取得相關資訊。

若要檢驗桌面記錄

記錄 Portal Desktop 錯誤以除錯記錄檔。依預設，這些記錄檔的位置如下。

檢驗這些記錄檔中的有錯誤。範例如下。這個錯誤表示未授權的使用者嘗試執行 Portal Desktop。

 

06/20/2002 02:36:30:600 PM PDT:Thread[Thread-177,5,main]

ERROR:DesktopServlet.handleException()

com.sun.portal.desktop.DesktopException:DesktopServlet.doGetPost():no privilige to execute desktop

at com.sun.portal.desktop.DesktopServlet.doGetPost(DesktopServlet.java:456)

at com.sun.portal.desktop.DesktopServlet.service(DesktopServlet.java:303)

at javax.servlet.http.HttpServlet.service(HttpServlet.java:853)

at com.sun.server.http.servlet.NSServletRunner.invokeServletService(NSServletRunner.java:897)

at com.sun.server.http.servlet.WebApplication.service(WebApplication.java:1065)

at com.sun.server.http.servlet.NSServletRunner.ServiceWebApp(NSServletRunner.java:959)

 

管理 Portlet

在 Sun Java™ System Access Manager 管理主控台管理 Portlet。管理主控台包括在 portlet 建立 portlet 通道的頁面並變更 portlet 通道的喜好設定。pdeploy 是可以用於將 Portlet Web 應用程式部署及解除部署於 Web 容器的指令行工具 (有關管理指令行公用程式的更多資訊，請參閱「Sun Java System Portal Server 2005Q1 Technical Reference Guide」)。

備註     

若用戶端請求的入口網站網頁包含至少一個已啟用階段作業 portlet，強烈建議入口網站頁面上的所有 portlet 應封裝於單一 portlet 應用程式中，否則階段作業的結果行為可能會是不確定的。

若要從 Portlet 建立通道

備註     

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

  1. 登入 Sun Java System Access Manager 管理主控台並選取您的機構。
  2. 請在瀏覽功能表 [顯示] 之下選取 [服務]。
  3. 在 Portal 服務配置中選取 [桌面] 服務。
  4. 選取 [通道] 與 [容器管理] 連結。
  5. 選取 [通道] 之下的 [新增 Portlet 通道] 按鈕。

    6. 隨即顯示建立 portlet 通道的頁面。

  6. 在 [新增通道] 頁面中指定：
    • 通道名稱。
    • 請注意，通道名稱只可以包含字母 (A 到 Z) 與數字 (0 到 9) 且其為必要欄位。
    • Portlet

      • 只包含部署於所顯示系統中的 portlet。

  7. 選取 [建立] 按鈕以建立 portlet 通道。

若要在 Portlet 為特定容器建立通道

備註     

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

  1. 登入 Sun Java System Access Manager 管理主控台並選取您的機構。
  2. 請在瀏覽功能表 [顯示] 之下選取 [服務]。
  3. 在 [Portal Server] 配置之下選取 [桌面] 服務。
  4. 選取 [通道與容器管理]。
  5. 選取至您要建立 portlet 通道的 [容器] 連結。

    6. 隨即顯示管理容器的頁面。

  6. 選取 [通道] 之下的 [新增 Portlet 通道] 按鈕。

    7. 隨即顯示建立與新增 portlet 通道的頁面。

  7. 在 [新增通道] 頁面中指定：
    • 通道名稱。
    • 下拉清單中的 Portlet。清單僅會包含部署於系統中的 portlet。
  8. 選取適當的單選按鈕以確定一般使用者是否將可以使用通道，或在桌面上通道是否可用或可視。
  9. 選取 [確定] 按鈕。

    10. 請注意，通道會新增至 [通道] 之下的通道清單與 [容器管理] 頁面內的 [Portal Desktop 可視] 之下。

若要新增 Portlet 通道至容器

備註     

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

  1. 登入 Sun Java System Access Manager 管理主控台並選取您的機構。
  2. 請在瀏覽窗格 [顯示] 之下選取 [服務]。
  3. 在 [Portal Server 配置] 中選取 [桌面]。
  4. 選取 [通道與容器管理]。
  5. 選取至您要新增新建立 portlet 通道的 [容器] 的連結。

    6. 隨即顯示管理容器的頁面。

  6. 從 [準備使用] 清單選取您要新增的 portlet 通道。

    7. 按一下位於 [Portal Desktop 可視] 上的 [新增] 按鈕。

    這會將已選的 portlet 通道新增至已選容器的可視通道清單中。

  7. 選取 [通道管理] 之下的 [儲存] 按鈕以儲存新設定。

若要編輯 Portlet 通道喜好設定與特性

portlet 喜好設定會定義於 portlet.xml 中

<portlet-preferences>

<preference>

<name>foo</name>

<value>apple</value>

</preference>

<preference>

<name>bar</name>

<value>orange</value>

<value>grape</value>

<read-only>true</read-only>

</preference>

</portlet-preferences>

對映至下列顯示設定檔：

<Collection name="__Portlet__AdditionalPreferences"/>

<Collection name="__Portlet__PreferenceProperties">

<Collection name="default">

<String name="foo" value="|apple"/>

<String name="bar" value="|orange|grape"/>

</Collection>

<Collection name="isReadOnly">

<Boolean name="foo" value="false"/>

<Boolean name="bar" value="true"/>

</Collection>

</Collection>

<String name="__Portlet__foo" value="|apple"/>

<String name="__Portlet__bar" value="|orange|grape"/>

系統會建立一個空的集合 __Portlet__AdditionalPreferences 以保留在執行時間新增的喜好設定。__Portlet__PreferenceProperties 集合包含兩個集合，default 與 isReadOnly。default 集合會儲存 portlet.xml 中所定義的預設值。類似 default 集合，isReadOnly 集合會使用「布林」特性儲存喜好設定的唯讀旗標。

portlet.xml 中的每個喜好設定在default 集合中都有一個對應的 String 特性，喜好設定名稱為特性名稱。String 特性值代表定義於 portlet.xml 由字元 "|" 前置與分割的預設值。每個喜好設定之後會由 String 特性代表，其中儲存目前的喜好設定值。特性名稱就是 __Portlet__ 字串後的屬性名稱。特性值是目前由 "|" 字元前置與分割的喜好設定值。

備註     

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

  1. 登入 Sun Java System Access Manager 管理主控台並選取您的網域。
  2. 請在瀏覽窗格 [顯示] 之下選取 [服務]。
  3. 在 [Portal Server 配置] 中選取 [桌面]。
  4. 選取您要編輯的 portlet 通道 [編輯] 連結。
  5. 螢幕上會顯示 [編輯通道] 頁。通道編輯頁面會顯示 portlet 實體的 portlet 喜好設定。
  6. 修改喜好設定並選取 [儲存] 以儲存修改。
  7. 若要修改喜好設定的預設值，請選取您要編輯的喜好設定的 [編輯] 連結。特性可在 [編輯通道] 頁面中編輯。

管理 par 檔案

par 公用程式讓您將提供者或通道從一個 Portal Server 傳輸或移動至另一個。par 公用程式會建立一個特殊封裝機制，會調用 .par 檔案以將通道、portlet 與提供者傳進或傳出伺服器。.par 檔案是 .jar 檔案格式的延伸形式，含有新增的明示資訊以傳送部署資訊與 XML 文件，以整合至目標伺服器的 Portal Server 顯示設定檔。

par 指令行公用程式會用於建立、修改與部署 par 檔案。export 子指令允許您建立或修改 par 檔案。import 子指令能讓您在 Portal Server 上匯入或部署提供者、通道或 portlet。describe 子指令會說明 par 檔案的內容。有關 par 指令語法的詳細資訊，請參閱「Sun Java System Portal Server 2005Q1 Technical Reference Guide」。

若要使用 par 公用程式，您必須以 superuser 身分登入 Portal Server，其中包含您要匯出或匯入的檔案。當匯出時，您必須確定要匯出通道、portlet 或提供者需要的所有檔案。例如，對於通道，您必須包括靜態內容檔案，對於提供者，您必須包括提供者使用的所有類別檔案。因為於指令行指定 par 檔案包括的所有資料是很麻煩的，於是建立了可用幾行表示這些資料的單一文本文件，par 公用程式將調用這個「匯出檔案」。有關更多資訊，請參閱第 8 章「管理 Portal Desktop 服務」。

若要建立新 par 檔案

若要建立新 par 檔案以匯出通道、portlet 或提供者：

  1. 登入要匯出通道、portlet 或提供者的 Portal Server。
  2. 變更目錄為安裝程序檔的目錄。方法是：

    3. cd PortalServer-base/SUNWps/bin

  3. 在指令行，輸入 par export 指令與子指令並包括下列引數：欲建立的 par 檔案名稱，對應想要匯出顯示設定檔文件的目錄伺服器名稱引數，與任何數量的 (需要至少一個) 匯出檔案或 from 規格。例如，若要將通道 mychannel 從 o=sesta.com,o=isp 匯出至 mychannel.par 檔案，請輸入

    4. ./par export mychannel.par "o=sesta.com,o=isp" from:channel mychannel

    有關更多語法資訊，請參閱「Sun Java System Portal Server 2005Q1 Technical Reference Guide」。

若要修改現有 par 檔案

若要修改現有 par 檔案以匯出通道、portlet 或提供者：

  1. 登入要匯出通道、portlet 或提供者的 Portal Server。
  2. 變更目錄為安裝程序檔的目錄。方法是：

    3. cd PortalServer-base/SUNWps/bin

  3. 在指令行，輸入 par export 指令與含有 modify 選項的子指令並包括下列引數：欲修改的 par 檔案名稱，對應想要匯出顯示設定檔文件的目錄伺服器名稱引數，與任何數量的 (需要至少一個) 匯出檔案或 from 規格。例如，若要修改 mychannel.par 檔案以包括動態內容檔案 /mycontent.html，請輸入

    4. ./par export --modify mychannel.par "dc=sesta,dc=com" from= file /mycontent.html”

若要部署 par 檔案

若要匯入 par 檔案至 Portal Server 以部署提供者或通道於系統：

  1. 複製提供者與通道的 par 檔案以匯入欲部署提供者或通道的 Portal Server。
  2. 登入要匯入通道、portlet 或提供者的 Portal Server。
  3. 變更目錄為安裝程序檔的目錄。方法是：

    4. cd PortalServer-base/SUNWps/bin

  4. 在指令行，輸入 par import 指令與子指令並包括下列引數：欲匯入的 par 檔案名稱，對應至想要匯出的顯示設定檔的目錄伺服器名稱引數，例如，若要匯入 mychannel.par 檔案，請輸入

    5. ./par import --auto myfile.par "do=sesta,dc=com"



上一頁      目錄      索引      下一頁     

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