第 16 章管理订阅服务

用户可以使用“订阅”服务创建一个所需的、包含许多信息源的配置文件。在本版软件中，所支持的信息源包括类别、讨论和可搜索文档。用户每次访问“订阅”频道时，都会用最新信息更新配置文件。“订阅”频道会概括出与用户为分类文档或讨论所定义的每个配置文件条目相匹配的相关信息的项目数。

匹配和计算指定日期范围内的目标类别中新文档的数量。

匹配和计算指定日期范围内的某个讨论中新相关注释的数量。

根据已保存的搜索匹配和计算文档命中数

结果显示为一个链接，该链接显示了与配置文件条目相匹配的信息数量。该链接把用户重新定向至一个更详细的匹配视图本身。

在类别订阅中，链接将用户重新定向至搜索频道，在该搜索频道中，按照标准类别搜索结果格式汇总所需的特定文档。“订阅”频道起到了门的作用，将用户引导至更详细的视图。

配置程序功能在指定的相关内容发生更改时将提供电子邮件通知。配置程序可从 Access Manager 获得用户的详细订阅信息，从“搜索”服务取得结果，并向用户发送电子邮件通知。可安排配置程序使其于特定时间在组织级运行。

管理订阅服务

管理员可以启用或禁止订阅服务。可在以下级别管理“订阅”服务：

根级别

组织级别

组织用户级别

根级别

在根级别管理订阅服务可按类型（即针对类别、讨论和已保存的搜索）设置系统范围内的默认的最大订阅数。

在根级别定义订阅服务

登录到 Sun Java System Access Manager 管理控制台，并选择“服务配置”选项卡。

从左窗格的列表中选择“订阅”服务。

修改以下各项的默认值：

“类别”订阅最大数指定用户可以订阅的类别的最大数量。

“讨论”订阅最大数指定用户可以订阅的讨论的最大数量。

已保存搜索最大数指定可以保存的搜索的最大数量。

选择：

选择“保存”以保存值。

如果进行了修改，选择“重置”可重新设置值。

组织级别

在组织级别管理订阅服务将按类型（即针对类别、讨论和已保存的搜索）覆写系统范围内的默认的最大订阅数。

在组织级别定义订阅服务

登录到 Sun Java System Access Manager 管理控制台，然后从“查看”下拉菜单中为组织选择“服务”。

从左窗格的列表中选择“订阅”服务。

选择启动配置程序的时间（小时和分钟）和日期。

选择停止配置程序的时间（小时和分钟）和日期。

修改以下各项的默认值：

冲突解决级别可以被设置为“最高”、“较高”、“高”、“中”、“低”、“较低”和“最低”。

“类别”订阅最大数指定用户可以订阅的类别的最大数量。

“讨论”订阅最大数指定用户可以订阅的讨论的最大数量。

已保存搜索最大数指定可以保存的搜索的最大数量。

选择：

选择“保存”以保存值。

如果进行了修改，选择“重置”可重新设置值。

“删除”。

组织用户级别

在“组织用户”级别管理“订阅”服务可编辑用户的“订阅”服务设置。管理员可以维护用户的服务数据，如：

更新用户订阅

删除用户订阅

管理用户的订阅服务

登录到管理控制台，并从“查看”下拉菜单中为组织选择“用户”。

选择用户。

用户信息在右侧窗格中显示。

从“查看”下拉菜单中选择“订阅”。

将显示一个用来编辑用户订阅的页面。

编辑订阅定义

为每种订阅类型添加或删除订阅。各类订阅的格式如下：

类别订阅：

标签|目标类别|范围|已用时间

其中：


标签	是指为已编辑订阅提供的逻辑引用，必须为字符串。此字段是必填字段。
目标类别	必须是 ABC:DEF:GHI 格式的字符串
范围	指搜索查询的范围，必须为有效的搜索字符串（包括搜索运算符）格式。
已用时间	必须为下列数字之一： 0 = 永远 7 = 自上周 30 = 自上月 180 = 自上 6 个月 365 = 自去年

讨论订阅：

标签|目标讨论 RD 的 URL|范围|已用时间|最小级别

其中：


标签	是指为已编辑订阅提供的逻辑引用，必须为字符串。此字段是必填字段。
目标讨论RD的URL	必须是与“讨论”的 URL 相匹配的字符串格式。使用订阅频道编辑讨论的用户不能对其进行编辑。
范围	指搜索查询的范围，必须为有效的搜索字符串（包括搜索运算符）格式。
已用时间	必须为下列数字之一： 0 = 永远 7 = 自上周 30 = 自上月 180 = 自上 6 个月 365 = 自去年
最小级别	是指基于最小级别的过滤器。

已保存搜索：

标签|目标类别|范围|已用时间

其中：


标签	是指为已编辑订阅提供的逻辑引用，必须为字符串。此字段是必填字段。
目标类别	必须是 ABC:DEF:GHI 格式的字符串
范围	指搜索查询的范围，必须为有效的搜索字符串（包括搜索运算符）格式。
已用时间	必须为下列数字之一： 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）。默认情况下，该值为 true。

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 频道显示了最上面的二十个讨论标题（这些标题可以重新配置）和日期。按照创建日期（上次修改日期）将讨论排序，并先显示最新的讨论。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	默认情况下，可将讨论分级为无关、常规、有趣、重要或者必读。