Developing Applications By Using the WCF Service Model

Windows Communication Foundation (WCF) provides a programming model called the WCF service model to connect to the Microsoft BizTalk Adapter for Oracle E-Business Suite. The service model was added to WCF to address, in part, some of the limitations of the WCF channel programming model.

The WCF service model uses familiar .NET paradigms to hide the complexities of exchanging SOAP message over a channel. The service model accomplishes this simplification by reading the entire SOAP message into memory before copying the information into .NET data structures. Loading long messages into memory may not be practical for some applications. In these cases, developers should use the WCF channel model. For more information about using the WCF channel model, see Developing Applications by Using the WCF Channel Model.

At the lowest level, the WCF presents the WCF channel model in which clients invoke operations on a service by exchanging SOAP messages over a channel established between client and service endpoints. The WCF channel model exposes data types and methods that enable you to operate directly on the WCF channel architecture. The WCF channel model provides you with direct control over the contents of the SOAP messages you create and over the way both your application and the Oracle E-Business adapter consume them. However, creating well-formed SOAP messages to send over a channel and validating the reply messages returned can be a detailed and exacting task.

The WCF service model uses proxy classes to invoke operations on a target service or to receive operations from a client. The Oracle E-Business adapter exposes the Oracle E-Business Suite as a WCF service on which you can invoke operations.

  • The proxy class used to invoke operations on a target service is called a WCF client class. This class models the operations exposed by a service as .NET methods with strongly-typed parameters. By using the WCF service model, you can invoke the operations exposed by the Oracle E-Business adapter as .NET methods on the WCF client. For more information about WCF clients, see "WCF Client Overview" at

You can use either of the following tools to generate a WCF client class and associated helper code from the service metadata that the Oracle E-Business adapter exposes:

  • The ServiceModel Metadata Utility Tool (svcutil.exe), which ships with WCF.

  • The Add Adapter Service Reference Visual Studio Plug-in, which ships with the Oracle E-Business adapter and is integrated with the Visual Studio design experience. This tool presents a standard Microsoft Windows interface that provides powerful browsing and searching capabilities on operations that the adapter exposes. For more information about how to generate a WCF client, see Generating a WCF Client or a WCF Service Contract for Oracle E-Business Solution Artifacts.

Other Resources