第 16 章 管理和自訂通道
本章說明如何使用 [桌面設計配置] 管理和自訂通道。
備註 –
要配置 Instant Messenger 通道，您可以參閱 http://wiki.java.net/bin/view/OpenPortal/ConfigureIMPortlet72。
管理通道
移動通道
-
在 Portal Server 管理主控台中，存取要建立或修改之桌面的 [桌面設計配置] 頁面。
要存取 [桌面設計配置] 頁面，請參閱「在 Portal Server 管理主控台中存取桌面設計工具」的程序。
-
在工作區中，選取要移動之通道所在的標籤。
-
在 [通道] 標題列中，選取：
- 向上或向下圖示
-
在桌面上向上或向下移動通道。
- 向左 (<) 或向右 (>) 圖示
-
在桌面上向右或向左移動通道。請注意，窄通道無法移至寬欄中，而寬通道無法移至窄欄中。不過，在三欄 (窄-寬-窄) 桌面中，可使用向右或向左 (<) 圖示，將來自窄欄的通道移至左邊或右邊窄欄。
移除通道
-
在 Portal Server 管理主控台中，存取要建立或修改之桌面的 [桌面設計配置] 頁面。
要存取 [桌面設計配置] 頁面，請參閱「在 Portal Server 管理主控台中存取桌面設計工具」的程序。
-
在工作區中，選取要移除之通道所在的標籤。
-
在 [通道] 標題列中，選取關閉 (x) 圖示，將通道從桌面移除。
新增通道
-
在 Portal Server 管理主控台中，存取要建立或修改之桌面的 [桌面設計配置] 頁面。
要存取 [桌面設計配置] 頁面，請參閱「在 Portal Server 管理主控台中存取桌面設計工具」的程序。
-
在工作區中，選取要新增通道的標籤。
-
從右窗格中的 [通道程式庫]，選取要新增的通道。
-
按一下 [新增至桌面] 按鈕，將通道新增至工作區中的桌面。
如果在程式庫區域中選取的通道是程式庫通道，則會出現快顯式視窗，您必須在其中指定通道名稱、通道標題和通道寬度。如果選取的通道是位在目前顯示設定檔節點的通道實例，則通道實例會新增至目前選取的標籤。
配置通道
-
在 Portal Server 管理主控台中，存取要建立或修改之桌面的 [桌面設計配置] 頁面。
要存取 [桌面設計配置] 頁面，請參閱「在 Portal Server 管理主控台中存取桌面設計工具」的程序。
-
在工作區中，選取要配置之通道所在的標籤。
-
選取通道中的 [配置通道] 連結。
此時會出現含有通道特性的快顯式頁面，以讓您編輯通道特性。
-
完成修改後按一下 [關閉]。
設定通道工具列特性
-
在 Portal Server 管理主控台中，存取要建立或修改之桌面的 [桌面設計配置] 頁面。
要存取 [桌面設計配置] 頁面，請參閱「在 Portal Server 管理主控台中存取桌面設計工具」的程序。
-
在工作區中，選取通道所在的標籤。
-
在 [通道] 視窗中，選取 [設定工具列特性] 連結。
此時會出現快顯式頁面，其中含有要修改之通道的通道工具列特性。此頁面可讓您修改通道工具列，並顯示與通道所在之標籤有關的特性 (例如，可最小化、可最大化、可移動、可移除)。
-
按一下 [儲存] 儲存值。
-
按一下 [關閉] 關閉快顯式視窗。
使通道對使用者為可視或隱入
-
在 Portal Server 管理主控台中，存取要建立或修改之桌面的 [桌面設計配置] 頁面。
要存取 [桌面設計配置] 頁面，請參閱「在 Portal Server 管理主控台中存取桌面設計工具」的程序。
-
在工作區中，選取通道所在的標籤。
-
選取以下連結：
- 使通道對一般使用者為不可視
-
使通道為隱入。
- 使通道為可視
-
使通道在使用者桌面上為可視。
新增通道至使用者定義的標籤
使用者可透過使用 [標籤] 連結，然後按一下 [建立新標籤] 連結，新增標籤至其桌面。當使用者選擇從頭開始建立新的標籤時，出現的內容頁面上顯示的通道清單是從 JSPTabCustomTableContainer 的可用清單所取得。
使用通道新增內容至桌面
入口網站管理員可透過新增提供者和 Portlet 通道，新增內容至入口網站桌面。下列程序討論如何建立通道、修改它的特性、將它新增至桌面，然後確認它是否顯示。
建立 URLScraper 通道
假設您要建立名稱為 MyChannel 的通道，該通道顯示來自外部網頁 (例如，http://www.google.com) 的內容。下列步驟顯示如何建立 URLScraper 通道。依照相同的步驟可建立其他以提供者和 Portlet 為基礎的通道。
TBD
-
以管理員 (amadmin) 身份登入 Portal Server 管理主控台。
-
按一下 [入口網站] 標籤。
-
按一下 [入口網站] 清單中的 [Portal-URI]。
-
在 [選取 DN] 清單中選取企業範例 [Org]。
-
按一下 [設計桌面配置]。
-
選取要建立新通道的標籤。例如，按一下 [新聞] 標籤。
-
按一下 [NewsContainer] 頁面中的 [新增通道或容器]。
-
在 [通道程式庫] 清單中選取 [URLScraper]。
-
在 [通道程式庫] 中，按一下 [新增至桌面]。
快顯式視窗便會顯示。提供下列資訊：
-
按一下 [新增通道]。現在通道在工作區中為可用及可視。
自訂通道更新時間和容器快取
refreshTime 特性控制重新載入通道內容的頻率。當容器的 refreshTime 設為 0 (預設) 時，瀏覽器更新 (或重新載入) 會導致重新載入頁面，並為每個通道再次呼叫 getContent() 方法。
以下套用於單一通道：
-
由於通道是 HTML 表格儲存格，因此無法只更新容器內單一通道的內容。
-
可以在 PAPI 中使用 DesktopURL() 方法。提供者可使用 getDesktopURL() 取得「桌面 Servlet」的 URL，附加引數至該 URL，然後產生新的 URL (或連結)。
-
將容器的 refreshTime 特性與容器內個別通道的 refreshTime 一起使用。
-
如果容器的 refreshTime 為空白，則會被計算為所有包含通道的最小時間。如果想要置換計算的時間，請設定容器的 refreshTime ，然後整個容器的內容都會被快取。
備註 –
若您有大量通道，可透過將 refreshTime 設定為大數目來利用提供者快取，以便入口網站頁面可使用快取的內容。當大多數的通道具有靜態內容時，這麼做便很有意義。refreshTime 的運作方式是，如果容器的 refreshTime 已設定，就會使用它。如果 refreshTime 設定為空字串，它會嘗試取得並使用其所選通道的最小 refreshTime。
自訂視窗喜好設定
對於包含啟動其他瀏覽器之連結的通道，您可控制開啟該瀏覽器視窗的方式。
自訂通道視窗喜好設定
-
定義顯示設定檔 (為通道定義，以便只對該通道進行變更；或為提供者定義，以對使用該提供者的每個通道進行變更)，使其包含 windowPref 特性。
例如：
<Properties> ... <String name="windowPref" value="all_new"/> ... </Properties>
備註 –值可為：
-
all_new (為每個連結開啟新視窗)
-
one_new (所有連結都在相同新視窗開啟)
-
same (桌面視窗)
-
-
使用 psadmin 子指令或從 Portal Server 管理主控台，將顯示設定檔載入 LDAP 中。
備註 –針對該特定通道，必須使用 JavaScript 協助建立智慧。
從 Portal Server 管理主控台自訂通道視窗喜好設定
-
登入 Portal Server 管理主控台，然後選取必須變更 windowPref 的使用者、組織或角色。
-
選取 [管理通道與容器]，然後按一下有關的通道。在右框架上，變更通道的 windowPref 特性值。
值可為：
-
all_new (為每個連結開啟新視窗)
-
one_new (所有連結都在相同新視窗開啟)
-
same (桌面視窗)
-
移除按鈕
從容器中的所有通道移除按鈕
-
找出您要對其進行操作的容器。若您是使用其中一個範例入口網站，則需要修改適當的「包含」容器，它為頂層容器的一部分。
-
將「移除按鈕」中所列的適當特性 (以 <Properties></Properties> 括住) 標記，新增至想要移除的按鈕的容器顯示設定檔。在以下分為兩欄的表格中，第一欄列出按鈕，第二欄則列出隱藏按鈕的特性。
此表格中的按鈕順序，對應至按鈕在通道中顯示的順序，從左到右為：[最小化]、[最大化]、[說明]、[編輯]、[分離] 和 [移除]。
按鈕
隱藏按鈕的特性
最小化
<Boolean name="defaultChannelIsMinimizable" value="false"/>
最大化
<Boolean name="defaultChannelIsMaximizable" value="false"/>
說明
<String name="helpURL" value=""/>
編輯
<Boolean name="isEditable" value="false"/>
分離
<Boolean name="defaultChannelIsDetachable" value="false"/>
移除
<Boolean name="defaultChannelIsRemovable" value="false"/>
備註 –針對 [說明] 和 [編輯] 按鈕，請為每個通道插入各自的特性。您無法在容器的 <Properties></Properties> 標記內插入特性。
請確認未在容器中定義下列特性：
<Collection name="channelsIsRemovable">..</Collection> <Collection name="channelsIsMinimizable"/>..</Collection> <Collection name="channelsIsMaximizable"/>..</Collection> <Collection name="channelsIsDetachable"/>..</Collection>
-
使用 psadmin 子指令或從 Portal Server 管理主控台，將顯示設定檔載入 LDAP 中。
從 Portal Server 管理主控台自容器中的所有通道移除按鈕
-
登入 Portal Server 管理主控台，然後選取定義容器的使用者、組織或角色。
-
選取 [管理通道與容器]，然後按一下包含的容器。
-
將 DefaultChannelIsMinimizable、DefaultChannelIsMaximizable、helpURL、isEditable、DefaultChannelIsDetachable 和 DefaultChannelsIsRemovable 特性變更為 false。
-
選取 [儲存] 儲存新值。
從單一通道移除按鈕
-
針對要移除按鈕的通道，在包含通道的容器中，將適當的特性新增至 Collection 標記。有關想要移除的按鈕的資訊，請參閱「移除按鈕」。在以下分為兩欄的表格中，第一欄列出按鈕，第二欄則列出隱藏按鈕的特性
此表格中的按鈕順序，對應至按鈕在通道中顯示的順序，從左到右為：[最小化]、[最大化]、[說明]、[編輯]、[分離] 和 [移除]。
按鈕
隱藏按鈕的特性
最小化
<Collection name="channelsIsMinimizable">
<Boolean name="channelname" value="false"/>
</Collection>
最大化
<Collection name="channelsIsMaximizable">
<Boolean name="channelname" value="false"/>
</Collection>
分離
<Collection name="channelsIsDetachable">
<Boolean name="channelname" value="false"/>
</Collection>
移除
<Collection name="channelsIsRemovable">
<Boolean name="channelname" value="false"/>
</Collection>
-
針對要移除按鈕的通道，請在控制容器中將適當的特性新增至 Collection 標記。
例如，使用下列 XML，可以在 JSP 表格容器 MyFrontPageTabPanelContainer (其容器為 JSPTabContainer) 中，隱藏範例 JSP 通道的 [移除] 按鈕。
<Container name="MyFrontPageFramePanelContainer" provider="JSPTableContainerProvider"> <Properties> ... <Collection name="channelsIsRemovable"> <Boolean name="SampleJSP” value="false”/> </Collection> </Properties> ...
-
使用 psadmin 子指令或從 Portal Server 管理主控台，將顯示設定檔載入 LDAP 中。
從 Portal Server 管理主控台自單一通道移除按鈕
-
登入 Portal Server 管理主控台，然後選取定義容器的使用者、組織或角色。
-
選取 [管理通道與容器]，然後按一下包含的容器。
-
如下所示變更 channelsIsMinimizable、channelsIsMaximizable、channelsIsDetachable 和 channelsIsRemovable 特性：
從通道移除標題列
從通道移除標題列
-
將下列內容新增至通道所在的表格容器顯示設定檔。
<Collection name="channelsHasFrame"> <Boolean name="channelname" value="false"/> </Collection>
-
使用 psadmin 子指令或從 Portal Server 管理主控台，將顯示設定檔載入 LDAP 中。
變更通道邊框寬度和/或顏色
您可以變更 GlobalThemes 集合的 borderWidth 特性和 borderColor 特性。這會分別變更主題的通道邊框寬度和顏色。然後，使用者可從 [主題] 頁面選取主題。
變更容器中所有通道的邊框寬度和顏色
-
登入 Portal Server 管理主控台，然後選取 [入口網站]、[ portal-URI]、[企業範例] (從 [選取 DN] 下拉式功能表選取) 和 [管理通道與容器]。
-
在 [檢視] 下拉式功能表中，選取 [DP XML 樹狀結構]。
-
選取 [DP_Root]、[GlobalThemes] 和 [SunTheme]。
-
修改 borderWidth 和 borderColor 設定並儲存。
管理通道程式庫
建立新程式庫通道
-
在 Portal Server 管理主控台中，存取要建立或修改之桌面的 [桌面設計配置] 頁面。
要存取 [桌面設計配置] 頁面，請參閱「在 Portal Server 管理主控台中存取桌面設計工具」的程序。
-
從 [通道程式庫] 工具列中，選取 [新增程式庫通道] 圖示。
用於新增通道至程式庫的快顯式頁面會出現。
-
指定這是通道還是程式庫通道。
當程式庫通道建立後，其名稱會加上 __Library__ 的前綴，且會儲存在全域顯示設定檔中。開頭為 _ 的通道無法從 Portal Server 管理主控台 [管理容器與通道] 連結來管理。使用管理主控台中的 [桌面設計工具] 連結，變更程式庫通道的特性。
-
指定通道類型。
通道可以是以提供者為基礎、具有 JSR 168 相容性的 Portlet，或 WSRP 遠端 Portlet 通道。
-
指定下列項目的名稱：
- 提供者
-
針對以提供者為基礎的通道。
- Portlet
-
針對相容 JSR 168 或 JSR 286 的 Portlet。
- 產生器
-
針對 WSRP 遠端 Portlet 通道。
-
指定通道的名稱。
通道名稱必須是唯一的。
-
檢閱您的設定，並按一下 [完成]。
結果頁面會顯示嘗試為通道程式庫建立新通道的結果。
編輯程式庫通道特性
-
在 Portal Server 管理主控台中，存取要建立或修改之桌面的 [桌面設計配置] 頁面。
要存取 [桌面設計配置] 頁面，請參閱「在 Portal Server 管理主控台中存取桌面設計工具」的程序。
-
從 [通道程式庫] 中的通道清單選取通道。
-
從 [通道程式庫] 工具列選取 [編輯] 圖示。
用於編輯通道特性的快顯式頁面會出現。
-
在頁面中進行變更，然後按一下 [關閉]。
通道特性已修改。
刪除程式庫通道
-
在 Portal Server 管理主控台中，存取要建立或修改之桌面的 [桌面設計配置] 頁面。
要存取 [桌面設計配置] 頁面，請參閱「在 Portal Server 管理主控台中存取桌面設計工具」的程序。
-
從 [通道程式庫] 中的通道清單選取通道。
-
從 [通道程式庫] 工具列選取 [刪除] 圖示。
請求確認刪除的快顯式視窗會出現。
-
按一下 [確定]。
通道會從 [通道程式庫] 清單中刪除。
部署 Portlet
-
在 Portal Server 管理主控台中，存取要建立或修改之桌面的 [桌面設計配置] 頁面。
要存取 [桌面設計配置] 頁面，請參閱「在 Portal Server 管理主控台中存取桌面設計工具」的程序。
-
從 [通道程式庫] 工具列選取 [部署 Portlet] 圖示。
用於部署 Portlet 的快顯式頁面會出現。
-
分別從 [選取入口網站] 和 [選取 DN] 下拉式清單中，選取要部署 Portlet 的入口網站和 DN。
-
選取適當的單選按鈕，並指定 Portlet WAR 和 Portlet 部署資訊的路徑。
您可指定位於本地機器或 Portal Server 主機的 WAR 檔案。Portlet WAR 檔案是必要的。您可指定位於本地機器或 Portal Server 主機的角色和使用者檔案。角色對映檔案和使用者對映檔案是選擇性的。
-
確認資訊後按一下 [完成]。
結果頁面會顯示嘗試部署 Portlet 的結果。
- © 2010, Oracle Corporation and/or its affiliates