18 门户配置

Content Delivery Server 的门户和接口组件是 Developer Portal、Subscriber Portal、Catalog Manager 管理控制台和 Vending Manager 管理控制台。Content Delivery Server 提供了很多属性，可以通过设置这些属性来配置这些接口使其符合要求。每个接口自身都具有包含该接口的属性的文件，通用文件包含适用于所有接口的属性。

本指南的其他部分介绍了很多配置属性。本章提供了其他部分没有介绍的某些可用属性的相关信息。

本章包含以下主题：

设置通用属性

设置 Developer Portal 属性

设置 Subscriber Portal 属性

设置 Catalog Manager 属性

设置 Vending Manager 属性

18.1 设置通用属性

下表介绍了 $CDS_HOME/deployment/deployment-name/conf/CommonConsole.properties 文件中的属性，可以对其进行修改以满足系统的需要。这些属性适用于所有 Content Delivery Server 接口。

表 18-1 `CommonConsole.properties` 文件中的属性
属性	描述
`catalog.categories.max`	Catalog Manager 和 Vending Manager 的类别分层结构中最大的级别数。例如，如果值为 `3`，则表示主类别可以具有子类别，子类别还可以具有子类别。默认值为 `10`。
`handset.default.maximum.application.size`	默认大小（以字节为单位），如果在定义设备时没有为此设备属性指定值，则将其作为最大应用程序大小。默认值为 `64000`。
`handset.default.maximum.content.size`	默认大小（以字节为单位），如果在定义设备时没有为此设备属性指定值，则将其作为静态内容的最大大小。默认值为 `100000`。
`web.common.upload_max_size`	Content Delivery Server 接受的最大文件大小 (MB)。此大小适用于提交到 Content Delivery Server 的所有文件，包括提交软件包和库。默认值为 `10`。

18.2 设置 Developer Portal 属性

下表介绍了 $CDS_HOME/deployment/deployment-name/conf/DeveloperPortal.properties 文件中的属性，可以对其进行修改以满足系统的需要。这些属性仅适用于 Developer Portal。

表 18-2 `DeveloperPortal.properties` 文件中的属性
属性	描述
`developer.pagination.display.max`	使用 Developer Portal 时每页显示的最大项目数。默认值为 `20`。
`developer.pagination.display.threshold`	列表导航栏在页面底部重复之前在此页面上必须显示的项目数。如果可用项目数少于指定数目，则列表导航栏仅显示在页面顶部。默认值为 `15`。
`external.content.minimum_refresh_period`	在 Content Delivery Server 重新检查外部内容以查找更新之前等待的最短时间（以毫秒为单位）。默认值为 `3600000`。

18.3 设置 Subscriber Portal 属性

下表介绍了 $CDS_HOME/deployment/deployment-name/conf/SubscriberPortal.properties 文件中的属性，可以对其进行修改以满足系统的需要。这些属性仅适用于 Subscriber Portal。

表 18-3 `SubscriberPortal.properties` 文件中的属性
属性	描述
`autoCreate.newDevice`	使订户使用的未知设备自动添加到带有 HTTP 头信息的 Content Delivery Server 数据库。如果将此属性设置为 `true`，则允许在订户使用未知设备时自动将其添加到数据库中。设置为 `false` 则禁止自动添加设备。
`autoCreate.newUser`	允许在未注册的订户从某个设备访问 Subscriber Portal 时自动在 Content Delivery Server 数据库中创建订户帐户。是否将新订户添加到订户数据库取决于 `auto_provision.unknown.user` 属性的设置。将此属性设置为 `true` 可在 Content Delivery Server 数据库中创建订户帐户。设置为 `false` 则防止新建订户帐户。
`autoLogin.mobileId.enable`	根据 URL 参数而不是用户名和密码来启用设备登录。基于移动 ID 的自动登录取决于 WAP 网关传递的标题中的信息。将此属性设置为 `true` 则启用基于移动 ID 的自动登录。设置为 `false` 则禁用自动登录。
`autoLogin.subscriberId.enable`	根据 URL 参数而不是用户名和密码来启用设备登录。基于订户 ID 的自动登录将用于查找 URL 中的 `subId` 参数。此选项主要用于演示系统。将此属性设置为 `true` 则启用基于订户 ID 的自动登录。设置为 `false` 则禁用自动登录。
`autoLogin.uniqueId.enable`	根据 URL 参数而不是用户名和密码来启用设备登录。基于唯一 ID 的自动登录取决于 WAP 网关传递的标题中的信息。将此属性设置为 `true` 则启用基于唯一 ID 的自动登录。设置为 `false` 则禁用自动登录。
`autoLogin.username.enable`	根据 URL 参数而不是用户名和密码来启用设备登录。基于用户名的自动登录用于查找 URL 中的用户参数。此选项主要用于演示系统。将此属性设置为 `true` 则启用基于用户名的自动登录。设置为 `false` 则禁用自动登录。
`default.pushType`	指定推送消息的默认类型。指定要发送的推送消息的默认类型。有效值为 `sms` 和 `wap`。还必须将相应的属性（wap.push.enable 或 sms.push.enable）设置为 `true`。
`descriptor.contentType.encoding.`device-id	指定内容类型的编码类型，每个属性中的 device-id 标识的设备都支持该类型。要指定编码的默认类型，请将 0 用作设备 ID。将此属性设置为下载 Java 应用程序描述符 (Java Application Descriptor, JAD) 文件时要包含在内容类型 HTTP 头中的默认字符集编码字符串，例如 `ISO-8859-1`。如果设备无法处理内容类型标题中的字符集包含，请将该属性设置为 `none`。要获得特定设备的 ID，请将鼠标放在 Catalog Manager 管理控制台“设备管理”页中的模型名上。浏览器状态区域中显示的命令中将包含此 ID。
`descriptor.outputStream.encoding.`device-id	指定输出流的编码类型，每个属性中的 device-id 标识的设备都支持该类型。要指定编码的默认类型，请将 0 用作设备 ID。请将此属性设置为用于输出流的编码类型，例如，`ISO-8859-1`。要获得特定设备的 ID，请将鼠标放在 Catalog Manager 管理控制台“设备管理”页中的模型名上。浏览器状态区域中显示的命令中将包含此 ID。
`desktop.confirmPurchase`	指定从基于 PC 的 Subscriber Portal 中购买内容时是否显示确认页。将此属性设置为 `true` 则显示确认页。设置为 `false` 则不显示确认页。
`desktop.display.numberOfItemsInContentList`	指定在搜索或浏览结果中显示的项目数。如果还有其他项目没有显示出来，将提供查看整个结果集的导航选项。默认值为 `20`。
`desktop.display.numberOfItemsInMyCampaigns`	指定在订户的“我的活动”列表中显示的项目数。将显示最新添加的项目。如果还有其他项目没有显示出来，将提供查看所有项目的链接。设置为 `-1` 将显示所有项目。默认值为 `5`。
`desktop.display.numberOfItemsInMyGiftsReceived`	指定在订户查看收到的礼品时显示的项目数。默认值为 `5`。
`desktop.display.numberOfItemsInMyGiftsSent`	指定在订户查看发送的礼品时显示的项目数。默认值为 `5`。
`desktop.display.numberOfItemsInMyPurchases`	指定在订户的“我的下载”列表中显示的项目数。将显示最新下载的项目。如果还有其他项目没有显示出来，将提供查看所有项目的链接。设置为 `-1` 将显示所有项目。默认值为 `5`。
`desktop.display.numberOfItemsInMyWishlist`	指定在订户的“我的愿望”列表中显示的项目数。将显示最新添加的项目。如果还有其他项目没有显示出来，将提供查看所有项目的链接。设置为 `-1` 将显示所有项目。默认值为 `5`。
`desktop.signup.disable_link`	防止未知订户访问桌面门户上的注册页面和注册服务。将此属性设置为 `true` 可以禁用指向注册页面的链接。设置为 `false` 可以启用该链接。
`desktop.signup.hide_link`	防止未知订户访问桌面门户上的注册页面和注册服务。将此属性设置为 `true` 可以隐藏指向注册页面的链接。设置为 `false` 可以显示该链接。
`device.confirmPurchase`	指定订户在每次购买前是否必须同意一组已定义的条款和条件。将此属性设置为 `true` 将在购买进程中包括“条款和条件”页面。设置为 `false` 将不包括“条款和条件”页面。
`device.display.no_or_items_per_page`	指定在基于设备的 Subscriber Portal 上的内容列表中显示的项目数。默认值为 `5`。
`display.price.my_downloads`	指定当订户从“我的下载”列表中查看内容详细信息时，是显示当前价格还是购买价格。此外，还指定是显示包的当前配置还是显示购买时的配置。将此属性设置为 `retail` 可以显示当前的价格和包配置。设置为 `purchase` 可以显示购买时的价格和包配置。
`display.price.navigation`	指定当订户从“选择内容”页中查看内容详细信息时，是显示当前价格还是购买价格。此外，还指定是显示包的当前配置还是显示购买时的配置。将此属性设置为 `retail` 可以向所有订户显示当前价格以及包的当前配置。设置为 `purchase` 可以显示订户购买内容或包时的价格和包配置。
`dynamic_banner.default.path`	指定在桌面主页上显示的动态 HTML 的路径。请将此属性设置为系统位置。
`gifts_restricted_to_recipients_plan`	确定在接收者的订户计划不允许接收者访问内容时，订户能否将该内容赠予其他订户。如果将此属性设置为 `true`，则可以将赠予者限制为仅赠予接收者订户计划允许的内容。如果设置为 `false`，则允许赠予者赠予接收者订户计划中未包含的内容。默认值为 `false`。
`lb.cookiename`	指定负载平衡器 Cookie 的名称。如果正在使用负载平衡器将通信流量路由到其他服务器，则可向每个请求添加一个键/值对，以确保订户会话仍保留在特定服务器上。将此属性设置为由负载平衡器评估的键的名称。
`lb.cookievalue`	指定负载平衡器 Cookie 的值。如果正在使用负载平衡器将通信流量路由到其他服务器，则可向每个请求添加一个键/值对，以确保订户会话仍保留在特定服务器上。将此属性设置为与负载平衡器评估的键相关联的值。
`max.device.message.length`	指定推送到设备的消息中包含的最大字节数。默认值为 `10000`。
`newDevice.notification.emailAddress`	发送新设备的通知。可以在自动新建设备时发送通知电子邮件。请参见 autoCreate.newDevice 以指定将自动创建设备。将此属性设置为向其发送新设备通知的电子邮件地址。
`password_reminder.emailenabled`	指定是否为订户提供将密码提醒发送到其电子邮件的选项。将此属性设置为 `true` 可为订户提供该选项。设置为 `false` 则会隐藏该选项。
`password_reminder.firstnameenabled`	指定是否在密码提醒屏幕上显示“名字”字段。将此属性设置为 `true` 可显示该字段。设置为 `false` 则会隐藏该字段。
`password_reminder.lastnameenabled`	指定是否在密码提醒屏幕上显示“姓氏”字段。将此属性设置为 `true` 可显示该字段。设置为 `false` 则会隐藏该字段。
`password_reminder.template.filename`	指定用于生成密码提醒消息的样式表的名称。默认值为 `text/password_reminder.xsl`
`password_reminder.webalertenabled`	指定是否为订户提供将密码提醒发送到其电子邮件的选项。将此属性设置为 `true` 可为订户提供该选项。设置为 `false` 则会隐藏该选项。
`quarantine.newDevice`	指定是否隔离自动创建的设备。请参见 autoCreate.newDevice 以指定将自动创建设备。由于 HTTP 标题信息可能不完整，因此将提供用于隔离该设备的选项，直到管理员完成定义。将此属性设置为 `true` 可以隔离新添加的设备。设置为 `false` 可以立即使用该设备。检测到的设备可能未完整定义。
`quick.browse.enabled`	对于每个用户会话，仅对类别中的项目数和某个项目的下载次数检查一次，从而快速装入页面。将此属性设置为 `false` 将在每次请求时都检查计数。将此属性设置为 `true` 则针对每个用户会话检查一次计数。默认值为 `true`。
`quick.purchase.enabled`	通过使用订户在登录时收到的数据或检索的内容验证购买（而非验证前更新数据）启用快速购买进程。验证检查包括验证订户是否被禁用或者内容是否处于不活动状态。将此属性设置为 `false` 可以在购买时进行所有验证检查。将此属性设置为 `true` 可以使用订户登录或上次检索内容时所检索的数据。默认值为 `true`。
`share_content.gifting.expirationDays`	指定礼品到期之前可以兑换的天数。默认值为 30 天。
`share_content.template.filename`	指定用于生成礼品消息的样式表的名称。默认值为 `text/share_content.xsl`。
`signup.unknown.user`	确定能否在 Content Delivery Server 中注册订户数据库中未包含的用户。不会在此函数内部执行检查，以确定所注册的用户是否对 Content Delivery Server 已知。将此属性设置为 `true` 可允许注册未知用户。设置为 `false` 则禁止注册未知用户。默认值为 `true`。
`signup.unknown.user.firstName`	指定用于订户名字的值，如果在注册未知用户时未提供订户名字值，将使用该值。默认值为 `Signed-up User`。
`signup.unknown.user.lastName`	指定用于订户姓氏的值，如果在注册未知用户时未提供订户姓氏值，将使用该值。默认值为 `Signed-up User`。
`signup.unknown.user.middleName`	指定用于订户中间名的值，如果在注册未知用户时未提供订户中间名值，将使用该值。默认值为 `Signed-up User`。
`signup.unknown.user.enabled`	指定在为未知用户创建订户帐户后是否启用该帐户。将此属性设置为 `true` 可启用该帐户。将此属性设置为 `false` 则会禁用该帐户。默认值为 `true`。
`signup.unknown.user.email`	如果在注册未知用户时未提供订户电子邮件地址值所使用的电子邮件域值，则指定该值。将在字符串开头添加用户的电话号码以构成完整的地址。默认值为 `@external.com`。
`sms.bundle.items.threshold`	指定包中一次直接推送到设备的最大项目数。如果某个包所包含的要进行 SMS 传送的内容项数超出此属性指定的值，则会为订户提供一个链接，该链接指向需要单个下载的内容项的列表。例如，如果将此属性设置为 4，并且订户购买的包具有四个或更少的内容项，则会将所有内容项直接发送到订户设备。如果购买的包具有四个以上的内容项，则会向订户发送一个指向内容项列表的链接。
`sms.push.enable`	指定能否发送 SMS 推送消息。将此属性设置为 `true` 则可允许发送 SMS 推送消息。设置为 `false` 则会禁用 SMS 推送消息。
`subscriber.every_download.update_license`	表明当许可证更改时是否对订户下载内容的许可证进行更新。此属性仅适用于指定每次下载时订户都需要付费的许可证。将此属性设置为 `true` 表明，当记帐模型更改时将根据新的记帐模型对订户进行收费。设置为 `false` 则表明将根据原始记帐模型对订户进行收费。
`user.security.max_login_attempts`	指定订户在帐户被锁定之前尝试登录并且失败的次数。设置为 `0` 可以允许无限次登录。默认值为 `3`。
`wap.push.enable`	指定能否发送 WAP 推送消息。将此属性设置为 `true` 可允许发送 WAP 推送消息。设置为 `false` 则会禁用 WAP 推送消息。
`wml.display.no_of_items_per_page`	指定在使用基于设备的 Subscriber Portal 时每页显示的最大项目数。默认值为 `5`。

18.4 设置 Catalog Manager 属性

下表介绍了 $CDS_HOME/deployment/deployment-name/conf/AdminConsole.properties 文件中的属性，可以对其进行修改以满足系统的需要。这些属性仅适用于 Catalog Manager 管理控制台。

表 18-4 `AdminConsole.properties` 文件中的属性
属性	描述
`admin.pagination.display.max`	指定在使用 Catalog Manager 管理控制台时每页显示的最大项目数。默认值为 `20`。
`admin.pagination.display.threshold`	指定列表导航栏在页面底部重复之前在此页面上必须显示的项目数。如果可用项目数少于指定数目，则列表导航栏仅显示在页面顶部。默认值为 `15`。
`preload_device_capabilities_on_device_list`	确定在第一次访问设备列表时是否装入所有设备的设备功能。根据系统中的设备和内容数量，装入所有设备的功能可能需要几分钟或更长的时间，并且会影响设备相关活动的性能，例如，查看和编辑设备。如果将此属性设置为 `true`，则会在第一次访问时装入所有设备功能。如果设置为 `false`，则只有在选择了某个设备时才会装入该设备的设备功能。默认值为 `true`。如果定义了多个设备，并发现在服务器重新启动后第一次访问设备时出现性能下降，请将此属性设置为 `false`。

18.5 设置 Vending Manager 属性

下表介绍了 $CDS_HOME/deployment/deployment-name/conf/VSAdminConsole.properties 文件中的属性，可以对其进行设置以满足系统的需要。这些属性仅适用于 Vending Manager 管理控制台。

表 18-5 `VSAdminConsole.properties` 文件中的属性
属性	描述
`admin.pagination.display.max`	指定在 Vending Manager 管理控制台中每页显示的最大项目数。默认值为 `20`。
`admin.pagination.display.threshold`	指定列表导航栏在页面底部重复之前在此页面上必须显示的项目数。如果可用项目数少于指定数目，则列表导航栏仅显示在页面顶部。默认值为 `15`。