Module 14:WCF Send Adapters

Overview

Lesson 1: Introduction to WCF Send Adapters

Lesson 2: Consuming a Web Service

Lesson 3: Consuming Services from Orchestrations

Lesson 4: WCF Send Adapter Security

Lesson 1: Introduction to WCF Send Adapters

WCF Send Adapter Scenarios

WCF Send Adapter Architecture

WCF Send Adapter Scenarios

Microsoft BizTalk Server 2010

Send Invoice to Web Service

Send PO to Vendor and to Purchasing DB

Partner Supply Chain System

Query Warehouse DB for inventory

Oracle DB

Vendor Web Service

SQL Server 2008

Atomic TransactionAtomic Transaction

Send PortSend Port

SendPipeline

SendPipeline

MessageBoxDatabase

WCF Send Adapter Architecture

PO Message

MapMap

Send AdapterSend Adapter

WCF ChannelWCF Channel

Channel LayerChannel Layer

Steps for Consuming a Web Service

The BizTalk WCF Service Consuming Wizard

Demonstration: Consuming a Web Service

Lesson 2: Consuming a Web Service

Running the BizTalk WCF Service Consuming WizardRunning the BizTalk WCF Service Consuming Wizard

Consumes a WSDL document

Generates XML schemas and orchestration type definitions

Generates bindings files

Generated files added to a Visual Studio 2010 BizTalk Project

Consumes a WSDL document

Generates XML schemas and orchestration type definitions

Generates bindings files

Generated files added to a Visual Studio 2010 BizTalk Project

Steps for Consuming a Web Service

Add Generated Item : Consume WCF ServiceAdd Generated Item : Consume WCF Service11

Complete the BizTalk WCF Service Consuming WizardComplete the BizTalk WCF Service Consuming Wizard22

Build and Deploy the ProjectBuild and Deploy the Project33

Import Generated Binding FileImport Generated Binding File44

Add Generated Item : Consume WCF Service

Add Generated Item : Consume WCF Service11

The BizTalk WCF Service Consuming Wizard

Complete the BizTalk WCF Service Consuming WizardComplete the BizTalk WCF Service Consuming Wizard22

Demonstration: Consuming a Web Service

In this demonstration, you will see how to:

Run the WCF Service Consuming Wizard

Deploy the Generated Schemas

Import the Generated WCF Send Port Binding

Steps for Consuming a Service from an Orchestration

Mapping Operations to Actions

Formatting the Request Message

Selecting Content from the Response Message

Demo: Consuming a Service from an Orchestration

Lesson 3: Consuming Services from Orchestrations

Calling a Web Service from an Orchestration Calling a Web Service from an Orchestration

A web service is represented as an orchestration send port

Each web service operation maps to a send port operation

Type definitions created by WCF Service Consuming Wizard

A web service is represented as an orchestration send port

Each web service operation maps to a send port operation

Type definitions created by WCF Service Consuming Wizard

Steps for Consuming a Service from an Orchestration

Create a new configured port in the orchestrationCreate a new configured port in the orchestration11

Define message variables of the generated typesDefine message variables of the generated types22

Construct the web service request messageConstruct the web service request message33

Connect send and receive shapes to the new portConnect send and receive shapes to the new port44

Mapping Operations to Actions

SOAP Action HeaderSOAP Action Header

Required header in request message

Value that corresponds to the service operation being called

Configure with a simple string if send port always calls the same operation

Otherwise, configure with a list of operation names and corresponding actions

Required header in request message

Value that corresponds to the service operation being called

Configure with a simple string if send port always calls the same operation

Otherwise, configure with a list of operation names and corresponding actions

Formatting the Request Message

Outbound Message BodyOutbound Message Body

Template OptionTemplate Option

Requires a template that defines a wrapper for the BizTalk message body

Use the bts-msg-body element to specify the location of BizTalk message body

Can specify encoding of XML node

Resulting XML is used as SOAP body

Requires a template that defines a wrapper for the BizTalk message body

Use the bts-msg-body element to specify the location of BizTalk message body

Can specify encoding of XML node

Resulting XML is used as SOAP body

Default is to send BizTalk Message as body of the SOAP message

Use the Template option to customize the SOAP message body

Default is to send BizTalk Message as body of the SOAP message

Use the Template option to customize the SOAP message body

Selecting Content from the Response Message

Option Description

SOAP:BodyThe XML of the SOAP body is published to the MessageBox. This is the default setting.

SOAP:EnvelopeThe entire SOAP message is published, preserving encryption and digital signatures.

PathNode selected from the SOAP body is published to the MessageBox.

Propagate fault messagePropagate fault message

Option to publish detailed fault messages to the MessageBox

Default is a generic error message

Option to publish detailed fault messages to the MessageBox

Default is a generic error message

Demo: Consuming a Service from an Orchestration

In this demonstration, you will see how to:

Set up a Web Service Call in the Orchestration Designer

Configuring WCF Send Adapter Security

Configuring WCF-Custom Send Adapter Security

Lesson 4: WCF Send Adapter Security

Configuring WCF Send Adapter Security

Transport Specific AdaptersTransport Specific Adapters

Username CredentialsUsername Credentials

Can assign a set of static credentials to be used for all messages

Use Single Sign-On to allow BizTalk to look up user’s credentials for each message

Can assign a set of static credentials to be used for all messages

Use Single Sign-On to allow BizTalk to look up user’s credentials for each message

Select a Security mode

Configure properties required by mode

Select a Security mode

Configure properties required by mode

Configuring WCF-Custom Send Adapter Security

WCF-Custom Security OptionsWCF-Custom Security Options

Behavior Tab

Use for other types of client credentials

Must configure WCF endpoint behavior

Behavior Tab

Use for other types of client credentials

Must configure WCF endpoint behavior

Credentials Tab

User name and password

Single Sign-On

Proxy credentials for http(s)

Credentials Tab

User name and password

Single Sign-On

Proxy credentials for http(s)

Lab: Calling a Web Service from an Orchestration

Exercise 1: Set up a web service call in the Orchestration Designer

Exercise 2: Configure the Orchestration and Send Ports

Exercise 3: Test the Orchestration