第 13 章管理訂閱服務

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

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

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

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

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

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

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

管理訂閱服務

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

根層級

組織層級

組織使用者層級

根層級

在「根」層級管理「訂閱」服務將會設定全系統每種類型的最大預設訂閱數 (也就是，對於種類、討論與已儲存的搜尋)。請參閱若要在「根」層級定義「訂閱」服務以取得在根層級定義「訂閱」服務的相關資訊。

組織層級

在「組織」層級管理「訂閱」服務，會覆寫全系統每種類型的最大預設訂閱數 (也就是，對於種類、討論與已儲存的搜尋)。請參閱若要在「組織」層級定義「訂閱」服務以取得在組織層級定義「訂閱」服務的相關資訊。

組織使用者層級

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

更新使用者訂閱

刪除使用者訂閱

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

登入至 Sun Java System Identity Server 管理主控台並選取「服務配置」標籤。

在左窗格「入口網站服務配置」功能表選取「訂閱」服務。

修改以下預設值：

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

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

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

選擇：

儲存以儲存您的值。

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

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

登入 Sun Java System Identity Server 管理主控台，並在組織的「檢視」下拉功能表選取「服務」。

在左窗格「入口網站服務配置」功能表選取「訂閱」服務。

從功能表列瀏覽至「組織」底下的「啟動效能評測器」。

選取啟動自動器的時間 (時/分) 及日期。

從功能表列瀏覽至「組織」底下的「停止效能評測器」。

選取停止自動器的時間 (時/分) 及日期。

修改以下預設值：

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

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

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

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

選擇：

儲存以儲存您的值。

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

刪除。

若要管理使用者訂閱服務

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

選取使用者。

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

在「檢視」下拉功能表中選取「訂閱」。

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

編輯訂閱定義。

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

種類訂閱有：

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。類似於搜尋通道 JSP，他們有查詢部分、顯示部分與使用「桌面」主題。

DiscussionProvider

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

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

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

將回覆貼至現有討論。

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

一個「討論清單」可以：

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

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

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

頁面上的數個過濾器。可以根據過濾器顯示文件，例如文件評定 (無關的、一般的、有趣的、重要的以及必須閱讀的)。

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

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

支援討論之中的搜尋。

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

在現有討論上新增意見。

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

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

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

DiscussionProvider 的顯示設定檔 XML 區段

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

程式碼範例 13-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 屬性) 可以在顯示設定檔中被配置 (請參閱程式碼範例 13-2)。

程式碼範例 13-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 屬性) 可以在顯示設定檔中被配置 (請參閱程式碼範例 13-3)。

程式碼範例 13-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 通道

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

討論會儲存於討論資料庫中。討論資料庫會預期一個討論與意見的特定模式。已為 schema.rdm 檔案中的這個功能新增新模式欄位。搜尋 CLI rdmgr 可用於資料庫管理與除錯。例如，若要轉儲所有意見，請輸入：

配置範例 DiscussionProvider 通道以使用預設搜尋伺服器。某些範例討論將匯入於討論資料庫，且通道已就緒供使用。

若要在 DiscussionProvider 建立通道

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

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

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

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

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

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

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

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

選取 [建立]。

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

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

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

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

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


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