管理预订服务

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

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

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

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

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

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

管理预订服务

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

根级别

在“根”级别管理“预订”服务可设置系统范围内的每种类型（即类别、讨论和已保存的搜索）的默认最大预订数。图 11-1 包含在根级别管理“预订”服务的界面。有关在根级别定义“预订”服务的信息，请参阅“在根级别定义预订服务”。

组织级别

在“组织”级别管理“预订”服务可改写系统范围内每种类型（即类别、讨论和已保存的搜索）的默认最大预订数。图 11-2 包含在组织级别管理“预订”服务时所使用的界面。有关在组织级别定义“预订”服务的信息，请参阅“在组织级别定义预订服务”。

组织用户级别

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

更新用户预订

删除用户预订

图 11-3 包含在用户级别管理“预订”服务时使用的界面。有关管理用户的“预订”服务的信息，请参阅“管理用户的预订服务”。

在根级别定义预订服务

登录到 Sun ONE Identity Server 管理控制台，并选择“服务配置”标签。

从左侧窗格的“Portal Service 配置”菜单中选择“预订”服务。

修改以下各项的默认值（请参阅图 11-1）：

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

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

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

选择：

选择“保存”以保存值。

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

在组织级别定义预订服务

登录到 Sun ONE Identity Server 管理控制台，并从“查看”下拉菜单中为组织选择“服务”。

从左侧窗格的“Portal Service 配置”菜单中选择“预订”服务。

修改以下各项的默认值（请参阅图 11-2）：

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

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

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

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

选择：

选择“保存”以保存值。

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

删除。

管理用户的预订服务

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

选择用户。

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

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

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

编辑预订定义（请参阅图 11-3）。

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

类别预订：

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

其中：


标签	是指为已编辑预订提供的逻辑引用，必须为字符串。此字段是必填字段。
目标类别	必须是 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 = 自去年

使用预订频道

“预订”频道（如图 11-4 所示）按类型显示预订，这些类型可以是类别预订、讨论预订和已保存搜索。对于每种类型的预订，将显示下列内容：

预订标签

可链接到预订详细信息的一个链接，此预订详细信息中会显示该特殊预订的命中数

图 11-4 桌面上的示例预订频道

“桌面”上的示例预订频道的屏幕快照。

最终用户可以通过预订频道“编辑”按钮更新所有预订并且可以取消预订（请参阅图 11-5）。用于匹配预订的最终用户提示在“预订”频道中被分组。根据预订频道的刷新时间生成提示。管理员可以为频道（该频道实际显示某个时间段的内容缓存中的内容）设置 refreshTime 属性。当最终用户试图在少于“刷新时间”参数的时间内多次刷新预订频道的内容时，将从缓存中读取内容，而不是通过实际数据生成内容。可以用秒来指定 refreshTime 频道属性值。

文档被按照已预订的类别分类，并且与范围和时间条件相符。

文档是已预订讨论的注释，并且与范围和时间条件相符。

文档与已保存的基本或高级搜索条件和时间条件相符。

图 11-5 桌面上的示例预订频道编辑页

“桌面”上的示例预订频道编辑页的屏幕快照。

预订类别

登录到示例“桌面”。

可以通过下列方法预订类别：

浏览类别 - 包括一个“预订”链接

搜索显示类别的结果 - 包括一个“预订”链接

类别内的搜索结果 - 包括一个“预订类别”链接（如图 11-6 所示）

选择要预订的类别旁的预订链接。

显示说明预订信息的页面。

指定以下各项：

预订名 - 类别的名称

目标类别 - 类别的名称

搜索范围 - 一个查询字符串，类似于搜索文本字段

自 - 您希望预订指定类别的时间数。该时间可以是永远、自上周、自上月、自上 6 个月、自去年

选择“完成”按钮。

类别即被添至您的预订列表中。

图 11-6 预订类别示例页

预订类别的页面的屏幕快照。

预订讨论

登录到示例“桌面”。

可以通过查看讨论链接（包括一个“预订”链接）来预订讨论。

为要预订的讨论选择预订链接。

显示说明预订信息的页面。

指定以下各项：

预订名 - 类别的名称

目标类别 - 类别的名称

搜索范围 - 一个查询字符串，类似于搜索文本字段

自 - 您希望指定类别被预订的时间数。该时间可以是永远、自上周、自上月、自上 6 个月、自去年。

等级 - 阈值等级，该等级以上的预订才有效

选择“完成”按钮。

您现在即预订了讨论。

保存搜索

登录到示例“桌面”。

访问搜索标签并搜索文档。

显示搜索结果页面。

选择结果列表顶部的预订链接（如图 11-7 所示）。

显示说明预订信息的页面。

指定以下各项：

标签 - 保存搜索标签

搜索范围 - 一个查询字符串，类似于搜索文本字段

自 - 您希望保存指定搜索结果的时间数。该时间可以是永远、自上周、自上月、自上 6 个月、自去年。

选择“完成”按钮。

您的搜索结果即被保存。

图 11-7 预订搜索结果的示例页

示例搜索结果

讨论

讨论概述

DiscussionProvider

管理和使用频道

讨论概述

讨论与主题和特定文档联系在一起。它是人们增添和谈论现有文档或自己创建文档的一种有力武器。它还为人们共享与特定文档或新主题有关的信息提供了一条便捷途径。

Sun ONE Portal Server 软件的讨论功能包括讨论线程、基于文档或新主题开始讨论、搜索讨论以及将讨论分级。默认情况下，在示例门户上为匿名用户提供了“讨论”频道。但是，匿名用户不能预订讨论或编辑“讨论”频道。

DiscussionLite 频道和“讨论”频道都建立在 DiscussionProvider 基础之上。与搜索频道 JSP 类似，它们也具有查询部分、显示部分，并且也使用桌面主题。

DiscussionProvider

DiscussionProvider 是使用“桌面”主题的 JSP 提供者。它使用搜索标记库和 API，从后端搜索服务检索数据。讨论和注释被作为不同的“资源描述符”(RD) 存储在讨论数据库中。DiscussionProvider 支持以下各项：

一个完整视图（通过“讨论”频道）和一个缩略视图（通过 DiscussionLite 频道），这两种视图：

通过讨论频道启动新讨论。

为现有讨论发布回复。

通过搜索频道启动一个基于网络文档的新讨论。

讨论列表：

该列表检索按上次修改日期排序的主发布内容。

该列表带有页码，从而使用户可访问较早的讨论。

一个讨论视图，该视图显示每个讨论子树。主项目以详细方式显示，并在主项目下显示子树。查看视图包括：

页面上的几个过滤器。可以基于过滤器显示文档，比如文档等级（无关、常规、有趣、重要和必读等）过滤器。

显示首选项可以设置为以线程方式或者平面显示。

扩展阈值可以用来控制子树中显示的项目。用户可以选择仅展开高等级的文档，或选择全部展开、全部折叠。默认值为全部折叠。“全部展开”将展开所有已过滤的注释。它还显示对讨论的说明，提供将讨论分级的菜单，并允许用户发布回复。

支持在讨论内部进行搜索。

对讨论进行注释和分级。例如，用户可以：

在现有讨论上添加一个注释。

对所有讨论和注释进行分级。不过，并不立即显示用户确定的级别。等级计算以任意注释等级逐渐升高的计算法则为基础。例如，一个注释必须三次被确定为重要等级，才能被标记为重要。

搜索所有讨论（请参阅图 11-8），并在某个讨论的内部进行搜索。这些功能被发送到搜索提供者。用户也可以按“高级搜索”中的等级进行搜索。

图 11-8 桌面上允许搜索所有讨论的搜索页

“桌面”上允许搜索全部讨论的搜索页的屏幕快照。

预订。已验证的用户可以通过选择预订链接来选择预订特殊讨论。该请求由 SubscriptionProvider 处理。如果不需要该功能，则可以禁用 displaySubscription 属性（请参阅代码示例 11-1）。默认情况下，该值为 true。

DiscussionProvider 的显示配置文件 XML 片段

代码示例 11-1 显示了显示配置文件中 DiscussionProvider 提供者的 XML 片段。

代码示例 11-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 ONE 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 频道（如图 11-9 所示）显示了最上面的二十个讨论标题（这些标题可以重新配置）和日期。按照创建日期（上次修改日期）将讨论排序，并先显示最新的讨论。DiscussionLite 频道视图中有一些链接，可用来查看每个讨论、查看以“讨论频道”为目标的所有讨论，并可启动一个讨论。默认情况下，在单个容器中显示频道，而且所有链接都出自 JSPDynamicSingleContainer。

可通过管理控制台配置属性（参见图 11-10）。默认情况下，该频道没有用户可编辑的属性。

图 11-10 Sun One Identity Server 管理控制台上的示例 DiscussionLite 频道编辑页

各讨论存储在显示配置文件中的 dbname 属性指定的讨论数据库中。可以在显示配置文件中配置搜索服务器主机（searchServer 属性）、数据库名（dbname 属性）和要显示的讨论数（viewHits 属性）（参见代码示例 11-2）。

代码示例 11-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	显示异常和错误消息。

显示按降序排列的前八个讨论的详细说明。可通过频道编辑页重新配置。

包含页码，以便用户可查看所有讨论。

支持搜索。搜索返回讨论和注释结果。

图 11-11 桌面上的示例讨论完整视图

桌面上示例讨论频道的屏幕快照。

图 11-12 Sun One Identity Server 管理控制台上的示例讨论频道编辑页

各讨论存储在显示配置文件中的 dbname 属性指定的讨论数据库中。可以在显示配置文件中配置搜索服务器主机（searchServer 属性）、数据库名（dbname 属性）和要显示的讨论数（viewHits 属性）（参见代码示例 11-3）。

代码示例 11-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 ONE Identity Server 管理控制台中的“桌面”显示配置文件和搜索服务之间。提供者的特定信息存储在显示配置文件中。讨论文档以及与管理相关的数据库必须在搜索服务中执行。

讨论存储在讨论数据库中。讨论数据库需要一个用于讨论和注释的特定模式。在 schema.rdm 文件中已经为该功能添加了新的模式字段。搜索 CLI rdmgr 可以用于数据库管理和调试。例如，要转储所有注释，可键入：

示例 DiscussionProvider 频道被配置为使用默认的搜索服务器。讨论数据库和频道中一些被导入的示例讨论准备就绪，可以使用。

通过 DiscussionProvider 创建频道

discussions.soif	讨论数据库中加载的一个示例 SOIF 文件。
dp-org.xml	包含讨论频道显示配置文件 XML 片段。
dp-providers.xml	包含讨论提供者显示配置文件 XML 片段。
dp-anon.xml	包含 authlessanonymous 用户的 XML 片段，在示例门户安装期间加载。

登录到 Sun ONE Identity Server 管理控制台，并从“查看”下拉菜单中选择“服务”。

服务列表显示在左侧框架中。

选择“桌面”和“频道和容器管理”。

注意，“频道和容器管理”链接在右侧框架中提供。

选择“频道”下的“添加”按钮。

显示一个页面，用于指定要添加的频道的类型。

在“频道名称”文本框中为该频道指定一个名称，并从“提供者”下拉菜单中选择 DiscussionProvider。

选择“创建”。

此操作会创建一个基于指定提供者的频道。单击“取消”按钮可返回到“频道和容器管理”页，而不创建任何新频道。

选择“频道”表中新创建的频道旁的“编辑”链接。

显示用于编辑频道默认值的页面。

编辑属性并选择“保存”按钮，以保存修改的值。

下面的显示配置文件属性专用于此提供者：


searchServer	搜索服务器的路径。默认路径为 portal/portal/search。
dbname	任意有效的数据库。
viewHits	要显示的讨论数。
defaultDiscussionDisplay	该属性值可设置为线程或者平面，以允许注释子树以线程或平面方式显示。
defaultFilter	用于搜索和显示讨论的过滤器以及子树的控制显示。可以等级为基础，比如无关、常规、有趣、重要和必读等。默认情况下，其值是无关，因此将显示所有等级为无关或者在无关之上的注释。“必读”过滤器将突出显示高等级的注释。
defaultExpansionThreshold	可以设置为全部展开或全部折叠。默认情况下，其值被设置为全部折叠。如果设置为全部展开，它将展开全部已过滤的注释、显示说明、分级菜单，并允许用户通过链接来发布回复。
anonymousAuthor
viewDiscussionWindow
displaySearch
showDescription	对于“讨论”频道，此属性为可配置项。
ratingText	默认情况下，可将讨论分级为无关、常规、有趣、重要或者必读。

第 11 章
管理预订服务

概述