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 クライアントを生成する方法の詳細については、「 Oracle E-Business Solution Artifacts の WCF クライアントまたは WCF サービス コントラクトを生成する」を参照してください。
WCF クライアント インスタンスを作成し、WCF クライアントを構成します。 WCF クライアントの構成には、クライアントが使用するバインディングとエンドポイント アドレス (接続 URI) を指定する必要があります。 これは、コード内で命令的に行うか、構成で宣言的に行うことができます。 次のコードでは、Oracle E-Business Suite の売掛金アプリケーションの Customer Interface 同時実行プログラムを対象とする WCF クライアントを作成します。 また、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";
Note
コードでクライアント バインドとエンドポイント アドレスを指定するか、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 は、Customer Interface 同時実行プログラムの実際の名前です。 Customer Interface は、同時実行プログラムのフレンドリ名です。
WCF クライアントを終了します。
client.Close();