第 16 章管理訂閱服務

「訂閱」服務讓使用者建立有興趣的設定檔以涵蓋許多資訊來源。在此版本中，支援的資訊來源包括種類、討論與可搜尋的文件。每當使用者存取「訂閱」通道時，最新資訊都會更新設定檔。「訂閱」通道會摘要符合使用者為分類文件或討論定義的每個設定檔項目的相關資訊項目數。

在指定日數範圍內，符合並計數目標種類的新文件數目

在指定日數範圍內，符合並計數討論中的新相關評論數目

符合並計數對於已儲存搜尋的文件符合項目數目

結果會顯示為顯示符合設定檔項目資訊數目的連結。這個連結會重新導向使用者至更符合其本身的詳細檢視。

種類訂閱情況中，連結會重新導向使用者至特定感興趣的文件的搜尋通道，且會摘要於標準種類搜尋結果格式。「訂閱」通道會作為至使用者更詳細檢視的入口。

效能評測器功能會在指定的感興趣內容變更時，以電子郵件發出通知。效能評測器會從 Access Manager 取得使用者的訂閱詳細資訊、從「搜尋」服務擷取結果並將電子郵件通知傳送給使用者。效能評測器可進行排程，以便在組織層級中於指定的時間執行。

管理訂閱服務

管理員可以啟用或停用訂閱服務。「訂閱」服務可以管理於：

根層級

組織層級

組織使用者層級

根層級

在「根」層級管理「訂閱」服務將會設定全系統每種類型的最大預設訂閱數 (也就是，對於種類、討論與已儲存的搜尋)。

若要在「根」層級定義「訂閱」服務

登入 Sun Java System Access Manager 管理主控台並選取 [服務配置] 標籤。

從左窗格中的清單選取 [訂閱] 服務。

修改以下預設值：

種類訂閱最大數指定使用者可以訂閱的最大種類數。

討論訂閱最大數指定使用者可以訂閱的最大討論數。

最大已儲存搜尋數指定可以被儲存的搜尋最大數。

選擇：

儲存以儲存您的值。

重設將其重設 (若您修改值的話)。

組織層級

在「組織」層級管理「訂閱」服務，會覆寫全系統每種類型 (也就是種類、討論與已儲存的搜尋) 的最大預設訂閱數。

若要在「組織」層級定義「訂閱」服務

登入 Sun Java System Access Manager 管理主控台，並在組織的 [檢視] 下拉功能表選取 [服務]。

從左窗格中的清單選取 [訂閱] 服務。

選取啟動效能評測器的時間 (時/分) 及日期。

選取停止效能評測器的時間 (時/分) 及日期。

修改以下預設值：

衝突排解層級可以設定為最高、較高、中等、低、較低與最低。

種類訂閱最大數指定使用者可以訂閱的最大種類數。

討論訂閱最大數指定使用者可以訂閱的最大討論數。

最大已儲存搜尋數指定可以被儲存的搜尋最大數。

選擇：

儲存以儲存您的值。

重設將其重設 (若您修改值的話)。

刪除。

組織使用者層級

在「組織使用者」管理「訂閱」服務可編輯使用者的「訂閱」服務設定。管理員可以維護使用者的服務資料，例如：

更新使用者訂閱

刪除使用者訂閱

若要管理使用者訂閱服務

登入管理主控台並在組織的 [檢視] 下拉功能表選取 [使用者]。

選取使用者。

使用者資訊會顯示於右窗格上。

在 [檢視] 下拉功能表中選取 [訂閱]。

隨即顯示編輯使用者訂閱的頁面。

編輯訂閱定義

對於每種類型的訂閱，新增或移除訂閱。格式：

種類訂閱有：

label | target category | scope | lapsed time

其中：


label	請參閱給定至已編輯訂閱的邏輯參考，且其必須為字串。這是必要的欄位。
target category	必須為 ABC:DEF:GHI 字串格式
scope	請參閱搜尋查詢，且其必須為有效的搜尋字串的字串格式，包括搜尋運算子。
lapsed time	必須為下列數字之一： 0=永久 7=從上週 30=從上月 180=從過去 6 個月 365=從去年

討論訂閱為：

label | target discussion RD’s URL | scope | lapsed time | minimum rating

其中：


label	請參閱給定至已編輯訂閱的邏輯參考，且其必須為字串。這是必要的欄位。
target discussion RD’s URL	必須為符合「討論的 URL」字串格式。使用者無法使用編輯討論的訂閱通道來編輯這個格式。
scope	請參閱搜尋查詢，且其必須為有效的搜尋字串的字串格式，包括搜尋運算子。
lapsed time	必須為下列數字之一： 0=永久 7=從上週 30=從上月 180=從過去 6 個月 365=從去年
minimum rating	請參閱根據最小評定的篩選器。

已儲存的搜尋為：

label | target category | scope | lapsed time

其中：


label	請參閱給定至已編輯訂閱的邏輯參考，且其必須為字串。這是必要的欄位。
target category	必須為 ABC:DEF:GHI 字串格式
scope	請參閱搜尋查詢，且其必須為有效的搜尋字串的字串格式，包括搜尋運算子。
lapsed time	必須為下列數字之一： 0=永久 7=從上週 30=從上月 180=從過去 6 個月 365=從去年

使用訂閱通道

「訂閱」通道依類別顯示各訂閱，可以為種類訂閱、討論訂閱與已儲存的搜尋。每一種的訂閱都會顯示以下：

訂閱標籤

訂閱詳細資料的連結會顯示該特定訂閱的符合數目

一般使用者可以更新訂閱並使用訂閱通道 [編輯] 按鈕取消訂閱。一般使用者的符合訂閱警示在「訂閱」通道中進行編組。此警示是根據訂閱通道的重新整理時間所產生。

管理員可以設定通道的 refreshTime 特性，以定期實際描繪內容快取。當一般使用者在少於參數 refreshTime 指定的時間內嘗試多次重新整理訂閱通道內容時，則會從快取讀取內容而非由實際資料產生。refreshTime 通道特性值的單位是秒。

分類到訂閱的類別中並且符合範圍及時間準則。

訂閱討論中加入了符合範圍及時間準則的新意見。

以基礎或進階搜尋準則與時間準則儲存的符合項目。

若要訂閱類別

登入範例桌面。

您可以訂閱類別，經由：

瀏覽種類 — 這包含 [訂閱] 連結

顯示種類的搜尋結果 — 這包括 [訂閱] 連結

某個種類內的搜尋結果 — 這包括 [訂閱種類] 連結

在您要訂閱的種類旁選取訂閱連結。

隨即顯示指定訂閱資訊的頁面。

指定：

訂閱名稱 — 種類的名稱

目標種類 — 種類的名稱

搜尋範圍 — 查詢字串，類似於 [搜尋] 文字欄位

自從 — 您希望訂閱指定種類的時間。可以是永遠、自上個星期、自上個月、自過去 6 個月、自去年

選取 [完成] 按鈕。

種類已新增至您的訂閱清單。

若要訂閱討論

登入範例桌面。

您可以透過 [檢視討論] 連結訂閱討論。這包括 [訂閱] 連結。

選取您要訂閱的討論訂閱連結。

隨即顯示指定訂閱資訊的頁面。

指定：

訂閱名稱 — 種類的名稱

目標種類 — 種類的名稱

搜尋範圍 — 查詢字串，類似於 [搜尋] 文字欄位

自從 — 您希望訂閱指定種類的時間。可以是永遠、自上個星期、自上個月、自過去 6 個月、自去年。

評定 — 臨界值評定，超過此臨界值的訂閱為有效訂閱

選取 [完成] 按鈕。

現在正訂閱討論。

若要儲存搜尋

登入範例桌面。

存取 [搜尋] 標籤與文件的搜尋。

將顯示搜尋結果頁。

在結果清單頂端選取訂閱連結。

隨即顯示指定訂閱資訊的頁面。

指定：

標籤 — 儲存搜尋標籤

搜尋範圍—查詢字串，類似 [搜尋] 文字欄位

自從 — 您要儲存指定搜尋結果的時間。可以是永遠、自上個星期、自上個月、自過去 6 個月、自去年。

選取 [完成] 按鈕。

現在儲存您的搜尋結果。

討論

討論摘要

DiscussionProvider

管理與使用通道

討論摘要

討論會與主題與指定文件結合。這個功能可讓一般使用者新增或討論現有的文件，或建立自己的文件。它提供了分享指定文件或新主題相關資訊的方法。

Sun Java System Portal Server 軟體會討論的功能包括討論執行緒、啟動基於文件或新主題的討論，搜尋討論並評定討論。依預設，「討論」通道可在匿名使用者的範例入口網站中取得。然而，匿名使用者無法訂閱討論或編輯「討論」通道。

DiscussionLite 通道與「討論」通道的基礎為 DiscussionProvider。類似於搜尋通道的 JavaServer Pages™ (JSP™) 檔案，它們有一個查詢部分和一個顯示部分，並使用「桌面」主題。

DiscussionProvider

DiscussionProvider 是使用「桌面」主題的 JSP 提供者。其會使用搜尋標記程式庫與 API 從後端「搜尋」服務擷取資料。討論與評論會在討論資料庫中儲存為不同的「資源說明 (RD)」。DiscussionProvider 支援：

完整檢視 (經由「討論」通道) 與小型檢視 (經由 DiscussionLite 通道)：

從討論通道開始一個新討論。

將回覆貼至現有討論。

開始一個根據搜尋通道的 Web 文件新討論。

一個「討論清單」可以：

擷取根據最後修改日期排序的主要貼文。

具有頁碼以便使用者可以存取之前的討論。

顯示每個討論子樹狀圖的討論檢視。主要項目會詳細顯示且子樹狀圖會顯示於主項目之下。檢視討論包括：

頁面上的數個篩選器。可以根據篩選器顯示文件，例如文件評定 (「無關」、「無趣」、「有趣」、「重要」以及「必讀」)。

顯示喜好設定可以設定為執行緒或一般顯示。

展開的臨界值可以幫助控制子樹狀圖中的顯示項目。使用者可以選擇只展開高度評定的文件，或是全部展開或全部摺疊。預設值是全部摺疊。[全部展開] 會顯示所有篩選過的評論。它也會顯示討論的說明、提供評定討論的功能表並允許使用者張貼回覆。

支援討論之中的搜尋。

註釋與評定討論。例如，使用者可以：

在現有討論上新增意見。

評定討論及評論。然而使用者評定並不是立即可視。評定會根據演算法計算，如此一來對意見的評定才會逐步上升。舉例而言，一個意見必須要三次評定為「重要」才能標示為「重要」。

搜尋所有討論與在討論中搜尋。這些功能會路由至搜尋提供者。使用者也可以藉由「進階搜尋」中的評定來搜尋。

訂閱。已授權的使用者可以藉由選取訂閱連結選取訂閱特定討論。藉由 SubscriptionProvider 處理的請求。displaySubscription 特性 (請參閱程式碼範例 16-1) 可以被停用，若未要求此功能。依預設，值為真。

DiscussionProvider 的顯示設定檔 XML 區段

程式碼範例 16-1 顯示在顯示設定檔中的 DiscussionProvider 提供者 XML 區段。

程式碼範例 16-1
DiscussionProvider 提供者顯示設定檔 XML 區段


<Provider name="DiscussionProvider" class="com.sun.portal.providers.jsp.JSPProvider">
<Properties>
<String name="title" value="* Discussions Provider *"/>
<String name="description" value="* DESCRIPTION *"/>
<String name="refreshTime" value="0" advanced="true"/>
<String name="helpURL" value="en/desktop/discussions.htm" advanced="true"/>
<String name="fontFace1" value="Sans-serif"/>
<String name="productName" value="Sun Java System Portal Server"/>
<String name="contentPage" value="discussionContent.jsp"/>
<String name="editPage" value="discussionEdit.jsp"/>
<String name="processPage" value="discussionDoEdit.jsp"/>
<Boolean name="isEditable" value="true" advanced="true"/>
<String name="editType" value="edit_subset" advanced="true"/>
<Boolean name="showExceptions" value="false"/>
<Boolean name="showErrors" value="true"/>
<String name="width" value="thick"/>
<String name="column" value="2"/>
<String name="searchServer" value=""/>
<String name="dbname" value=""/>
<Integer name="viewHits" value="8"/>
<String name="defaultDiscussionDisplay" value="Threaded"/>
<String name="defaultFilter" value="Irrelevant"/>
<String name="defaultExpansionThreshold" value="Collapse all"/>
<Boolean name="viewDiscussionWindow" value="false"/>
<String name="anonymousAuthor" value="anonymous"/>
<Boolean name="displaySearch" value="true"/>
<Boolean name="showDescription" value="false"/>
<String name="ratingText" value="Irrelevant,Routine,Interesting,Important,Must Read"/>
</Properties>
</Provider>

管理 DiscussionProvider

通道編輯頁面 (此為使用者可配置)

DiscussionProvider 通道的管理主控台上的桌面通道與容器管理連結

搜尋服務

DiscussionLite 通道

DiscussionLite 通道顯示前 20 個討論標題 (可以被重新配置) 與日期。討論會依建立日期 (最後修改時間) 排序並且會先顯示最新的討論。DiscussionLite 通道檢視擁有至每個討論的連結，檢視將「討論通道」作為目標的所有討論並開始討論。依預設，通道會顯示在單一容器中，並且會在 JSPDynamicSingleContainer 中帶出所有連結。

可以從管理主控台配置特性。依預設，使用者無法編輯此通道可使用的特性。

顯示設定檔中指定於 dbname 特性且儲存於討論資料庫的討論。搜尋伺服器主機 (searchServer 特性)，資料庫名稱 (dbname 特性)，與待顯示的討論數 (viewHits 特性) 可以在顯示設定檔中被配置 (請參閱程式碼範例 16-2)。

程式碼範例 16-2 DiscussionLiteProvider 通道顯示設定檔 XML 區段


<Channel name="DiscussionLite" provider="DiscussionProvider">
<Properties>
<String name="title" value="Recent Discussions"/>
<String name="description" value="This is a DiscussionLite provider example"/>
<String name="contentPage" value="discussionLiteContent.jsp"/>
<String name="editPage" value=""/>
<String name="processPage" value=""/>
<String name="width" value="thin"/>
<String name="searchServer" value=""/>
<String name="db" value="discussion"/>
<Integer name="viewHits" value="20"/>
</Properties>
</Channel>

討論頻道

discussionLiteContent.jsp	JSP 內容頁面。
query.jsp	設定與執行搜尋查詢。
display.jsp	顯示結果。
error.jsp	顯示例外與錯誤訊息。

顯示以遞減順序儲存的前八個討論的詳細說明。可以經由通道編輯頁面重新配置。

包括頁碼以便使用者看到全部的討論。

支援搜尋。搜尋會傳回討論與意見結果。

顯示設定檔中指定於 dbname 特性且儲存於討論資料庫的討論。搜尋伺服器主機 (searchServer 特性)，資料庫名稱 (dbname 特性)，與待顯示的討論數 (viewHits 特性) 可以在顯示設定檔中被配置 (請參閱程式碼範例 16-3)。

程式碼範例 16-3 討論通道顯示設定檔 XML 區段


<Channel name="Discussions" provider="DiscussionProvider">
<Properties>
<String name="title" value="Discussions"/>
<String name="description" value="This is a Discussion provider example"/>
<String name="searchServer" value=""/>
<String name="dbname" value="discussions"/>
<Integer name="viewHits" value="8"/>
</Properties>
</Channel>


discussionContent.jsp	JSP 內容頁面
discussionEdit.jsp	編輯頁面
discussionDoEdit.jsp	程序編輯頁面
declare.jsp
portal.jsp	擷取顯示設定檔資料
fullDiscussion.jsp	處理完整檢視展示
fullDiscussionDisplay.jsp	所有討論頁面的使用者介面
searchUI.jsp	顯示於所有討論頁面上的搜尋表單
viewDiscussion.jsp	檢視討論
viewDiscussionBar.jsp	檢視討論頁面上含有所有篩選器的水平居中列
viewDiscussionDisplay.jsp	討論頁面的使用者介面
viewDiscussionHeader.jsp	檢視討論頁面上的標題意見
viewDiscussionNavigation.jsp	檢視討論頁面上顯示於標題之上與之下的瀏覽列
feedback.jsp	提供意見、回饋與評定功能
feedbackDisplay.jsp	顯示回饋
feedbackForm.jsp	提供回饋表單
feedbackProcess.jsp	處理回饋
error.jsp	顯示例外與錯誤訊息
query.jsp	格式與執行搜尋查詢
pageFooter.jsp	提供頁碼

管理與使用通道

管理 DiscussionProvider 通道

DiscussionProvider 通道的管理分散在 Sun Java System Access Manager 管理主控台的「桌面」顯示設定檔與「搜尋」服務當中。提供者特定資訊會儲存於顯示設定檔。與管理相關的討論文件與資料庫必須完成於「搜尋」服務中。

討論會儲存於討論資料庫中。討論資料庫會預期一個討論與評論的特定模式。schema.rdm 檔案中已為該功能加入了新的模式欄位。使用搜尋指令 rdmgr 管理資料庫並為資料庫除錯。例如，若要轉儲所有評論，請輸入：

配置範例 DiscussionProvider 通道以使用預設搜尋伺服器。某些匯入於討論資料庫和通道的範例討論已準備好，可以使用。

範例位於 PortalServer-base/SUNWps/samples/discussions/ 目錄中。他們是：

您可以控制一般使用者對討論的存取權限，以讓討論的狀態成為唯讀或完全隱藏。

若要在 DiscussionProvider 建立通道

discussions.soif	範例 SOIF 檔案會載入於討論資料庫。
dp-org.xml	包含討論通道顯示設定檔 XML 區段。
dp-providers.xml	包含討論提供者顯示設定檔 XML 區段。
dp-anon.xml	包含 authlessanonymous 使用者 XML 區段，於範例入口網站安裝時間載入。

登入 Sun Java System Access Manager 管理主控台並在 [檢視] 下拉功能表選取 [服務]。

服務清單會顯示於左框架中。

選取 [桌面]、[通道] 與 [容器管理]。

請注意，可以在右框架中找到 [管理通道與容器] 連結。

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

隨即顯示指定欲新增通道類型的頁面。

在 [通道名稱] 文字方塊中指定通道名稱，並在 [提供者] 下拉功能表中選取 DiscussionProvider。

按一下 [確定]。

這個動作會建立根據特定提供者的通道。[通道] 按鈕會將您傳回 [通道] 與 [容器管理] 頁面，無需建立任何新通道。

選取 [通道] 表格中新建立通道旁的 [編輯] 連結。

隨即顯示編輯通道預設值的頁面。

編輯特性並選取 [儲存] 按鈕以儲存已修改的值。

下列顯示設定特性特定於提供者：


searchServer	至搜尋伺服器的路徑。依預設為 portal/search。
dbname	任何有效的資料庫。
viewHits	欲顯示的討論數。
defaultDiscussionDisplay	這可設定為一般或執行緒，以允許意見子樹狀圖被顯示為一般或執行緒。
defaultFilter	搜尋篩選器、顯示討論並控制子樹狀圖顯示。可以「無關」、「無趣」、「有趣」、「重要」以及「必讀」等評定為基礎。依預設，其值為「無關」；故顯示所有評定為「無關」及以上的評論。「必讀」篩選器將反白顯示高度評定的評論。
defaultExpansionThreshold	這個可以設定為全部展開或全部摺疊。依預設，其值設定為全部摺疊。若設為 [全部展開]，會顯示所有篩選過的評論、顯示說明、評定功能表並允許使用者經由連結張貼回覆。
anonymousAuthor
viewDiscussionWindow
displaySearch
showDescription	對於「討論」通道，這為可配置。
ratingText	依預設，討論評定為「無關」、「無趣」、「有趣」、「重要」以及「必讀」。