将 V8.0x 定制窗口小部件迁移至 V8.5.6

如果要在 V8.5.6 中使用为 IBM® Business MonitorV8.0 或 V8.0.1 开发的定制 IBM Business Monitor 仪表板窗口小部件，那么必须迁移这些窗口小部件。V8.5.5 中不推荐使用针对定制 iWidget 的支持。

1. 迁移包含定制窗口小部件的概要文件。
2. 卸载定制窗口小部件 EAR。
   要点： 您的 V8.0.x 窗口小部件可能使用 Dojo。BPM V8.5 中的窗口小部件使用的 IBM Dojo Toolkit 实例基于 Dojo Toolkit V1.6.1。然而，此捆绑版本以后将根据需要进行更新。这可能包括全新的 Dojo 版本以及特定缺陷修订。将来 Dojo 版本的兼容性由 Dojo 项目定义。
3. 如果升级为使用 iWidget 规范会影响窗口小部件，请更新窗口小部件中的代码。 下表显示适用于每个版本的 IBM Business Monitor 的 iWidget 规范。

   IBM Business Monitor 版本	iWidget 规范版本
   8.x	2.1
   8.5	2.1

   可从 http://public.dhe.ibm.com/software/dw/lotus/mashups/developer/iwidget-spec-v2.1.pdf 下载 iWidget 规范 V2.1。复查规范是否有更改和不推荐使用之处，以了解升级是否会影响窗口小部件。
4. 要对窗口小部件进行打包：
   1. 创建 ear 目录。将包含已迁移的窗口小部件定义文件和窗口小部件实现文件的 .ear 文件复制到 ear 目录。
   2. 创建 catalog 目录，并将目录 XML（窗口小部件注册）文件复制到该目录中。
   3. 创建 endpoints 目录，并将端点注册文件复制到该目录中（如果存在端点注册文件的话）。
   4. 创建 help 目录，并将帮助插件复制到该目录中（如果存在帮助插件的话）。
   5. 将 ear、catalog、endpoints 和 help 目录压缩到 .zip 文件。 检查压缩文件的结构中是否包含以下项：
      • ear\widgets_name.ear（一个或多个 EAR 文件）
      • catalog\catalog_name.xml
      • endpoints\*.xml
      • help\eclipse\plugins\*
5. 在命令提示符中，将目录更改为 profile_root/bin 或 cluster_root/bin 目录。
6. 输入 wsadmin.bat -conntype NONE，然后输入相应的命令：
   • 对于非集群环境：
     • Jython 命令：

       AdminTask.updateBusinessSpaceWidgets('{-nodeName node -serverName server -widgets fullpath}')

     • Jacl 命令：

       $AdminTask updateBusinessSpaceWidgets {-nodeName node -serverName server -widgets fullpath}

   • 对于集群环境：
     • Jython 命令：

       AdminTask.updateBusinessSpaceWidgets('{-clusterName cluster -widgets fullpath}')

     • Jacl 命令：

       $AdminTask updateBusinessSpaceWidgets {-clusterName cluster -widgets fullpath}

   Fullpath 是您创建的 .zip 文件或父文件夹的名称和位置。

   有关 updateBusinessSpaceWidgets 的更多信息，请参阅 updateBusinessSpaceWidgets 命令。

7. 输入 Exit 以完成迁移。
8. 重新启动服务器或集群。