Web 工具(Web 图编辑器、Page Designer 和 Web Site Designer)发行说明

© Copyright International Business Machines Corporation 2006, 2007. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM® Corp.

发行说明

1.0 局限性
   1.1 与 Page Designer CSS 属性的呈示相关的局限性
   1.2 第三级菜单项消失
   1.3 从项目资源管理器拖放到“Web 站点导航”期间发生空指针异常
   1.4 在创建项目期间无法将样本模板复制为动态模板
   1.5 在 web.xml 中所作的更改不会反映在“Web 站点导航”中
   1.6 俄语版的按钮名被截断
   1.7 撤销操作菜单项的顺序错误
   1.8 “设计”页中的导航轨迹未随站点更改而更新
2.0 已知问题与变通方法
   2.1 Page Designer 在分割框架后无法与软件配置管理(SCM)配合工作
   2.2 当插入标记显示在自由布局表外部时,Page Designer 无法从主菜单插入自由布局表
   2.3 属性视图的布局会折叠
   2.4 弹出信息在 Web 图编辑器中显示一般帮助
   2.5 将 HTML 和 JSP 标记混合使用时,HTML 语法验证功能错误地报告“无起始标记”错误
   2.6 使用“J2EE 迁移”向导迁移项目时,必须对某些构面进行手工更新
   2.7 右键单击文本单元格中的元素时,Page Designer 未显示正确的弹出菜单
   2.8 更改 JDBC 连接时,可能无法更新 Web 绑定文件中的认证别名
   2.9 发生 SWTError 错误,此错误建议您关闭工作台
   2.10 在使用“关系记录”和“关系记录列表”向导时,发生 Derby 网络驱动程序错误
   2.11 如果已启用 WebSphere Application Server V6.1 的 JDBC 介体,则将目标运行时更改为 V6.1 时,不会对类路径进行相应的更改
   2.12 导入 WAR/EAR 时,可能会除去 JDBC 介体的数据源资源引用
   2.13 在导入页面包含 JSF 标记“h:outputLink”的 V512 Web 项目时,可能会出错

1.0 局限性

1.1 与 Page Designer CSS 属性的呈示相关的局限性

Page Designer 不支持非可视类型 CSS 属性,例如,speak。

Page Designer 不支持下列可视类型 CSS 属性:
border-collapse、border-spacing、caption-side、clip、content、counter-increment、counter-reset、cursor、empty-cells、font-variant、letter-spacing、max-height、max-width、min-height、min-width、orphans、outline-color、outline-style、outline-width、outline、overflow、page-break-after、page-break-before、page-break-inside、quotes、table-layout、visibility、widows 和 word-spacing。

Page Designer 不完全支持下列可视类型 CSS 属性:
- 不支持 margin、margin-top、margin-bottom、margin-left 和 margin-right 的负数值。
- 不支持 position 的 relative 值和 fixed 值。
- 不支持按 vertical-align 的 percentage 或 length 来指定的值。
- 不支持 vertical-align 的 top 值和 bottom 值。
- 不支持 white-space 的 pre-wrap 值和 pre-line 值。

1.2 第三级菜单项消失

如果创建的水平或垂直菜单的菜单深度超过 3,并且 keepSelection 属性为 true,则鼠标指针悬停在菜单项上时,子菜单项应该保持展开,但第三级菜单项无法保持展开。

1.3 从项目资源管理器拖放到“Web 站点导航”期间发生空指针异常

将页面从“项目资源管理器”视图的 WebContent 文件夹拖放到“Web 站点导航”的“导航”页时,将抛出空指针异常。

1.4 在创建项目期间无法将样本模板复制为动态模板

如果创建 Web 项目时选择了 Web 站点导航项目构面,则在向导的“为 Web 站点选择页面模板”页面中,可以选中将缺省页面模板用于 Web 站点复选框并选择样本模板,但只能选择设计时模板。无法选择动态页面模板。

1.5 在 web.xml 中所作的更改不会反映在“Web 站点导航”中

对 web.xml 文件进行更改时,“Web 站点导航”不会反映所作的更改。例如,如果更改了 web.xml 中某个页面的 servlet 映射,则“Web 站点导航”不会立即或在您保存该 web.xml 文件后将此更改反映在“详细信息”页面中。

1.6 俄语版的按钮名被截断

将按钮名由英语翻译为俄语或其他某种语言时,翻译后的字符串的长度可能会超过英语字符串的长度。如果按钮大小保持不变,则按钮名将显示不全。

1.7 撤销操作菜单项的顺序错误

在英语和其他语言中,菜单项将显示为“撤销<操作>”(例如,撤销添加 Web 页面),然而,在韩国语中,该菜单项应该显示为“<操作>撤销”(例如,添加 Web页面撤销)。目前,这些菜单项显示为“撤销<操作>”。

1.8 “设计”页中的导航轨迹未随站点更改而更新

在站点的其中一个页面上插入导航轨迹后,对此站点所作的更改并不会反映在 Page Designer 的“设计”页中。例如,必须先切换到“预览”页,然后再切换回到 Page Designer 的“设计”页以刷新屏幕,这样才能看到所作的更改。

2.0 已知问题与变通方法

2.1 Page Designer 在分割框架后无法与软件配置管理(SCM)配合工作

如果文件是通过分割 Page Designer 中的框架新建的并受 SCM 管理,则可能无法在这个 Page Designer 中编辑此文件。

变通方法:关闭 Page Designer 然后重新打开此文件。

2.2 当插入标记显示在自由布局表外部时,Page Designer 无法从主菜单插入自由布局表

在 Page Designer 的“设计”页中,当插入标记显示在自由布局表外部时,无法从主菜单插入自由布局表。

变通方法:在这种情况下,请从选用板插入自由布局表。

2.3 属性视图的布局会折叠

在将 Page Designer 与常驻屏幕朗读器软件配合使用时,“属性”视图的布局可能会折叠。

变通方法:
不要将“属性”视图与此类软件配合使用。请使用“属性”视图本地工具栏菜单上“显示所有属性”中的“所有属性”方式。

2.4 弹出信息在 Web 图编辑器中显示一般帮助

在编辑 Web 图时,动态帮助视图能够提供上下文相关帮助,但在弹出信息中却未提供此帮助。要设置有关在动态帮助视图中显示上下文相关帮助的首选项:单击窗口 > 首选项 > 帮助,然后在打开窗口上下文帮助下面单击在动态帮助视图中单选按钮。如果单击在弹出信息中单选按钮,则当您编辑 Web 图时,系统将仅提供一般帮助。

2.5 将 HTML 和 JSP 标记混合使用时,HTML 语法验证功能错误地报告“无起始标记”错误

将 HTML 和 JSP 标记(包括定制标记)混合使用可能会导致 HTML 语法验证器错误地报告有关缺少起始标记和结束标记的错误。例如,在以下代码中:

<c:when test="${status.first}">
<div class="topNavRight"><ul>
</c:when>
...
<c:if test="${status.last}">
</ul></div>
</c:if>

<div> 和 <ul> 起始标记在 <c:when> 标记中,</ul></div> 结束标记在 <c:if> 标记中。此代码有效,但是 HTML 语法验证器却报告 </ul> 和 </div> 标记缺少起始标记。

变通方法 1:尽可能不要使 HTML 与 JSP 标记重叠。在上面的示例中,变通方法是将代码更改为:

<div class="topNavRight"><ul>
<c:when test="${status.first}">
</c:when>
...
<c:if test="${status.last}">
</c:if>
</ul></div>

变通方法 2:如果必须进行重叠,则变通方法是禁用 HTML 语法验证功能。要在项目中禁用 HTML 语法验证功能,请打开该项目的“属性”对话框,选择“验证”属性页,选中“覆盖验证首选项”,并取消选中“HTML 语法验证器”。

2.6 使用“J2EE 迁移”向导迁移项目时,必须对某些构面进行手工更新

如果通过“J2EE 迁移”向导迁移应用程序(使用项目上下文菜单中的“迁移”来打开此向导),则可能无法正常地更新某些依赖于特定动态 Web 版本的构面。  

变通方法:完成迁移后,请转到项目的“属性”页(从项目上下文菜单中选择“属性”),然后切换到“项目构面”属性页。单击“添加/除去项目构面”。您可能会看到错误消息,它们指出某些构面需要特定的动态 Web 模块版本,例如 JSTL、JDBC 介体以及 WebSphere® Web 共存和 Web 扩展。对于大部分构面,您只需从下拉列表中选择适当的必需版本并单击“完成”。对于“JDBC 介体”构面,您需要以手工方式取消选择旧构面并单击“完成”,然后重新打开构面页并选择适当的构面版本,以便将相应的“JDBC 介体”JAR 文件添加到类路径中。

2.7 右键单击文本单元格中的元素时,Page Designer 未显示正确的弹出菜单

当文本单元格只包含一个元素时,无法通过右键单击该元素显示它的弹出菜单。

变通方法:要显示文本单元格中某个元素的正确弹出菜单,请按 Shift+F10 键,而不要单击鼠标右键。

2.8 更改 JDBC 连接时,可能无法更新 Web 绑定文件中的认证别名

如果从项目的属性中更新 JDBC 连接的运行时详细信息,则将在扩展 EAR 文件中创建一个新连接,并且会将资源引用更新为指向这个新数据源的新 JNDI 名称。但是,系统不会更新该认证别名。  
变通方法:在 web.xml 文件中选择与该 JDBC 连接同名的资源引用。资源引用名将基于您从“名称”下拉列表中选择用于更新的原始连接,而非基于更新时指定的连接的名称。请将认证别名设置为刚刚创建的名称(新认证别名将包含进行更新时指定的连接名)。您可以在 EAR 部署描述符的“部署”部分中找到此名称,或者,如果正在使用 WebSphere Application Server V5.1 测试环境服务器,则可以在服务器配置中找到此名称。

2.9 发生 SWTError 错误,此错误建议您关闭工作台

使用 Page Designer 时,可能会出现一个提示,该提示指出 SWTError 建议您关闭工作台。在打开 Web 页面时,或者当您尝试在 Page Designer 中打开弹出菜单时,可能会发生此问题。如果遇到此问题,则表明系统正在运行大量应用程序,负载过高。

变通方法:

  1. 打开 Windows® 任务管理器
  2. 转到进程选项卡。
  3. 查找句柄计数USER 对象GDI 对象等列的值较大的进程。
    • 如果您看不到这些列,请从菜单中选择查看 > 选择列。然后,在选择列窗口中,选中句柄计数USER 对象GDI 对象

  4. 这些进程耗用了大量系统对象,本产品无法与这些应用程序一起运行。请尝试关闭某些应用程序,然后再次启动工作台。

2.10 在使用“关系记录”和“关系记录列表”向导时,发生 Derby 网络驱动程序错误

连接至 Derby 网络数据库后,使用“关系记录”和“关系记录列表”向导时可能会发生问题。如果数据库中某个表与另一个包含多列主键的表之间存在外键关系,并且您尝试添加从前一个表到后一个表的关系,则将发生此问题。


变通方法:打开“数据库资源管理器”视图,展开所有将要使用的表,确保正确地装入了主键约束,然后再运行“关系记录”或“关系记录列表”向导。

2.11 如果已启用 WebSphere Application Server V6.1 的 JDBC 介体,则将目标运行时更改为 V6.1 时,不会对类路径进行相应的更改

创建带有 JDBC 介体构面的动态 Web 项目时,将根据目标服务器来设置运行时 JAR 文件,而与所选构面版本无关。例如,如果面向 WebSphere Application  Server V5.1,但选择了 V6.1 的 JDBC 介体构面,则会将 V5.1 的相应 JAR 文件添加到项目中。但是,如果接着将 Web 项目的目标运行时设置为 WebSphere Application Server V6.1,则不会更新 JDBC 介体运行时。

变通方法:从项目中卸载 JDBC 介体构面,然后重新安装此构面。要完成此任务,请用鼠标右键单击该 Web 项目,然后单击属性。单击项目构面,然后单击添加/除去项目构面按钮。清除 JDBC 介体复选框,然后单击完成。再次单击添加/除去项目构面按钮,选中 JDBC 介体复选框,然后单击完成。单击确定


2.12 导入 WAR/EAR 时,可能会除去 JDBC 介体的数据源资源引用

在使用 JDBC 介体访问关系记录或关系记录列表时,将在项目的 web.xml 中创建数据源的资源引用。如果将该项目导出为 WAR 或 EAR 文件,然后再次将其导入,则可能会删除该资源引用,从而导致在运行时访问数据失败。如果进行导入时删除了资源引用,则可以通过两种方法解决此问题。第一种方法是,使用数据访问工具来重新创建数据源连接。如果要修改已创建的 Web 页面上的任何关系记录或关系记录列表,则也需要执行此操作。另一种方法是,将该 WAR 文件解压缩到一个目录中,然后将 web.xml 文件中的资源引用复制到工作空间中所导入项目的 web.xml 文件中。如果执行此操作,则还必须除去资源引用描述,否则构建该项目时将再次删除该资源引用。资源引用描述将是“自动生成 - 与 XXXX 的 SDO 数据源连接”。

2.13 在导入页面包含 JSF 标记“h:outputLink”的 V512 Web 项目时,可能会出错

如果导入在 WebSphere Studio Application Developer 或 WebSphere Studio Site Developer V5.1.2 中创建的动态 Web 项目,并且该项目包含样本“Web 站点导航”控件(例如垂直选项卡或水平选项卡),则“问题”视图将显示与添加到用户项目中的样本 JSP 文件相关的以下错误:

标识“${siteid.id}”无效。

原因:

在 V512 中,每当在站点导航栏中使用 JSF 标记“h:outputLink”时,将生成并使用它的“id”属性。而在 V7 中,不会生成或使用这个“id”属性。因此,Faces 验证器无法识别“Web 站点导航”中引入的那些语句,但它需要将重复的标识标记为错误,否则在运行时将发生问题。

变通方法:

在 JSP 页面代码中,手工删除站点导航栏中 JSF 标记“h:outputLink”的“id”属性(即,应该除去文本 id="${siteid.id}")。

例如,如果 V512 项目中的某个 .jsp 文件包含下面这一行,则将导致以上错误:
<td nowrap valign="middle" style="background-image: url('${sitenav.navtabSelImg[4]}')"><h:outputLink id="${siteid.id}" style="${sitenav.navstyle}" styleClass="${sitenav.navclass}" value="${item.href}"><h:outputText value="${item.label}"></h:outputText></h:outputLink></td>

应该将此行修改为:

<td nowrap valign="middle" style="background-image: url('${sitenav.navtabSelImg[4]}')"><h:outputLink  style="${sitenav.navstyle}" styleClass="${sitenav.navclass}" value="${item.href}"><h:outputText value="${item.label}"></h:outputText></h:outputLink></td>