1. Welcome to GDC’05 Riyadh, Saudi Arabia

2. GDC-402 Custom BizTalk2004 Adapters
Mohammad Junaid Ahsan Senior Consultant
Microsoft

3. Custom BizTalk2004 Adapters Agenda
Session Objectives & Pre-requisites
Introduction to Adapters
BizTalk Adapter Framework
Adapter Development Drill-down
Design-Time Experience
Run-Time Experience
Adapter Registration
Debugging Adapters
References

4. Custom BizTalk2004 Adapters Agenda
Session Objectives & Pre-requisites
Introduction to Adapters
BizTalk Adapter Framework
Adapter Development Drill-down
Design-Time Experience
Run-Time Experience
Adapter Registration
Debugging Adapters
References

5. Session Objectives Introduce BizTalk2004 Adapter Framework
Provide an overview of Adapter development

6. Pre-requisites Some Familiarity with BizTalk2004
.Net development using C#
OOP and use of Interfaces

7. Custom BizTalk2004 Adapters Agenda
Session Objectives & Pre-requisites
Introduction to Adapters
BizTalk Adapter Framework
Adapter Development Drill-down
Design-Time Experience
Run-Time Experience
Adapter Registration
Debugging Adapters
References

8. Introduction to Adapters Problem-space Background
E-Commerce
Web Server
Accounting
Order
Management
CRM
ERP
Logistics
Sales Force
Automation

9. Introduction to Adapters Background
E-Commerce
Web Server
Accounting
Order
Management
CRM
ERP
Logistics
Sales Force
Automation
Message Oriented Middleware
And Message Broker
What are Adapters Why do we need them?

10. BizTalk2004 Adapters Introduction
Microsoft provides some Adapters but relies mostly on its Partner Eco-system to grow the adapter market
Opportunity for Developers
Challenges faced by developers in the past…

11. Custom BizTalk2004 Adapters Agenda
Session Objectives & Pre-requisites
Introduction to Adapters
BizTalk Adapter Framework
Adapter Development Drill-down
Design-Time Experience
Run-Time Experience
Adapter Registration
Debugging Adapters
References

12. BizTalk2004 Adapter Framework An Introduction
Ease of use of adapters
Unified configuration
Unified management
Unified metadata harvesting
Increase applicability of adapters
Make adapters available for pre-packaged solutions / OEM type scenarios
Make adapters “drivable” from any App/UI
Enterprise strength the capabilities and flexibility of the run-time
Batching, streaming, etc.

13. BizTalk2004 Adapter Framework An Introduction (contd)
Installation Time
Adapter registration
Design-time
Configuration
Exposing functionality as services
Run-time Interfaces
Shared Services
Pipeline components
Single Sign-on

14. Introduction to Adapters BizTalk2004 Core Engine Overview
Message
Box

15. Introduction to Adapters BizTalk2004 Core Engine Overview
Orchestration
Transport
Transport
Decrypt
Parse
Resolve
Party
Serialize
Sign
Encrypt
Receive Pipeline
Send Pipeline
Message
Box

16. BizTalk2004 Adapters Introduction
Types of Adapters
Technology Adapters
Application Adapters
Data Adapters

17. BizTalk2004 Adapters Introduction
Terminology
Messaging Ports
Handlers
Locations
Handler
Adapter
Pipeline
Decrypt
Parse
Resolve
Party
Receive Location
Receive Port

18. Custom BizTalk2004 Adapters Agenda
Session Objectives & Pre-requisites
Introduction to Adapters
BizTalk Adapter Framework
Adapter Development Drill-down
Design-Time Experience
Run-Time Experience
Adapter Registration
Debugging Adapters
References

19. Adapter Development Drill-down
Elements of an Adapter
Adapter Registration (Hooking-up with BizTalk)
Design-Time (Adapter Configuration by Admin)
Run-Time (Message Exchange)
Adapter Framework Interfaces
“Don’t call us we will call you”
Asynchronous

20. Adapter Registration Telling BizTalk about your Adapter
Adapter Registry Wizard
Part of SDK/Utilities
Produces a registry file
Registry entries
Design time assembly references
Run-time assembly references
Description of capabilities of adapter

21. Adapter Registration Demo
A Closer look at the Adapter Registry Wizard and the resulting registry file

22. Design Time Interfaces
BizTalk UI
IAdapterConfig
IAdapterConfigValidation
Meta Data Harvesting
IStaticAdapterConfig
Custom UI
IDynamicAdapterConfig

23. Design Time Flow of Execution
BizTalk Explorer
Adapter
IAdapterConfig
IStaticAdapterConfig
IDynamicAdapterConfig
IAdapterConfigValidation
/ Admin
GetConfigSchema()
ValidateConfiguration()
GetServiceOrganization()
GetServiceDescription()
GetSchema()
DisplayUI()
GetSchema()

24. Adapter Design Time Demo
A Closer look at the Adapter Design Time Experience

25. Run Time Messaging Engine Overview

26. Run-Time Message Exchange Patterns
One Way
FILE, HTTP, SharePoint, etc.
Request Response
HTTP, SOAP Receive Adapters
Solicit-Response
HTTP, SOAP Send Adapters
Others…
Loopback
NullSendAdapter
Request-Multi-Response

27. Run-Time Hosting Models
In-Process or Managed Adapter
BTSNTSvc.exe is the host
All send adapters
Asynchronous and stateless design
Out-of-Process or Isolated Adapters
Custom host, e.g. Windows service, Exe, IIS, etc.
Request-Response adapters

28. In-Process Adapter Hosting Model

29. In-Process Considerations Solution Deployment Architecture
Message box
Network Load Balance
Host
Machine
Stored procs
Data
SQL Server Machine
SQL Server Machine (Master)

30. Isolated Adapters

31. Run-Time Interfaces

32. Run-Time Adapter Initialization
Deliver (Receive/Transmit) Handler Properties
Deliver (Receive/Transmit) Locations

33. Run Time In-Process Initialization Flow
Provides IBTSTransportProxy

34. Run Time Isolated Adapter Initialization

35. Run-Time Receiving a Message
All data exchange using Batches of Messages
Adapter Receives a message and submits it to BizTalk using these steps:
GetBatch
Submit (add to batch)
Done (submit batch to BizTalk)

36. Run Time One-way Message Receive Flow

37. Run Time Two-way Message Receive Flow

38. A Closer look at Receive part of a BizTalk2004 Adapter
Receive Adapter Demo
A Closer look at Receive part of a BizTalk2004 Adapter

39. Run-Time Transmit Adapters
Non Blocking vs. Blocking
Batched vs. Batched

40. Run-Time Transmit Adapter Interfaces

41. Run-Time Batched Send Message Flow

42. Run-Time Solicit-Response Message Flow

43. A Closer look at the Transmit part of BizTalk2004 Adapter
Transmit Adapter Demo
A Closer look at the Transmit part of BizTalk2004 Adapter

44. Debugging the Receive and the Transmit Adapters
Debugging Demo
Debugging the Receive and the Transmit Adapters

45. References BizTalk Documentation Kevin Smith’s:
Get the December 2004 documentation refresh –
Kevin Smith’s:
“Microsoft BizTalk2004 Adapters: A Developers Guide”
(see Microsoft site or GotDotNet or blogs.msdn.com/scottwoo)
Adapter Certification Program
Visit GotDotNet and BizTalk blogs
Visit MSDN
Plenty of people blogging… including people from the product team

46. In Closing… Thank you BizTalk2004 is a very powerful product
BizTalk Adapter Framework allows us to create custom adapters, leveraging some of the High Availability/Scalability/Resilience features of BTS2k4
BizTalk2006 – seamless migration
To you developers out there:
“Happy Adapter writing…”

47. © 2005 Microsoft Corporation. All rights reserved
© 2005 Microsoft Corporation. All rights reserved. This presentation is for informational purposes only. MICROSOFT MAKES NO WARRANTIES, EXPRESS OR IMPLIED, IN THIS SUMMARY.