WebSphere Business Integration Adapters for Windows 2.3.1 版的版本注意事項

這些版本注意事項涵蓋 WebSphere Business Integration Adapters for Windows 2.3.1 版的版本資訊。包含下列各節:
本版新增的功能 WebSphere Business Integration Adapters API
產品修正歷史 已知的問題及暫行解決方法
軟硬體需求 文件更新
安裝、移轉、升級及配置資訊

附註:在公佈這些版本注意事項之後,發行的 Technical Support Flashes (技術支援短訊) 中可能提供關於本產品的重要資訊。如需這些資訊支援,請造訪 WebSphere Business Integration 支援網站,網址為: http://www.ibm.com/websphere/integration/wbiserver/support。選取感興趣的元件區域並搜尋 flash (短訊) 區段。

本版新增的功能 

本節列示此版本的新增及加強功能。

WebSphere Business Integration Adapters 組織架構

WebSphere Business Integration Adapters API

如需詳細資料,請參閱 Connector Development Guide for Java

產品修正歷史

WebSphere Business Integration Adapters API

CR
號碼
說明
12271 支援自訂商業物件處理常式。已加入具有方法 doVerbForCustom 的新介面 CWCustomBOHandlerInterface。 使用自訂商業物件處理常式的配接器必須實作這個介面。此外, 商業物件動詞特定應用程式專用的資訊必須變更,以便 CBOH=custom_BO_Handler_class_name (確定使用完整路徑名稱, 亦即,以 "com" 作為路徑開頭)。
17975 當捕捉到異常狀況時,WebSphere Business Integration Adapters API 方法現在會記載異常狀況訊息,並且列印堆疊追蹤。
19664

已加入新內容 EventStoreFactory。如果它設成連接器的事件儲存區 Factory 實例, 比方說,com.crossworlds.connectors.JDBC.JDBCEventStoreFactoryInstance, 它將用來取得事件儲存區;如果它未設成該實例, API 將嘗試根據套件資訊,來建置事件儲存區 Factory 實例類別名稱。 此外,TRUESTRING 及 FALSESTRING 已加入到 CWConnectorAttrType, 且寫在程式中的 "true" 字串已換成這個字串。

19665 如果指定整數以外的任何資料給 pollQuantity,pollForEvents 將傳回 FAIL。
19673 有一個採用定界字元及內容名稱的新方法 getAppText 已加入至 CWConnectorBusObj。根據內容名稱及定界字元, 將傳回特定應用程式專用的資訊中的內容值。
22702 有一個新方法 setDEEId 已加在 CWConnectorBusObj 類別中。 它會將 ObjectEventId 屬性設成事件 ID:

public void setDEEId(String eventid)

傳回 AttributeNotFoundException、AttributeValueException。

22877 有一個新方法 getEventStore 已加入至 CWConnectorAgent 類別。 這個方法會從連接器取得事件儲存區,然後傳回 CWConnectorEventStore 物件:

public CWConnectorEventStore getEventStore()

預設 pollForEvents 方法已做了變更,以便能夠呼叫這個方法。 此外,這個方法有一個預設實作。首先它會查看 EventStoreFactory 內容。 EventStoreFactory 內容必須設成 CWConnectorEventStoreFactory 介面實作。 若是如此,則這個類別的實例即會建置,並取得已從連接器取得的事件儲存區。 如果未設定內容,方法將嘗試從連接器套件建置實作名稱。

連接器具有置換這個方法並提供自己方法的選項。如果連接器想要使用預設建構子以外的建構子,這個選項很有用。

23369 從 pollForEvents 內呼叫 doVerbFor 時, 來自 doVerbFor 方法呼叫的 APPRESPONSETIMEOUT 不會終止連接器。若要啟用, 狀態必須最多傳送至 pollforEvents,且 pollForEvents 必須傳回 APPRESPONSETIMEOUT。
23406 EXISTS 及 RETRIEVEBYCONTENT 動詞常數已加入至 CWConnectorConstants 類別。
23612 對於屬性或商業物件層次的特定應用程式專用的資訊, 沒有值的標籤 (如 ior_file_name=;poa_name=server) 將失敗, 並顯示「發生異常狀況,找不到如此的元素」。這已經修好了。
23620 並不會以原子性 (或同步處理) 步驟, 來配置 meta 物件及建立資料處理常式。當多個執行緒進入 WebSphere Business Integration Adapters API 時,這將導致與資料處理常式基礎類別有關的問題。 現在會同步處理用來呼叫 setConfigMO 的程式碼。此外,僅呼叫方法一次, 因此後續的呼叫會繼續建立資料處理常式。

軟硬體需求

軟硬體需求已併入在產品文件中。如需那些手冊的鏈結, 請參閱安裝、移轉、升級及配置資訊

安裝、移轉、升級及配置資訊

無論您是從 CD 安裝軟體,或者從 Passport Advantage 下載後再從本端目錄進行安裝,皆請參閱適當的手冊:

這些手冊也會併入移轉、升級及配置資訊。

WebSphere Business Integration Adapters API

請確定您是搭配 WebSphere Business Integration Adapters (WBIA) API 1.5.0 版或更新版本來執行配接器。

驗證 WBIA API 的版本

若要檢查 WBIA API 版本,請尋找 manifest 檔 (ProductDir/lib/WBIA.jar) 並以適合的 Java JAR 編輯器開啟它。尋找下列行:

Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.5.0
Implementation version indicates the current version of WBIA API.

如果版本不是 1.5.0 或以上,您必須下載最新的 WBIA API。

下載 WBIA API

若要下載最新版的 WBIA API,請:

  1. 前往 http://www.ibm.com
  2. 按一下 Support and downloads (支援與下載) 標籤。
  3. 在 Downloads (下載) 標題下,按一下 All downloads & drivers (所有的下載及驅動程式)。
  4. 在 Enter search terms (輸入搜尋詞彙) 欄位中,鍵入 "wbia api" 並按一下 Submit (送出)。

在下載並安裝 API 之後,您應該會看到下列檔案:

lib/WBIA.jar
lib/WBIA/3.0.0/WBIA.jar
lib/WBIA/4.0.0/WBIA.jar
lib/WBIA/4.1.1/WBIA.jar
bin/CWConnEnv.sh
bin/CWODAEnv.sh
connectors/messages/CwConnectorAgentMessages.txt

讓配接器能夠使用舊版的 Adapter Development Kit 和 InterChange Server

若要讓配接器使用各種版本的 ADK 或 InterChange Server,請遵循下列適當的程序:

InterChange Server 4.0.1 版、4.1.0 版、ADK 2.0.x 版

在 CWConnEnv.sh 中,將 CWVERSION 變數設為 4.X。

set CWVERSION="4.X"
InterChange Server 4.1.x 版(4.1.0 除外)、ADK 2.1.x 版

在 CWConnEnv.sh 中,將 CWVERSION 變數設為 4.1.X。

set CWVERSION="4.1.X"
對 InterChange Server 4.0.1 和 4.1.x 版以及 ADK 2.0.x 和 2.1.x 版執行「物件探查代理程式」(ODA)

在 bin/CWODAEnv.sh 中,將 CWVERSION 變數設為 4.1.X。

set CWVERSION="4.1.X"

已知的問題及暫行解決方法

WebSphere Business Integration Adapters 執行時期

CR
號碼
問題
23373 執行利用 Connector Development Kit (CDK) 2.1 版 (含有 2.3.1 CDK 建置) 建置的連接器時,將傳回執行時期錯誤。

暫行解決方法:利用 2.1 CDK 修補程式來重新編譯連接器。

23374 執行利用 Connector Development Kit (CDK) 2.0 版 (含有 2.3.1 CDK 建置) 建置的連接器時,將傳回執行時期錯誤。

暫行解決方法:利用 2.0 CDK 修補程式來重新編譯連接器。

23482

由於 WebSphere MQ 限制,所以配接器無法將 100 MB 以上的 XML 訊息文字寫入 MQ 佇列以進行處理。當 JMS 是傳輸, 且 WMQI 或 WAS 是整合分配管理系統時,就會發生這個問題。 配接器執行時期會將商業物件轉換為可以變得非常大的 XML 訊息。

暫行解決方法:避免在每一個商業物件中建立 25000 個以上的子項物件。

24108 執行利用 Connector Development Kit (CDK) 2.2 版 (含有 2.3.1 CDK 建置) 建置的連接器時,將傳回執行時期錯誤。

暫行解決方法:利用 2.2 CDK 修補程式來重新編譯連接器。

 WebSphere Business Integration Adapter 工具

CR
號碼
說明
19283 不要將 WebSphere Business Integration Adapters 工具安裝到名稱中有空格的目錄 (例如,C:\Program Files)。將工具安裝到含有空格的目錄時, 將使工具無法使用「系統管理程式」。

暫行解決方法:當「安裝程式」提示您輸入安裝位置時, 請選取名稱中沒有空格的目錄。如果要將 WebSphere Business Integration Toolset 外掛程式安裝到現有的 WebSphere Application Developer Integration Edition 安裝目錄, 請確定安裝目錄沒有空格。

22302 如果您啟動其中一個設計程式工具,且傳回了「找不到類別」錯誤, 則您必須啟動「系統管理程式」,再重新啟動工具。 在最初啟動工具之後,「系統管理程式」不必保持執行狀態。

WebSphere Business Integration Adapters 安裝程式

CR
號碼
說明
11983, 12221, 13382, 17788, 20169 4.2.1.0 版的「元件選擇」畫面中的多個問題已經修好了。 它們包括:
  • 每次選擇後,就會重新整理畫面
  • 當收合元件時,無法讀取畫面中的文字
  • 選取母項元件不會選取所有子元件。
  • 選取一個子元件就會選取所有子元件
20679 如果 InterChange Server 是您的整合分配管理系統, 請確定您是在安裝 ICS 的目錄中安裝 WebSphere Business Integration Adapters 2.3.1 版的配接器。
19283 請參閱上面的說明
22937

由於配接器名稱變更,在 2.3.0 版上安裝 WebSphere Business Integration Adapters 2.3.1 版可能會導致多餘的桌面捷徑。 例如,舊版 Adapter for e-Mail 已建立一個名為 "EMail Connector" 的捷徑。將配接器升級至 2.3.1 版會建立新的捷徑名稱 "e-Mail Connector"。

暫行解決方法: 以手動方式移除舊的桌面捷徑,以避免混淆。例如,用滑鼠右鍵按一下「開始」>「開啟所有使用者」。導覽至「程式集」> IBM WebSphere Business Integration Adapters > 配接器 > 連接器,然後刪除 "EMail Connector" 捷徑。

23604 「系統管理程式」啟動 Script 具有多餘的反斜線 ( \ ), 這會導致「系統管理程式」無法載入某些工具外掛程式檔案。

暫行解決方法:以手動方式移除 startcsm.bat 檔中多餘的反斜線 ( \ ),這個檔案位在 ProductDir\bin 目錄 (其中 ProductDir 是安裝產品的目錄)。請修改 startcsm.bat 檔案中的第三行:

set WSWB_PATH=C:\WebSphereAdapters\Tools\WSWB203\

方法是將它變更為:

set WSWB_PATH=C:\WebSphereAdapters\Tools\WSWB203

其中 C:\WebSphereAdapters\Tools\WSWB203 是 WebSphere Studio Workbench 2.0.3 的安裝位置。

24554 當您在英文以外的語言環境中執行任何解除安裝程式時,GUI 可能會顯示無法讀取的字元。

暫行解決方法:請使用無聲解除安裝。從指令行,移至 _uninstall 目錄,然後輸入下列指令:

java -cp ./uninstall.jar run -silent

協力廠商安裝程式

CR
號碼
問題
23778 「語言選擇」畫面上的標題文字可能會被截斷,取決於您選擇的語言環境而定。 「語言選擇」對話框無法改變大小。
24013 如果您是使用「簡體中文」語言環境,中文字將無法輸入在「目的地畫面」輸入欄位。  

暫行解決方法: 您可以使用這兩個暫行解決方法之一

  • 在執行安裝程式之前,建立產品安裝資料夾。 安裝程序進行期間,請在「目的地畫面」按一下「瀏覽」, 來選取您已建立的資料夾。 
  • 如果「安裝程式」安裝在系統上,您可以執行下列 Java 指令,迫使「安裝程式」使用另一版的 Java Runtime Environment:

    java -cp setup.jar run

    您可以使用 Sun JRE 1.4.0 產品,它可以從 Sun Microsystems 網站安裝。這項產品可讓您使用簡體中文。

文件更新

不論是光碟或電子產品分送之產品套件中,並不包括產品文件。您可以在下列 InfoCenter 中找到本產品的文件:

若要取得產品文件,請造訪該網站並下載適合您目前所用版本的最新文件集。請遵循 InfoCenter 網頁上提供的指示來完成安裝。

Copyright IBM Corp. 1997, 2003