这些发行说明包含 IBM(R) WebSphere(R) Business Integration Web Service 适配器版本 3.4.0 的发行信息。这些发行说明包含下列各节:
本发行版中的新增内容 | WebSphere Business Integration Adapters API 和运行时 |
产品修订历史 | 已知问题和变通方法 |
硬件和软件需求 | 文档更新 |
安装、迁移、升级和配置 |
注意:关于本产品的重要信息可以在发布这些发行说明之后发布的技术支持 Flash 中获得。可以在 WebSphere Business Integration Support Web 站点 http://www.ibm.com/websphere/integration/wbiserver/support 找到它们。单击您感兴趣的产品;如果提供了 Flash,则它们位于自助 > 解决问题 > Flash(提醒)。
此发行版支持 JDK 1.4.2,并且包括下列新功能和改进:
此版本的适配器支持双向(BIDI)语言。
有关适配器和新功能的详细信息,请参阅 Adapter for Web Services User Guide。
在发行版 3.3.0 和 3.4.0 之间,根据客户报告的情况修正了下列问题。
跟踪 号码 |
描述 |
28828 | 在实例化包含必需属性的协议配置元对象时连接器失败。 |
37217 | SOAP 数据处理程序未使用具有属性但是没有子代的元素来填充业务对象。 |
产品文档中包括了硬件和软件需求。有关与这些指南的链接,请参阅安装、迁移、升级和配置信息。
无论您是从 CD 中安装软件,还是从 Passport Advantage 下载软件然后从本地目录中安装它,请参阅《系统安装指南 UNIX 版》或《系统安装指南 Windows 版》以获取更多信息。此指南包括一般迁移、升级和配置信息。
有关特定于此适配器的硬件和软件需求以及配置信息,请参阅 Adapter for Web Services User Guide。
确保将此版本的适配器与 WebSphere Business Integration Adapters 运行时版本 1.8.0 或更高版本配合使用。
WebSphere Business Integration Adapters API .jar 文件和相关联的脚本(对于 Windows(R) 为 CWConnEnv.bat 和 CWODAEnv.bat;对于 UNIX 平台为 CWConnEnv.sh 和 CWODAEnv.sh)是由 WebSphere Business Integration Adapters API 安装的。在安装适配器之前,确保安装了 WebSphere Business Integration Adapters 运行时。如果版本不是 1.8.0 或更高版本,则必须下载最新的 API。本节提供了有关验证 API 版本、下载最新版本以及启用适配器在各种版本的 InterChange Server 和 Adapter Development Kit(ADK)上运行的指示信息。
要检查运行时的版本,应找到清单文件(ProductDir\lib\WBIA.jar)并在适合的 Java JAR 编辑器中打开它。查找下列行:
Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.8.0
Implementation-version 这一行表示已安装的 API 版本。如果版本不是 1.8.0 或更高版本,则必须下载最新的运行时。
要下载最新版本的运行时:
在下载并安装运行时之后,您应当看到下列文件:
lib\WBIA.jar
bin\CWConnEnv.bat(Windows)
bin/CWConnEnv.sh(UNIX)
bin\CWODAEnv.bat(Windows)
bin/CWODAEnv.sh(UNIX)
connectors\messages\CwConnectorAgentMessages.txt
此适配器仅在当前 Adapter Framework V2.6.0 上运行,它处理 InterChange Server V4.2.2 和 V4.3.0。
在本发行版中已经发现了下列问题:
跟踪 号码 |
描述 |
59634 | 对于使用非 TLO(顶级业务对象)的同步侦听器请求,Web Service 适配器不能生成响应。 |
59584 | 当以非编码格式指定目标 URL 时,Web Service 适配器不能将 HTTP(S) 请求发送至包含非英语字符的 URL。解决此问题的方法是使用编码 URL。 |
59428 | 当以非编码格式指定目标 URL 时,Web 服务描述语言(WSDL)ODA 不能通过包含非英语字符的 URL 来访问 WSDL 文件。但是,WSDL ODA 可以使用包含国际化字符的本地路径来成功地处理文件。解决此问题的方法是,
应该使用编码 URL,或者将 WSDL 文件保存至本地存储器并使用本地路径而不是 HTTP URL。 |
23993 |
当 WSDL ODA 遇到多种直接插入模式时(这些模式互相导入,但是未提供模式位置),它将记录警告或错误;但是,正确生成了业务对象。 要解决此问题,将每种模式分隔到单独的文件中,并更新导入/包含,以包含适当的文件位置。使用带有适当文件位置的 import 语句将这些单独的模式文件导入 WSDL 文档中。 |
24662 |
当将 WebSphere MQ 5.3 CSD03 用作 JMS 提供程序时,在将消息从输入队列移至进行中队列之后,适配器的 JMS 侦听器不能读取消息体。这是 WebSphere MQ 应用程序存在的一个问题。 |
不适用 | 在 XML ODA 中,不支持将 BIDI 字符作为业务对象和业务对象属性名的一部分。因此,在生成了基于 XML/XSD 文件(其属性名/元素名称具有 BIDI 字符)的业务对象模板之后,必须对包含非拉丁字符的所有业务对象名和属性名进行重命名,以使它们只包含拉丁字符。 |
产品文档没有通过 CD 或者电子产品分发的形式包括为产品软件包的一部分。可以在下列信息中心找到此产品的文档:
http://www.ibm.com/websphere/integration/wicserver/infocenter
http://www.ibm.com/websphere/integration/wbicollaborations/infocenter(对于协作)
http://www.ibm.com/websphere/integration/wbiadapters/infocenter
要获得产品文档,请访问 Web 站点,并下载您正在使用的发行版的最新文档集。遵循“信息中心”页面上提供的指示信息来完成安装。