Module 14:WCF Send Adapters

Overview

Lesson 1: Introduction to WCF Send AdaptersLesson 2: Consuming a Web ServiceLesson 3: Consuming Services from OrchestrationsLesson 4: WCF Send Adapter Security

Lesson 1: Introduction to WCF Send Adapters

WCF Send Adapter ScenariosWCF 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 Transaction

Send Port

SendPipeline

MessageBoxDatabase

WCF Send Adapter Architecture

PO Message

Map

Send Adapter

WCF Channel

Channel Layer

Steps for Consuming a Web ServiceThe BizTalk WCF Service Consuming WizardDemonstration: Consuming a Web Service

Lesson 2: Consuming a Web Service

Running the BizTalk WCF Service Consuming Wizard

Consumes a WSDL documentGenerates XML schemas and orchestration type definitionsGenerates bindings filesGenerated files added to a Visual Studio 2010 BizTalk Project

Steps for Consuming a Web Service

Add Generated Item : Consume WCF Service1

Complete the BizTalk WCF Service Consuming Wizard2

Build and Deploy the Project3

Import Generated Binding File4

Add Generated Item : Consume WCF Service1

The BizTalk WCF Service Consuming Wizard

Complete the BizTalk WCF Service Consuming Wizard2

Demonstration: Consuming a Web Service

In this demonstration, you will see how to:Run the WCF Service Consuming WizardDeploy the Generated SchemasImport the Generated WCF Send Port Binding

Steps for Consuming a Service from an OrchestrationMapping Operations to ActionsFormatting the Request MessageSelecting Content from the Response MessageDemo: Consuming a Service from an Orchestration

Lesson 3: Consuming Services from Orchestrations

Calling a Web Service from an Orchestration

A web service is represented as an orchestration send portEach web service operation maps to a send port operationType definitions created by WCF Service Consuming Wizard

Steps for Consuming a Service from an Orchestration

Create a new configured port in the orchestration1

Define message variables of the generated types2

Construct the web service request message3

Connect send and receive shapes to the new port4

Mapping Operations to Actions

SOAP Action Header

Required header in request messageValue that corresponds to the service operation being calledConfigure with a simple string if send port always calls the same operationOtherwise, configure with a list of operation names and corresponding actions

Formatting the Request MessageOutbound Message Body

Template Option

Requires a template that defines a wrapper for the BizTalk message bodyUse the bts-msg-body element to specify the location of BizTalk message bodyCan specify encoding of XML nodeResulting XML is used as SOAP body

Default is to send BizTalk Message as body of the SOAP messageUse 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 message

Option to publish detailed fault messages to the MessageBoxDefault 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 SecurityConfiguring WCF-Custom Send Adapter Security

Lesson 4: WCF Send Adapter Security

Configuring WCF Send Adapter Security

Transport Specific Adapters

Username Credentials

Can assign a set of static credentials to be used for all messagesUse Single Sign-On to allow BizTalk to look up user’s credentials for each message

Select a Security modeConfigure properties required by mode

Configuring WCF-Custom Send Adapter Security

WCF-Custom Security Options

Behavior TabUse for other types of client credentialsMust configure WCF endpoint behavior

Credentials TabUser name and passwordSingle Sign-OnProxy 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