連接器需要階層式商業物件。 最上層商業物件包含其值為目的地 URL 字串、MIME 類型資料、商業物件字首,以及要求及回應商業物件的屬性。
圖 6 說明 IBM WebSphere Business Integration Adapter for XML 之最上層商業物件的必要基本結構。
例如,如果您建立兩個商業物件 XMLApp_CustCreateRequest 及 XMLApp_CustCreateResponse,則為連接器定義的最上層商業物件可能看起來如下:
XMLApp_CustCreate URL String MimeType String BOPrefix String Response XMLApp_CustCreateResponse Request XMLApp_CustCreateRequest
請使用「商業物件設計程式」來建立要求及回應商業物件。 建立最上層商業物件定義,並新增必要的屬性,以及要求及回應商業物件。 然後配置連接器以支援最上層商業物件。
最上層商業物件必須至少具有一個 URL 字串、MIME 類型、BOPrefix、要求商業物件及回應商業物件的屬性。 這些屬性的每一個都必須標示 IsRequired = True。
表 6 說明最上層商業物件的必要屬性。
請參閱後續章節,以取得詳細資訊。
屬性 | 類型 | 說明 |
---|---|---|
URL | 字串 | 目的地 URL。 |
MimeType | 字串 | 用於交易的 MIME 類型。 |
BOPrefix | 字串 | 與 MIME 類型搭配使用以建立 XML 資料處理常式的實例。 |
Response | 商業物件 | 代表回應訊息的商業物件。請參閱"要求及回應商業物件"。 |
Request | 商業物件 | 代表要求訊息的商業物件。在最上層商業物件中,請將此屬性置於回應商業物件的屬性之後。 |
URL 字串定義商業物件中資料的目的地,以及用於傳遞資料的通訊協定。 字串包含整個目的地,並包括通訊協定 (如 HTTP 和 HTTPS);因此不需要其他指定通訊協定的屬性。
連接器使用 URL 字串來開啟到目的地 URL 的連線。 當連線開啟時,連接器會使用 URL 字串來建立適當通訊協定處理常式的實例。
例如,字串 http://www.ibm.com 指定使用 HTTP 通訊協定,並且會建立「HTTP 通訊協定處理常式」的實例。
MIME 類型定義傳遞給 URL 之資料的內容類型及格式。 連接器會使用 MIME 類型來呼叫適當的資料處理常式。Meta 物件識別 MIME 類型/BOPrefix 組合的資料處理常式實例。 如果資料處理常式實作方式僅處理一個 (種) MIME 類型,則子項 Meta 物件中的 BOPrefix 屬性是選用性的。在最上層商業物件中,它是必要的。
依預設,連接器會預期 MIME 類型為 text/xml,但是您可以配置連接器使用其他 MIME 類型。
連接器會搭配使用 BOPrefix 及 MimeType 屬性來呼叫適當的資料處理常式實例。 此屬性是必要的,以保證商業物件名稱的唯一性。 例如,您可以在不同的應用程式中,使用兩個「採購單」商業物件:AppA_PO 及 AppB_PO。
當從 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 文件的應用程式特有資訊。
因此,最好是為要處理的每一種資料類型,建立您自己的商業物件。 在商業物件中,僅提供應用程式所需的資料,以及資料處理常式所需的資訊。 然後,您便可以將這些商業物件併入最上層連接器商業物件。