連接器商業物件結構

連接器需要階層式商業物件。 最上層商業物件包含其值為目的地 URL 字串、MIME 類型資料、商業物件字首,以及要求及回應商業物件的屬性。

圖 6 說明 IBM WebSphere Business Integration Adapter for XML 之最上層商業物件的必要基本結構。

圖 6. 最上層商業物件的基本結構


例如,如果您建立兩個商業物件 XMLApp_CustCreateRequest 及 XMLApp_CustCreateResponse,則為連接器定義的最上層商業物件可能看起來如下:

XMLApp_CustCreate
  
 URL      String
 MimeType String
 BOPrefix String
 Response XMLApp_CustCreateResponse
 Request  XMLApp_CustCreateRequest
 

請使用「商業物件設計程式」來建立要求及回應商業物件。 建立最上層商業物件定義,並新增必要的屬性,以及要求及回應商業物件。 然後配置連接器以支援最上層商業物件。

最上層商業物件的必要屬性

最上層商業物件必須至少具有一個 URL 字串、MIME 類型、BOPrefix、要求商業物件及回應商業物件的屬性。 這些屬性的每一個都必須標示 IsRequired = True

表 6 說明最上層商業物件的必要屬性。 請參閱後續章節,以取得詳細資訊。

表 6. 最上層 XML 商業物件的必要屬性
屬性 類型 說明
URL 字串 目的地 URL。
MimeType 字串 用於交易的 MIME 類型。
BOPrefix 字串 與 MIME 類型搭配使用以建立 XML 資料處理常式的實例。
Response 商業物件 代表回應訊息的商業物件。請參閱"要求及回應商業物件"
Request 商業物件 代表要求訊息的商業物件。在最上層商業物件中,請將此屬性置於回應商業物件的屬性之後。

註:
連接器需要您至少將一個屬性設為索引鍵屬性。 不過,連接器不需要將所有屬性都設為索引鍵。

URL

URL 字串定義商業物件中資料的目的地,以及用於傳遞資料的通訊協定。 字串包含整個目的地,並包括通訊協定 (如 HTTP 和 HTTPS);因此不需要其他指定通訊協定的屬性。

連接器使用 URL 字串來開啟到目的地 URL 的連線。 當連線開啟時,連接器會使用 URL 字串來建立適當通訊協定處理常式的實例。

例如,字串 http://www.ibm.com 指定使用 HTTP 通訊協定,並且會建立「HTTP 通訊協定處理常式」的實例。

MIME 類型

MIME 類型定義傳遞給 URL 之資料的內容類型及格式。 連接器會使用 MIME 類型來呼叫適當的資料處理常式。Meta 物件識別 MIME 類型/BOPrefix 組合的資料處理常式實例。 如果資料處理常式實作方式僅處理一個 (種) MIME 類型,則子項 Meta 物件中的 BOPrefix 屬性是選用性的。在最上層商業物件中,它是必要的。

依預設,連接器會預期 MIME 類型為 text/xml,但是您可以配置連接器使用其他 MIME 類型。

BOPrefix

連接器會搭配使用 BOPrefix 及 MimeType 屬性來呼叫適當的資料處理常式實例。 此屬性是必要的,以保證商業物件名稱的唯一性。 例如,您可以在不同的應用程式中,使用兩個「採購單」商業物件:AppA_PO 及 AppB_PO。

註:
最上層商業物件中的 BOPrefix 屬性不同於 XML 資料處理常式中子項 Meta 物件中的 BOPrefix 屬性。 如需 XML 資料處理常式子項 Meta 物件的詳細資訊,請參閱 Data Handler Guide。

當從 URL 傳回 XML 串流時,XML 資料處理常式會將 XML 串流中的根元素名稱對映到商業物件定義 BOPrefix_name。根元素名稱的值一律置於 BOPrefix 值之後。

例如,如果在 XML 文件中有根元素 <Customer>,且 BOPrefix=AppA,BOPrefix_Name 為 AppA_Customer。

要求及回應商業物件

要求及回應商業物件包含要傳遞到目的地 URL 的實際資料。 當連接器收到最上層商業物件時,僅會將資料輸入要求商業物件;在回應商業物件中則是輸入的資料從目的地 URL 傳回的資料。

請注意以下在最上層商業物件中定義要求及回應商業物件的準則:

商業物件需符合資料處理常式的需求

雖然您可以將任何 WebSphere Business Integration Adapter 商業物件併入連接器的最上層封套商業物件中, 但是內含的商業物件遞送資料的形式,必須符合用於轉換資料的資料處理常式需求。

例如,對於 BySize 資料處理常式而言,商業物件定義必須為每一個商業物件屬性的 MaxLength 屬性內容指定值。 對於 XML 資料處理常式而言,商業物件定義必須包含使資料處理常式能產生 XML 文件的應用程式特有資訊。

因此,最好是為要處理的每一種資料類型,建立您自己的商業物件。 在商業物件中,僅提供應用程式所需的資料,以及資料處理常式所需的資訊。 然後,您便可以將這些商業物件併入最上層連接器商業物件。

請參閱 Data Handler Guide,以取得每一個資料處理常式的特定資訊。

Copyright IBM Corp. 1997, 2003