這些版本注意事項涵蓋 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 (短訊) 區段。
本節列示此版本的新增及加強功能。
如需詳細資料,請參閱 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 (WBIA) API 1.5.0 版或更新版本來執行配接器。
若要檢查 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,請:
在下載並安裝 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
若要讓配接器使用各種版本的 ADK 或 InterChange Server,請遵循下列適當的程序:
在 CWConnEnv.sh 中,將 CWVERSION 變數設為 4.X。
set CWVERSION="4.X"
在 CWConnEnv.sh 中,將 CWVERSION 變數設為 4.1.X。
set CWVERSION="4.1.X"
在 bin/CWODAEnv.sh 中,將 CWVERSION 變數設為 4.1.X。
set CWVERSION="4.1.X"
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 修補程式來重新編譯連接器。 |
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 | 如果您是使用「簡體中文」語言環境,中文字將無法輸入在「目的地畫面」輸入欄位。
暫行解決方法: 您可以使用這兩個暫行解決方法之一
|
不論是光碟或電子產品分送之產品套件中,並不包括產品文件。您可以在下列 InfoCenter 中找到本產品的文件:
http://www.ibm.com/websphere/integration/wicserver/infocenter
http://www.ibm.com/websphere/integration/wbiadapters/infocenter
若要取得產品文件,請造訪該網站並下載適合您目前所用版本的最新文件集。請遵循 InfoCenter 網頁上提供的指示來完成安裝。