Sun Java System Content Delivery Server 集成和配置指南

此 Sun Java System Content Delivery Server 版本为所有 Content Delivery Server 门户提供了扩展查找功能。其中包含以下功能：指定结果中默认显示的字段以及默认查找的字段。可以在默认设置中包含定制字段。

本章包含以下主题：

• 配置默认结果字段
• 配置查找引擎

有关查找功能的概述，请参见《Sun Java System Content Delivery Server 5.1 参考手册》。有关重新生成查找索引的信息，请参见《Sun Java System Content Delivery Server 5.1 系统管理指南》。

---

11.1 配置默认结果字段

以下属性定义了查找结果中显示的字段集合：

• keyword.search.results - 查找查询仅包含关键字或指定仅查找此列表中的字段时显示的字段。这些字段也是在按类别或状态浏览时显示的字段，因此，该值不应为 Null。
• field_query.search.results - 查找查询指定在默认关键字查找结果中不包含的一个或多个查找字段时显示的字段。除了为此属性指定的字段以外，还会显示查询中包含的查找和排序字段。
• user_defined.search.results - 查找查询指定在结果中包含一个或多个字段名称时显示的字段。除了为此属性指定的字段以外，还会显示查询中包含的结果字段。如果查询指定了要查找的字段或排序所依据的字段，则也会将查找字段或排序字段包含在结果中。

要为属性指定多个字段，请用逗号 (,) 分隔这些值。这些字段将按照指定字段名称时的顺序进行显示。查询中包含的字段名称将添加到为该属性指定的字段后面。要能够从查找结果中链接到内容详细资料，请在结果中包含标题或简短描述。

请注意，指定大量字段可能会降低性能。另外，如果结果中包含很多字段，则在查看查找结果时可能需要进行水平滚动浏览。

以下几节列出了包含这些属性和有效值的文件。

11.1.1 Catalog Manager 管理控制台

Catalog Manager 管理控制台属性是在 $CDS_HOME/deployment/deployment-name/conf/AdminConsole.properties 文件中设置的。除了 11.1 配置默认结果字段中介绍的属性以外，该文件中还设置了以下属性，以指定在 Vending Manager 查找 Catalog Manager 上的目录时显示的字段：

• remote_vending.keyword.search.results - 查找查询仅包含关键字或指定仅查找此列表中的字段时在 Vending Manager 上显示的字段。这些字段也是在按类别浏览时显示的字段，因此，该值不应为 Null。
• remote_vending.field_query.search.results - 查找查询指定在默认关键字查找结果中不包含的一个或多个查找字段时在 Vending Manager 上显示的字段。除了为此属性指定的字段以外，还会显示查询中包含的查找和排序字段。
• remote_vending.user_defined.search.results - 查找查询指定在结果中包含的一个或多个字段名称时在 Vending Manager 上显示的字段。除了为此属性指定的字段以外，还会显示查询中包含的结果字段。如果查询指定了查找字段或排序字段，则也会将查找字段或排序字段包含在结果中。

下表中显示了有效的字段名称。如果定义了定制字段，请使用 emf.custom-key 作为字段名称，以便将该字段包含在查找结果中。有关定制字段的信息，请参见 1.8 设置定制字段。

以下代码示例中显示了默认值。请注意，属性名称和值必须在同一行中，但本示例受页面大小限制而进行了调整。

keyword.search.results=
   title,status,devname,category,cmprice,dpprice,shortdesc,ctype
field_query.search.results=
   title,status,devname,category,cmprice,dpprice,shortdesc,ctype
user_defined.search.results=
 
remote_vending.keyword.search.results=
   title,status,devname,category,cmprice,shortdesc,ctype
remote_vending.field_query.search.results=
   title,status,devname,category,cmprice,shortdesc,ctype
remote_vending.user_defined.search.results=

11.1.2 Developer Portal

11.1 配置默认结果字段中介绍的 Developer Portal 属性是在 $CDS_HOME/deployment/deployment-name/conf/DeveloperPortal.properties 文件中设置的。表 11-1 中显示了有效的字段名称，但 devname 除外，它不适用于 Developer Portal。如果定义了定制字段，请使用 emf.custom-key 作为字段名称，以便将该字段包含在查找结果中。有关定制字段的信息，请参见 1.8 设置定制字段。

以下代码示例中显示了默认值。

keyword.search.results=title,ctype,category,dpprice,statusmsg,status
field_query.search.results=title,ctype,category,dpprice,statusmsg,status
user_defined.search.results=

11.1.3 Vending Manager 管理控制台

11.1 配置默认结果字段中介绍的 Vending Manager 管理控制台属性是在 $CDS_HOME/deployment/deployment-name/conf/VSAdminConsole.properties 文件中设置的。下表中显示了有效的字段名称。如果定义了定制字段，请使用 emf.custom-key 作为字段名称，以便将该字段包含在查找结果中。有关定制字段的信息，请参见 1.8 设置定制字段。

以下代码示例中显示了默认值。

keyword.search.results=rcid,title,status,vmprice,cmprice,category,ctype
field_query.search.results=rcid,title,status,vmprice,cmprice,category,ctype
user_defined.search.results=

11.1.4 Subscriber Portal

11.1 配置默认结果字段中介绍的属性不适用于 Subscriber Portal。查找结果将通过订户 API 作为 IContentSummary 对象返回到 Subscriber Portal。只能显示此对象中包含的字段。有关此接口的信息，请参见 $CDS_HOME/javadoc/subscriberapi 目录中的 Javadoc 工具的输出。

---

11.2 配置查找引擎

Content Delivery Server 使用 Solr 查找服务器来编索内容和处理查找查询。索引中包含的字段是在名为 schema.xml 的文件中定义的。对于该文件，目录搜索服务和售卖搜索服务具有各自的文件副本。

对于目录搜索服务，schema.xml 文件位于 $CDS_HOME/deployment/deployment-name/conf/css/solr/conf 目录中。此文件用于 Catalog Manager 和 Developer Portal 中的查找。

对于售卖搜索服务，schema.xml 文件位于 $CDS_HOME/deployment/deployment-name/conf/vss/solr/conf 目录中。此文件用于 Vending Manager 和 Subscriber Portal 中的查找。

11.2.1 配置默认查找字段

默认查找字段是指，在查找查询未指定查找字段时查找的字段。由于 Catalog Manager 和 Developer Portal 共享目录搜索服务模式文件，并且 Vending Manager 和 Subscriber Portal 共享售卖搜索服务模式文件，因此，请确保为两个门户指定相同的默认查找字段。

最初，目录搜索服务和售卖搜索服务的默认查找字段如下所示：

• ctype - 内容类型
• title - 标题
• shortdesc - 简短描述
• longdesc - 详细描述
• category - 类别
• devname - 开发者名称
• status - 状态

要更改默认查找字段，请执行以下操作：

1. 打开要设置的查找服务的 schema.xml 文件。

对于目录搜索服务，此文件位于 $CDS_HOME/deployment/deployment-name/conf/css/solr/conf 目录中。对于售卖搜索服务，此文件位于 $CDS_HOME/deployment/deployment-name/conf/vss/solr/conf 目录中。

2. 查找 defaultSearchField 元素。

此元素将 text 定义为在未指定任何字段时查找的默认字段。此默认字段中包含的字段是由 copyField 元素指定的，其中，将 dest 属性设置为 text，例如：

      <field name="ctype" type="text" indexed="true" stored="true"/> 

3. 对于要包含在查找索引中的每个定制字段，添加 field 元素。

下表列出了 field 元素的属性。

例如，以下语句可将艺术家定制字段添加到查找模式中：

<field name="emf.artist" type="text" indexed="true" stored="true"/>

如果没有将定制字段定义为 Catalog Manager 或 Developer Portal 的可查看或可编辑字段，则不要在目录搜索服务的 schema.xml 文件中包含该字段。如果没有将定制字段定义为 Vending Manager 或 Subscriber Portal 的可查看或可编辑字段，则不要在售卖搜索服务的 schema.xml 文件中包含该字段。

4. （可选）启用字段排序。

如果定制字段的范围为 item，数据类型为 text，请按照下列步骤进行操作，以便按此字段对查找结果进行排序：

a. 在 name 属性中使用该定制字段名称并附加后缀 _exact，以便再添加一个 field 元素。

将 type 属性设置为 nonTokenizedSort，将 indexed 属性设置为 true，然后将 stored 属性设置为 false。例如，以下语句为艺术家定制字段添加了一个可排序字段：

<field name="emf.artist_exact" type="nonTokenizedSort" indexed="true" stored="false"/>

b. 在字段定义后面添加 copyField 元素，以便将定制字段复制到刚刚定义的字段中。

例如，以下语句将艺术家定制字段复制到上一步创建的 emf.artist_exact 字段中：

            <copyField source=”emf.artist” dest=”emf.artist_exact”/> 

5. 要在默认查找字段中包含定制字段，请参见 11.2.1 配置默认查找字段。

6. 保存所做的更改。

7. 如果将查找服务部署到单独服务器上，请将 schema.xml 文件复制到部署了 Catalog Manager 或 Vending Manager 的服务器上。

对于 Catalog Manager，请从目录搜索服务中复制 schema.xml 文件。对于 Vending Manager，请从售卖搜索服务中复制 schema.xml 文件。

8. 设置为查找结果中的定制字段显示的列标题。

列标题是在以下属性文件中为每个门户设置的，这些文件位于 $CDS_HOME/deployment/deployment-name/localization 目录中：

• AdminConsoleMessages.properties
• DevPortalMessages.properties
• VendingManagerMessages.properties
• SubscriberPortalLocaleResources.properties

对于显示该字段的每个门户，请将 search.column.title.emf.custom-key 属性设置为在显示查找结果时为定制字段显示的列标题。通常，它与 1.8.2 指定标签和提示中介绍的 emf.content-type.custom-key.label 属性所使用的字符串相同。

9. 重新启动查找服务以使更改可用。

根据进行更改的查找服务，请重新启动目录搜索服务或售卖搜索服务。

Sun Java System Content Delivery Server 集成和配置指南

820-5379-10

版权所有 © 2008, Sun Microsystems, Inc. 保留所有权利