基本自定义 > 用户界面自定义 > 信息页面 > 更新旧信息页面
  
更新旧信息页面
如果您拥有使用 describeInfoPage 和 infoPage.jspf 的信息页面 JSP,则转换为新设计的步骤如下所示:
1. 创建 InfoBuilder。
a. describeInfoPage 标记上的许多属性应在 InfoConfig 上具有相应的 setter。
a. id、helpContext、actionListName、navBarName
b. propertyPanel、moreAttributesActionName、moreAttributesActionType 属性 (和 addPropertyPanel 标记) 已过时。有关如何创建属性布局的详细说明,请参阅步骤 4。
c. describeStatusGlyph 标记将成为 InfoConfig 上的特性。(请参阅自定义点主题中的“添加状况符号”一节)。
2. 如有必要,请配置可视化 (请参阅自定义点主题中的“配置可视化组件”一节)
3. 使用以下 3 个选项之一为对象类型创建属性布局:
a. 通过“类型和属性管理”实用程序。(请参阅类型和属性管理)
b. 包含加载文件。
c. 包含自定义属性面板构建器。请参阅“随附的示例”。
4. 删除信息页面 JSP 上的 xconf 条目
a. 如果存在适用于您的对象类型的 xconf 条目,则使用该条目,而非 InfoPageBuilder。
5. 从 info.jsp 中删除包含的 describeInfoPage 标记和 infoPage.jspf
6. 如果您想要在信息页面 (某些表格或特性面板) 上显示您的 JSP 中的某些内容,请将这些表格/特性面板移动到第三级导航栏 (这些会成为目录)。通过这种方式,所显示的表格/面板可由管理员和最终用户进行配置。
a. 为每个表格/面板创建单独的操作。有关操作/操作模型的详细信息,请参阅“操作框架”文档。
a. 首选 - 为每个表格/面板创建一个构建器。请参阅“MVC 表格”文档。生成的 actions.xml 条目如下所示:
<action name="myTable">
<component name="myTable" typeBased="true" windowType="page"/>
</action>
b. 旧版方式 - 为每个表格/面板创建单独的 JSP。生成的 actions.xml 条目如下所示:
<action name="myTable">
<command windowType="page"/>
</action>
b. 将这些操作添加到您的 navBarName 操作模型中。确保已在 InfoBuilder 中设置了该 navBarName。(有关详细信息,请参阅配置目录一节。)
c. 配置在“详细信息”选项卡中预设显示的表格/面板。有关详细信息,请参阅自定义点主题中的“选项卡自定义”一节。
调试
添加 jcaDebug=true 到 URL,以查看信息页面上显示的一些调试信息。http://<hostName>/<webApp>/app/#ptc1/tcomp/infoPage?typeIdForTypeLookup=com.ptc.carambola.customization.examples.infoPage.Carambola&jcaDebug=true 特别是在 jcaDebugdisplays 页面的顶部 ComponentConfigBuilder 或 JSP 是否生成了页面。
还提供了“操作”菜单、顶部选项卡集和“自定义”选项的操作模型,以便您将表格添加到选项卡中。有关显示的内容和在何处进行查找的详细信息,请参阅 jcaDebug 文档。
Log4J
以下 log4J 记录器可在调试“信息页面”实现时提供详细信息:
记录器
说明
com.ptc.core.components.validators.VisualizationAndAttributesFilter
记录与隐藏和显示 primaryAttributes 或 visualizationAndAttributes 组件相关的信息。请参阅“‘属性’与‘可视化和属性’”
com.ptc.jca.mvc.components.AbstractInfoComponentBuilder
记录与查找信息页面的上下文对象相关的信息。
com.ptc.mvc.components.AbstractInfoConfigBuilder
记录与针对信息页面选择的视图相关的信息。如果您要设置自定义视图,这可能会很有用。
com.ptc.jca.mvc.controllers.TypeBasedIncludeController
记录与确定所请求信息页面是由旧 JSP 还是由 MVC 构建器呈现有关的信息。
Log4javascript
Log4javascript 也可在浏览器中进行调试。可以通过将参数添加到 URL 的末尾来将其打开。“&jsLog=PTC”。这将打开所有 JavaScript 日志记录。然后,您将在 FF/Chrome 控制台或在 IE 浏览器中添加参数时将打开的单独控制台中看到日志记录信息。还可以通过设置 jsLog=<loggername> 来单独打开以下记录器。
记录器
说明
PTC.infoPage
记录呈现信息页面时遇到的错误信息,以及与刷新页面顶部区域相关的信息。
PTC.infoPage.ActiveTab
记录有关根据默认值、粘性和潜在覆盖选择启用的选项卡的相关信息。
PTC.jca.state.ClientStateStore
记录针对客户端粘性与所存储和检索的粘性信息相关的信息。
PTC.infoPageTableMgr
记录在信息页面的选项卡中添加和移除表格的信息。
PTC.jca.manager
记录有关在信息页面的选项卡中添加和移除表格以及添加和移除选项卡的信息。