IBM WebSphere Adapter for SAP Software V6.1.0.3 说明

本文档包含下列部分:
增强功能和修订
新增和修改的连接器属性
升级说明

此表列示了修订包 V6.1.0.3 中的增强功能和修订。
增强功能
#CRAPAR标题详细信息
186210支持对 BAPI 调用的异步入站处理
症状:适配器在前发行版以前支持入站的同步处理。适配器现在可支持事件的异步处理。
解决方案:通过此修订包,适配器支持用于入站处理的 tRFC 和 qRFC 异步协议。当使用这些协议时,客户机 SAP 应用程序不会等待来自适配器的响应。请查看适配器文档以获得关于此功能的更多信息。
295726支持对 BAPI 调用的异步出站处理
症状:适配器在前发行版以前支持出站的同步处理。适配器现在可支持事件的异步处理。
解决方案:通过此修订包,适配器支持用于出站处理的 tRFC 和 qRFC 异步协议。当使用这些协议时,适配器不会等待来自 SAP 服务器的响应。请查看适配器文档以获得关于此功能的更多信息。
修订
#CRAPAR标题详细信息
196046JR28793虽然用户名和密码是基本属性,但它们存储在高级配置部分
症状:当将 SAP Adapter 6.1 与 WebSphere Message Broker 配合使用时,虽然用户名和密码是必需属性,但它们存储在适配器属性的高级配置部分。
解决方案:因为这些是必需属性,所以它们已被移到基本属性部分。
296221JR29142SAP 适配器 V6.1.0 未嵌入应用程序异常
症状:当 BAPI 出站调用失败时,SAP 适配器 V6.1.0 未将应用程序异常嵌入 FaultException。
解决方案:已修订适配器以处理此问题。当 BAPI 出站调用失败时,适配器将应用程序异常包括在 FaultException 中。
396094JR28825ALE 入站失败,并且生成 NullPointerException
症状:在应用 WPS 修订(对于 APAR JR26701,它的版本是 6.0.2.1)后,ALE 入站事件失败,并且生成 NullPointerException。
解决方案:已修订适配器以处理此问题。
496095JR28827在出站事件失败后,对 SAP 的后续调用失败
症状:在某些情况中,当来自 SAP 适配器的出站 BAPI 调用失败时,它会锁定底层表,并且所有后续 BAPI 调用都失败。
解决方案:已修订适配器以处理该问题。当对 SAP 的出站调用失败时,适配器现在会调用 BAPI_TRANSACTION_ROLLBACK,这使底层资源能够在 SAP 内释放。


下表列示了修订包 V6.1.0.2 中的增强功能和修订。
增强功能
#CRAPAR标题详细信息
195574在 ALE 传递接口中支持类属 IDoc 类型
症状:适配器预计要处理的每个 IDoc 均需要一个独立的 IDoc 定义。如果 ALE 传递接口用于处理多个不同的 IDoc 类型,那么这可能会变得不实用。
解决方案:ALE 传递接口支持类属 IDoc 定义。适配器可使用此定义来处理任何 IDoc 类型。对象定义中的 IDoc 类型字段用于指示 IDoc 类型。
295236在 QISS 接口中支持定制 SAP 函数模块
症状:QISS 接口使用 SAP 的 RFC_READ_TABLE 函数模块来检索数据。在某些 SAP 系统上,RFC_READ_TABLE 失败并造成 SAP 短转储。这导致适配器抛出“程序 SAPLSDTX 的 ASSIGN 语句中出错”异常。
解决方案:要解决此问题,SAP OSS #758278 注释中建议创建和使用定制函数模块(而非 RFC_READ_TABLE)。一旦在 SAP 系统上创建此定制函数模块,当运行外部服务向导时,您就可以输入定制函数模块名。适配器将在运行时期间使用此定制函数模块。
395594在 ALE 传递接口中支持入站分割 IDoc 包
症状:ALE 传递入站接口不支持分割 IDoc 包。
解决方案:提供选项将入站包中的每个 IDoc 作为单独的业务对象进行发送。
495622为 ALE 入站操作传播事务标识(事件标识)
症状:业务对象中未填充事务标识(事件标识)。
解决方案:在业务对象中填充事务标识(事件标识)。


下表列示了修订包 V6.1.0.1 中的增强功能和修订。
增强功能
#CRAPAR标题详细信息
此修订包中未提供任何增强功能。
修订
#CRAPAR标题详细信息
186215支持没有部分解析的 IDOC 流
症状:ALE 入站接口不支持将 IDOC 作为未解析的流进行处理。
解决方案:ALE 入站接口支持将入局 IDOC 作为未解析的流进行处理。Enterprise Metadata Discovery 向导(EMD)也已经修改,以便生成提供此支持需要的工件。
289221支持安全网络连接(SNC)
症状:适配器不支持安全网络连接。
解决方案:已增加此支持。
390957可配置失败事件的重试次数
症状:适配器继续不断地重新传递失败事件。
解决方案:ActivationSpec 中增加了一个新属性 FailedEventRetryLimit。FailedEventRetryLimit 允许您在适配器将某个事件标记为“失败”之前设置该适配器将尝试传递该事件的次数。这只适用于正常重试所产生的故障;不包括数据绑定错误和函数选择器错误。如果适配器或服务器关闭后重新启动,那么适配器将启动刷新并且按指定的次数传递该事件,不会将适配器关闭前尝试的任何重试次数计算在内。


下表列示了新增和修改的连接器属性
#版本添加或修改属性位置
1 6.1.0.2 添加 customFunctionName - 定制函数名 SAPSQIInteractionSpec/customFunctionName
2 6.1.0.1 添加 SncMode - 安全网络连接(SNC)方式,0 表示关闭,1 表示打开SAPManagedConnectionFactory/SAPActivationSpecWithXID
3 6.1.0.1 添加 SncMyname - 安全网络连接(SNC)名称SAPManagedConnectionFactory/SAPActivationSpecWithXID
4 6.1.0.1 添加 SncPartnername - 安全网络连接(SNC)合作伙伴,例如,p:CN=R3, O=ABC-TES, C=EN SAPManagedConnectionFactory/SAPActivationSpecWithXID
5 6.1.0.1 添加 SncQop - 安全网络连接(SNC)安全级别,有效值为 1 到 9SAPManagedConnectionFactory/SAPActivationSpecWithXID
6 6.1.0.1 添加 SncLib - 表示提供 SNC 服务的库的路径SAPManagedConnectionFactory/SAPActivationSpecWithXID
7 6.1.0.1 添加 FailedEventRetryLimitSAPActivationSpec


要升级至修订包 V6.1.0.3,请执行下列步骤。
1. 在继续之前,确保已按照下载链接中的“安装指示信息”部分执行操作。
2. 如果需要将修订包用于 EMD,那么请删除 WebSphere Integration Developer 中的连接器项目、导入新的 RAR 文件并应用特定于企业信息系统(EIS)的依赖项文件。
   a. 打开 SCA 模块的 Java 构建路径,然后除去项目选项卡中选择的连接器项目。
   b. 打开依赖项编辑器并除去连接器项目。
   c. 从工作空间中删除连接器项目。
   d. 导入新的 RAR 文件。在需要时,根据特定于 EIS 特定应用程序的信息添加任何依赖项文件。
   e. 打开 SCA 模块的 Java 构建路径,然后选择项目选项卡中选择的连接器项目。
   e. 打开依赖项编辑器,如果还不存在该连接器项目,那么添加该项目,然后选中使用模块进行部署
3. 如果需要更新 WebSphere Process Server 上已部署的应用程序,那么请执行下列步骤:
   a. 在 WebSphere Process Server 管理控制台上,对相应的应用程序选择更新
   b. 选择单一模块,并使用相对路径作为 RAR 文件的名称 - CWYAP_SAPAdapter.rar 和 CWYAP_SAPAdapter_Tx.rar。
   c. 在本地文件系统上单击浏览,以选择包含更改的已更新 RAR 文件。
   d. 在其余步骤中选择缺省值并单击完成。这将确保不更改现有配置,而仅更新 JAR 文件。


2008 年 6 月 30 日下午 6:00
© 2008 IBM Corporation. Proprietary and Confidential. All Rights Reserved.