共用方式為


使用 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 實例時完成。

另請參閱

使用 WCF 通道模型開發 Oracle E-Business Suite 應用程式