使用 Oracle E-Business Suite 配接器的 WCF 服務模型概觀
Microsoft BizTalk Adapter for Oracle E-Business Suite 會將 Oracle E-Business Suite 系統公開為 WCF 服務。 若要在 Oracle E-Business Suite 成品上執行作業,例如叫用預存程式,您可以在配接器上叫用作業,進而在 Oracle E-Business Suite 上執行作業。 您的程式碼可作為配接器所呈現之 WCF 服務的用戶端。
在 Windows Communication Foundation (WCF) 服務模型中,用戶端與服務之間存在的服務合約會以 .NET 介面表示,而作業會以這個介面上的方法表示。 Oracle E-Business 配接器和 WCF 提供工具,可讓您從配接器公開的中繼資料產生此介面。 這些工具也會建立 WCF 用戶端類別,可用來叫用服務介面中公開的作業。 用戶端應用程式可以呼叫 WCF 用戶端類別的方法,以叫用配接器上的作業。
下一節說明如何使用 WCF 服務模型搭配 WCF 用戶端叫用作業。
使用 WCF 用戶端叫用 Oracle E-Business Suite 上的作業
若要使用 WCF 服務模型在 Oracle E-Business 配接器上叫用作業,您必須先產生目標作業的 WCF 用戶端類別。 然後,您可以建立這個類別的實例、WCF 用戶端,並呼叫其方法來在 Oracle E-Business Suite 上執行這些作業。
在 Oracle E-Business 配接器上叫用作業
產生 WCF 用戶端類別和協助程式程式碼。 使用新增配接器服務參考 Visual Studio 外掛程式或 ServiceModel 中繼資料公用程式工具 (svcutil.exe) 來產生以您想要運作之 Oracle E-Business Suite 成品為目標的 WCF 用戶端類別。 如需如何產生 WCF 用戶端的詳細資訊,請參閱 產生 WCF 用戶端或 Oracle E-Business 解決方案成品的 WCF 服務合約。
建立 WCF 用戶端實例並設定 WCF 用戶端。 設定 WCF 用戶端牽涉到指定用戶端將使用的系結和端點位址 (連線 URI) 。 您可以在程式碼中以命令方式執行此動作,或在組態中以宣告方式執行此動作。 下列程式碼會建立 WCF 用戶端,以 Oracle E-Business Suite 的[客戶介面] 應用程式並行程式為目標。 它也會設定 Oracle E-Business Suite 的認證。 WCF 用戶端會從組態初始化。
ConcurrentPrograms_ARClient client = new ConcurrentPrograms_ARClient("OracleEBSBinding_ConcurrentPrograms_AR"); //picking the binding and address from app.config client.ClientCredentials.UserName.UserName = "myuser"; client.ClientCredentials.UserName.Password = "mypassword";
注意
您可以在程式碼中指定用戶端系結和端點位址,或在 app.config 組態檔中宣告。 上述程式碼片段使用後者。 如需如何使用任一種方法的詳細資訊,請參閱 設定 Oracle E-Business Suite 的用戶端系結。
開啟 WCF 用戶端。
client.Open();
在步驟 2 中建立的 WCF 用戶端上叫用方法,以在 Oracle E-Business Suite 上執行作業。 下列程式碼會在 Oracle E-Business Suite 的「客戶介面」應用程式中叫用Customer Interface並行程式。
string Result = client.RACUST(null, null, null, description, null, recipro_cust, org_id);
RACUST 是客戶介面並行程式的實際名稱。 客戶介面 是並行程式的易記名稱。
關閉 WCF 用戶端。
client.Close();