对基于设备的 Subscriber Portal 署名

第 2 章

对基于设备的 Subscriber Portal 署名

本章介绍如何对在移动设备上运行的 Sun Java System Content Delivery Server 的 Subscriber Portal 组件版本署名。可以为页面标题和脚注提供定制图像，并更改文本特性和颜色以使其更加符合公司形象。

要更改订户从 PC 访问的 Subscriber Portal 版本，请参阅第 1 章“对基于 PC 的 Subscriber Portal 署名”。

将介绍以下主题：

注－除了署名外，还可以针对特定设备功能来设计基于设备的 Subscriber Portal。有关详细信息，请参阅《Sun Java System Content Delivery Server 集成指南》中关于设备特定的用户界面框架的章节。

2.1 更改标题或脚注图像

每个页面的标题和脚注所使用的图像位于下列位置的 static/media/device 目录中：

对于 Sun Java System Application Server，该目录为 $CDS_HOME/deployment/deployment-name/sun/domains/server-domain/server-name/applications/j2ee-modules/CDSSubscriberPortal_1。

对于 WebLogic Server，该目录为 $CDS_HOME/deployment/deployment-name/weblogic/domains/server-domain/applications/subscriberportal。

每个文件的名称描述了文件的宽度和所使用的位置。例如，文件 Header128px.gif 用于标题，宽度为 128 个像素。要更改使用的图像，请用同名文件替换该图像。

2.2 删除图像

图像可以用于标题、脚注和排序列表中每个项目的序号。如果希望减少网络流量，可以通过更改用于生成 Subscriber Portal 页面的式样表来除去图像。

式样表位于 $CDS_HOME/deployment/deployment-name/markup-generation/stylesheets 目录中。

要删除图像，请执行以下操作：

编辑 $CDS_HOME/deployment/deployment-name/markup-generation/stylesheets 目录中的每个式样表。

有关式样表的详细信息，请参阅《Sun Java System Content Delivery Server 集成指南》中关于设备特定的用户界面框架的章节。

要除去标题图像，请用下列代码替换标题模板。

<xsl:template name="header"> 
  <!-- DO NOT DISPLAY HEADER --> 
</xsl:template>

要除去脚注图像，请用下列代码替换脚注模板。

<xsl:template name="footer"> 
  <!-- DO NOT DISPLAY FOOTER --> 
</xsl:template>

要用后跟句点的文本数值替换排序列表中的项目号所使用的图像，请执行以下操作：

在包括列表模板的每个式样表中，查找列表模板中的下列语句。

<![CDATA[<img src="<%=Web.getWeb().getDefaultImageURL() + "/device/" + jspHelper.getRowNumber() + ".gif"%>" alt="<%=jspHelper.getRowNumber()%>" />]]>

用以下语句替换该语句。

<![CDATA[<%jspHelper.getRowNumber()%>.]]>

重新生成 Subscriber Portal 的页面。

请参见第 2.5 节“生成页面”。

2.3 更改颜色和文本特性

要更改颜色和字体，请执行以下操作：

编辑包含样式模板的 $CDS_HOME/deployment/deployment-name/markup-generation/stylesheets 目录中的每个式样表。

有关式样表的详细信息，请参阅《Sun Java System Content Delivery Server 集成指南》中关于设备特定的用户界面框架的章节。

设置颜色和文本特性。

例如：

<xsl:template name="style"> 
  <style type="text/css"> 
    body { background-color:#9999CC; } 
    td.odd { background-color:#99CCFF; vertical-align:middle; } 
    td.even { background-color:#BCDBFB; vertical-align:middle; } 
    td.image { background-color:#9999CC; vertical-align:middle; } 
    a { color:#000066; text-decoration:none; } 
    span.text { color: #000066; } 
    span.error { color:#CC3300; } 
  </style> 
</xsl:template>

重新生成 Subscriber Portal 的页面。

请参见第 2.5 节“生成页面”。

2.4 更改文本

Subscriber Portal 页面上显示的文本是从 $CDS_HOME/deployment/deployment-name/localization/SubscriberPortalLocaleResource.properties 文件中读取的。要更改字段的消息或标签，请编辑该文件中的字符串。基于设备的 Subscriber Portal 所使用的属性有 device 前缀。例如，device.login.title。

订户运行应用程序时显示的消息是从 $CDS_HOME/deployment/deployment-name/localization/FulfillmentLocaleResource.properties 文件中读取的。要更改消息，请编辑该文件中的字符串。

如果资源文件特定于具体的语言环境，请编辑与所使用的语言环境相应的文件中的字符串。

2.5 生成页面

Subscriber Portal 包含使用 JavaServer Pages^TM 技术创建的页面（JSP^TM 页面）。这些 JSP 页面从 XML 文件和 XSL 式样表生成，XML 文件描述了要生成的页面，XSL 式样表描述了如何显示页面元素。每个式样表都将生成一组 JSP 页面，并且这组 JSP 页面将存储在与相应式样表同名的子目录中。

修改式样表后，必须为每个设备特定的 Subscriber Portal 版本生成新的 JSP 页面。要生成新的页面，请执行以下操作：

运行命令：cdsi genmarkup all。

该命令将根据 $CDS_HOME/deployment/deployment-name/markup_generation/stylesheets 目录中的所有式样表来处理 $CDS_HOME/deployment/deployment-name/markup_generation/page-defs 目录中的所有 XML 文件，并为每个式样表生成一组新的 JSP 页面。每一组页面都位于 $CDS_HOME\deployment\deployment-name\markup_generation\jsps\stylesheet 目录下，其中 stylesheet 是用于生成页面的式样表的名称。

将包含已生成 JSP 页面的目录移动到部署了 Subscriber Portal 的每个应用程序服务器上的 Subscriber Portal 应用程序目录中。

对于 Sun Java System Application Server，该目录为 $CDS_HOME/deployment/deployment-name/sun/domains/server-domain/server-name/applications/j2ee-modules/CDSSubscriberPortal_1/device。

对于 WebLogic Server，该目录为 $CDS_HOME/deployment/deployment-name/weblogic/domains/server-domain/applications/subscriberportal/device。

署名指南
Sun Java™ System Content Delivery Server，版本 2004Q1