Module 13: WCF Receive Adapters

Overview Lesson 1: Introduction to WCF Receive Adapters Lesson 2: Configuring a WCF Receive Adapter Lesson 3: Using the WCF Service Publishing Wizard

Lesson 1: Introduction to WCF Receive Adapters Windows Communication Foundation (WCF) WCF 4.0 Web Service Standards Support WCF Receive Adapter Scenarios Scenario for Publishing a BizTalk WCF Service WCF Receive Adapter Architecture

Windows Communication Foundation (WCF) What is Windows Communication Foundation? What Is a Service? I mplementation of discrete business operations Communicate via messages Shares message schema and contract, not classes I mplementation of discrete business operations Communicate via messages Shares message schema and contract, not classes WCF is a framework for building service-oriented applications Included in.NET Framework 3.5 and later WCF is a framework for building service-oriented applications Included in.NET Framework 3.5 and later Built-in Features of WCF Transport Protocols Security Features Configuration Transactions Service Metadata Transport Protocols Security Features Configuration Transactions Service Metadata

WCF 4.0 Web Service Standards Support WS-* Specifications WS-Addressing WS-AtomicTransaction WS-Coordination WS-MetadataExchange WS-Policy WS-ReliableMessaging WS-SecureConversation WS-Security WS-SecurityPolicy WS-Trust WS-Addressing WS-AtomicTransaction WS-Coordination WS-MetadataExchange WS-Policy WS-ReliableMessaging WS-SecureConversation WS-Security WS-SecurityPolicy WS-Trust WS-I Profiles WS-I Basic Profile, Datatypes WS-I Basic Profile 1.1 WS-I Basic Profile 1.2 WS-I Basic Profile 2.0 WS-I Basic Secure Profile 1.1 Reliable Message Exchange Reliable, Secure Message Exchange WS-I Basic Profile, Datatypes WS-I Basic Profile 1.1 WS-I Basic Profile 1.2 WS-I Basic Profile 2.0 WS-I Basic Secure Profile 1.1 Reliable Message Exchange Reliable, Secure Message Exchange

WCF Receive Adapter Scenarios Microsoft BizTalk Server 2010 Receive POs via WCF Service Receive POs from ERP system Partner Supply Chain System Receive POs from DB Oracle EBS 11.5 SQL Server 2008

Receiving Order Processing Messages Scenario for Publishing a BizTalk WCF Service Process Orders Orchestration Customer Manufacturing Accounting Vendor

Receive Location Receive Adapter Receive Pipeline MessageBox Database WCF Receive Adapter Architecture PO Message BizTalk Service Host Channel Layer

Steps for Configuring a WCF Receive Adapter Types of WCF Adapters Selecting Message Content Specifying the Format of a Selected Node Configuring Two-way Receive Ports Lesson 2: Configuring a WCF Receive Adapter

Select a WCF Adapter 1 1 Steps for Configuring a WCF Receive Adapter Set Binding Properties 3 3 Specify an Endpoint Address 2 2

Types of WCF Adapters AdapterHost TypeDescription WCF-NetTcp In-process Uses the WCF NetTcpBinding, allows integration with WCF Clients WCF-WsHttp Isolated Uses the WCF WsHttpBinding, allows integration with compatible WS-* stacks WCF-NetNamedPipe In-process Uses WCF NetNamedPipes binding – single machine binding WCF-BasicHttp Isolated Uses the WCF BasicHttpBinding, allows integration with WS_BaseProfile1 compatible stacks WCF-NetMsmq In-process Uses the WCF NetMsmqBinding, allows integration with WCF MSMQ clients (MSMQ adapter for legacy – msmqintegration Binding disallowed) WCF-Custom In-processAllows you to use any binding WCF-CustomIsolated Isolated Allows you to use any Binding in an Isolated host (only receive).

Selecting Message Content OptionDescription SOAP:Body The XML of the SOAP body is published to the MessageBox. This is the default setting. SOAP:Envelope The entire SOAP message is published, preserving encryption and digital signatures. XPath Node selected from the SOAP body is published to the MessageBox.

Specifying the Format of a Selected Node ValueEffect Xml OuterXml value of selected node is published to the MessageBox Base64 Binary value is published Hex Binary value is published String String value will be published (if Xml encoded, it will be converted back to Xml) Required for the Path option

Configuring Two-way Receive Ports Response Message Template Option A two-way receive port is required to return a response message Default is to send BizTalk Message as the body of the response A two-way receive port is required to return a response message Default is to send BizTalk Message as the body of the response Can define an XML template for wrapping the message Use the bts-msg-body element to specify the location of the message body Can specify encoding Can define an XML template for wrapping the message Use the bts-msg-body element to specify the location of the message body Can specify encoding

Demonstration: Creating a net.tcp Receive Location In this demonstration, you will see how to: Configure the WCF-NetTcp Adapter Submit a message with a WCF call

Lesson 3: Using the WCF Service Publishing Wizard Steps for Publishing a WCF Service Configuring an Orchestration for Publishing Running the WCF Service Publishing Wizard Demonstration: Publishing a WCF Service Publishing Schemas as WCF Services

Publishing an Orchestration as a WCF Web Service Provides access to a business process Exposes receive ports as WCF Web services Generates a WSDL document for clients Can be called by any service-enabled client Provides access to a business process Exposes receive ports as WCF Web services Generates a WSDL document for clients Can be called by any service-enabled client Steps for Publishing a WCF Service Build the BizTalk project 1 1 Configure receive port and location 2 2 Run the WCF Service Publishing Wizard 3 3 Configure WCF service application pool 4 4

Configuring an Orchestration for Publishing Orchestration Receive Ports By default logical receive ports have internal scope Orchestration must have at least one logical receive port configured as a public port The public port enables an orchestration to accept external data By default logical receive ports have internal scope Orchestration must have at least one logical receive port configured as a public port The public port enables an orchestration to accept external data

Running the WCF Service Publishing Wizard WCF Publishing Wizard Exposes a BizTalk application’s functionality to external systems Creates WCF.svc, ServiceDescription.xml, and web.config files Offers the option to publish WSDL that describes message types, ports, and data type definitions Exposes a BizTalk application’s functionality to external systems Creates WCF.svc, ServiceDescription.xml, and web.config files Offers the option to publish WSDL that describes message types, ports, and data type definitions

Demonstration: Publishing a WCF Service In this demonstration, you will see how to: Configure an Orchestration for Publication Run the WCF Service Publishing Wizard Configure an Application Pool

Publish a schema To expose an XML schema to an external business process Declare the Web services and Web methods Can select one-way or request-response schemas Published schema is not tied to an orchestration To expose an XML schema to an external business process Declare the Web services and Web methods Can select one-way or request-response schemas Published schema is not tied to an orchestration Publishing Schemas as a WCF Services

Lab: Receiving Messages with a WCF Adapter Exercise 1:Publish a Schema as a Web Service Exercise 2:Consume and Test the Web Service