使用 Oracle E-Business Suite 配接器的 WCF 通道模型概觀
若要在 Microsoft BizTalk Adapter for Oracle E-Business Suite 上叫用作業,您的程式碼會作為 WCF 用戶端,並將輸出作業傳送至配接器。 在 WCF 通道模型中,您的程式碼會透過通道傳送要求訊息,在配接器上叫用作業。
若要叫用輸入作業,例如使用配接器所提供的 輪詢 作業接收輪詢型資料變更訊息,您的程式碼會作為 WCF 服務,並從配接器接收輸入作業。 換句話說,您的程式碼會透過通道從配接器接收要求訊息。
本節中的主題提供搭配 WCF 通道模型使用 Oracle E-Business 配接器的概觀。
WCF 通道模型概觀
用戶端和服務會交換 SOAP 訊息來通訊。 WCF 通道模型是這個訊息交換的低階抽象概念。 它提供介面和類型,可讓您使用稱為通道堆疊的分層通訊協定堆疊來傳送和接收訊息。 堆疊的每一層都是由通道所組成,而每個通道都是從 WCF 系結建立。 在最低層是傳輸通道。 傳輸通道會實作服務與用戶端之間的基礎傳輸機制,並將每個訊息呈現給較高層 (,最後取用的應用程式) 為 System.ServiceModel.Message。 WCF 訊息類別是 SOAP 訊息 的抽象概念。 WCF 提供數個稱為通道圖形的通道介面,可建立基本 SOAP 訊息交換模式的模型,例如要求-回復或單向。 WCF 傳輸系結提供一或多個通道圖形的實作,較高層可用來傳送和接收訊息。 如需 WCF 通道模型的詳細資訊,請參閱 中的 https://go.microsoft.com/fwlink/?LinkId=82614 。
Oracle E-Business 配接器是 WCF 自訂傳輸系結,會將 Oracle E-Business Suite 成品公開為 WCF 服務。
Oracle E-Business Suite 配接器支援的通道圖形
配接器會實作下列 WCF 通道圖形:
IRequestChannel (System.ServiceModel.Channels.IRequestChannel) 。 IRequestChannel介面會實作要求-回復訊息交換的用戶端。 您可以使用 IRequestChannel 來執行您想要取用回應的作業,例如在介面資料表上執行 SELECT 查詢。
IOutputChannel (System.ServiceModel.Channels.IOutputChannel) 。 此圖形會實作單向訊息交換的用戶端。 您可以使用 IOutputChannel 來叫用不需要取用回應的作業,例如呼叫沒有 OUT 參數的程式。
重要
配接器對 Oracle 用戶端的所有基礎呼叫都是同步的。 這包括對 Oracle 用戶端的呼叫,這是透過 IOutputChannel叫用作業的結果。 當您使用 IOutputChannel時,配接器會捨棄從 Oracle 用戶端收到的回應。
IInputChannel (System.ServiceModel.Channels.IInputChannel) 。 此圖形會實作單向訊息交換的服務端。 您可以使用 IInputChannel 從配接器接收輸入訊息。
如同任何 WCF 系結,Oracle E-Business 配接器會使用處理站模式來提供應用程式程式碼的通道。 您可以使用 Microsoft.Adapters.OracleEBSBinding 物件來建立的實例:
System.ServiceModel.ChannelFactory <IRequestChannel >提供IRequestChannel通道,可用來叫用介面卡上的要求-回應作業。
System.ServiceModel.ChannelFactory <IOutputChannel >提供IOutputChannel通道,您可以用來在配接器上叫用單向作業。
System.ServiceModel.IChannelListener <IInputChannel >提供IInputChannel通道,可讓您用來從配接器接收輸入訊息。
在 WCF 通道模型中建立 Oracle 企業商務解決方案的訊息
在 WCF 中 ,System.ServiceModel.Channels.Message 類別提供 SOAP 訊息的記憶體標記法。 您可以叫用靜態Message.Create方法來建立Message實例。
SOAP 訊息有兩個重要部分,您必須在建立 訊息 實例以傳送至 Oracle E-Business 配接器時指定。
訊息動作是 SOAP 訊息標頭的一部分字串。 訊息動作會識別應在 Oracle E-Business Suite 上叫用的作業。 以下顯示指定用來在 Oracle E-Business Suite 中叫用Customer Interface並行程式的訊息動作:
ConcurrentPrograms/AR/RACUST
。訊息本文包含作業的參數資料。 訊息本文是由格式正確的 XML 所組成,對應至 Oracle E-Business 配接器所預期的訊息架構,以進行要求的作業。 下列訊息本文會指定要叫用 Customer Interface 並行程式的要求訊息。
<RACUST xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/ConcurrentPrograms/AR"> <Description>Customer Interface Program</Description> <StartTime></StartTime> <CREATE_RECIPROCAL_CUSTOMER>Yes</CREATE_RECIPROCAL_CUSTOMER> <ORG_ID>203</ORG_ID> </RACUST>
如需作業的 Oracle E-Business 配接器訊息架構和訊息動作的相關資訊,請參閱 BizTalk Adapter for Oracle E-Business Suite 的訊息和訊息架構。
Create方法已多載,並提供許多不同的選項來提供訊息本文。 下列程式碼示範如何使用XmlReader來提供訊息本文來建立訊息實例。 在此程式碼中,訊息本文會從檔案讀取。
XmlReader readerIn = XmlReader.Create("ConcProgRequest.xml");
Message messageIn = Message.CreateMessage(MessageVersion.Default,
"ConcurrentPrograms/AR/RACUST",
readerIn);
其中,ConProgRequest.xml 包含要求訊息。
重要
您必須在訊息實例中提供 訊息 動作。 這通常是在建立 Message 實例時完成。