IBM WebSphere Adapter for SAP Software 6.1.0.3 版注意事項

本文件包含下列幾節：
加強功能及修正程式
新增及修改的連接器內容
升級注意事項

此表格列出修正套件 6.1.0.3 版中的加強功能及修正程式。
加強功能
#CRAPAR標題詳細資料
186210支援 BAPI 呼叫的非同步入埠處理程序。
症狀：在前版次之前，配接器支援入埠同步化程序。配接器現在可以支援非同步事件處理。
解決方案：在此修正套件中，配接器可以支援入埠處理程序的 tRFC 及 qRFC 非同步通訊協定。使用這些通訊協定時，用戶端 SAP 應用程式不會等待來自配接器的回應。 請查看配接器說明文件，以取得此功能的相關資訊。
295726支援 BAPI 呼叫的同步出埠處理程序。
症狀：在前版次之前，配接器支援出埠同步化程序。配接器現在可以支援非同步事件處理。
解決方案：在此修正套件中，配接器可以支援出埠處理程序的 tRFC 及 qRFC 非同步通訊協定。使用這些通訊協定時，配接器不會等待來自 SAP 伺服器的回應。 請查看配接器說明文件，以取得此功能的相關資訊。
修正程式
#CRAPAR標題詳細資料
196046JR28793使用者名稱及密碼儲存在進階配置區段中，但它們是基本內容。
症狀：在 SAP Adapter 6.1 中，若和 WebSphere Message Broker 一起使用時， 使用者名稱及密碼會儲存在配接器內容的進階配置區段中，但使用者名稱和密碼是必要內容。
解決方案：由於這些是必要內容，因此會將這些移動到基本內容區段。
296221JR29142SAP 配接器 6.1.0 版沒有內含應用程式異常。
症狀：在 SAP 配接器 6.1.0 版中，當 BAPI 出埠呼叫失敗時，FaultException 中沒有內含應用程式異常。
解決方案：已修正配接器解決此問題。當 BAPI 出埠呼叫失敗時，配接器會在 FaultException 中包括應用程式異常。
396094JR28825Ale 入埠失敗，並出現 NullPointerException。
症狀：套用 WPS 修正程式 (6.0.2.1 for APAR JR26701) 之後， ALE 入埠事件失敗，並出現 NullPointerException。
解決方案：已修正配接器解決此問題。
496095JR28827出埠事件失敗之後，後續對 SAP 的呼叫也失敗。
症狀：在部分範例情況中，當來自 SAP 配接器的出埠 BAPI 呼叫失敗時， 它會鎖定基礎表格，造成所有後續的 BAPI 呼叫失敗。
解決方案：已修正配接器解決此問題。現在當出埠呼叫 SAP 失敗時， 配接器會呼叫 BAPI_TRANSACTION_ROLLBACK，以便釋放 SAP 內的基礎資源。


此表格列出修正套件 6.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 入埠作業的交易 ID (事件 ID)
症狀：交易 ID (事件 ID) 未移入商業物件中。
解決方案：交易 ID (事件 ID) 已移入商業物件中。


此表格列出 6.1.0.1 版修正套件的加強功能及修正套件。
加強功能
#CRAPAR標題詳細資料
此修正套件沒有任何加強功能。
修正程式
#CRAPAR標題詳細資料
186215支援沒有進行局部剖析的 IDOC 串流。
症狀：ALE 入埠介面不支援將 IDOC 作為未剖析串流進行處理。
解決方案：ALE 入埠介面支援將收到的 IDOC 作為未剖析串流進行處理。Enterprise Metadata Discovery 精靈 (EMD) 已修改為產生所需的構件，以提供此支援。
289221支援安全網路連線 (SNC)
症狀：配接器不支援安全網路連線。
解決方案：已新增此支援。
390957失敗事件的可配置重試
症狀：配接器會繼續不停地重新遞送失敗事件。
解決方案：已將新內容 FailedEventRetryLimit 新增至 ActivationSpec。FailedEventRetryLimit 可讓您設定在將事件標記為 FAILED 之前配接器嘗試遞送事件的次數。這僅適用於正常重試的失敗；排除資料連結錯誤及函數選取器錯誤。如果配接器或伺服器已關閉並重新啟動，則配接器會重新工作並按指定的次數遞送事件，該計數不包含配接器關閉之前的重試。


此表格列示新增及已修改的連接器內容
#版本已新增或修改內容位置
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 到 9 SAPManagedConnectionFactory/SAPActivationSpecWithXID
6 6.1.0.1 新增 SncLib - 提供 SNC 服務之檔案庫的路徑 SAPManagedConnectionFactory/SAPActivationSpecWithXID
7 6.1.0.1 新增 FailedEventRetryLimit SAPActivationSpec


若要升級至修正套件 6.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.