Scott Woodgate's OutBursts

Announcing: VS.NET Adapter Framework Wizard Sample and Socket Adapter Sample

How about a little: File-New-BizTalk Server Adapter Framework Wizard inside VS.NET

This wizard makes it super easy to getting started with the adapter base classes by stepping you through the creation of both receive and send-side adapters in C# including the receive handler/end-point properties and it uses VS outlining to hide the parts of the adapter framework that are less relevant to building adapters.  All in all this wizard makes it easier to get building with the adapter framework so if you plan to build an adapter grab it today.

Also included are an example socket-based adapter and a whitepaper describing how to use the wizard and building adapters.  This deliverable complements the super detailed whitepaper that Kevin released earlier this month.

Please read the readme, and in particular you must have the SDK Refresh installed as it contains the updated base-classes. Needless to say full source code to the adapter wizard is included and let me know if there are any issues with this first release that need to be addressed. Get it here.

Thanks to Boudewijn van der Zwan from Unisys for his collaboration with me on this one.  Now go build some adapters and enter the developer competition by August 31st (time is ticking), odds are high that you will win big!

Published Thursday, July 08, 2004 3:17 PM by scottwoo

Comments

 

Jody said:

I think that SocketMsgContext.cs is missing from the Adapter Wizard zip file.
July 8, 2004 5:15 PM
 

Raju - harik98@hotmail.com said:

I tried creating new project using the Wizard.
On Clicking finish it gives the error Microsoft.samples.base.adapter dll not found.
Also on compilation it gives the following list of errors
Please help on this.
F:\KN-Biztalk\Project\Dev\KNEDIAdapter\Run-Time\FileReceive\FileAdapterProperties.cs(27): The type or namespace name 'Samples' does not exist in the class or namespace 'Microsoft' (are you missing an assembly reference?)
F:\KN-Biztalk\Project\Dev\KNEDIAdapter\Run-Time\FileReceive\FileAdapterProperties.cs(34): The type or namespace name 'ConfigProperties' could not be found (are you missing a using directive or an assembly reference?)
F:\KN-Biztalk\Project\Dev\KNEDIAdapter\Run-Time\FileReceive\FileReceiver.cs(60): The type or namespace name 'ControlledTermination' could not be found (are you missing a using directive or an assembly reference?)
F:\KN-Biztalk\Project\Dev\KNEDIAdapter\Run-Time\FileTransmit\FileTransmitAdapterBatch.cs(42): The type or namespace name 'AsyncTransmitterBatch' could not be found (are you missing a using directive or an assembly reference?)
F:\KN-Biztalk\Project\Dev\KNEDIAdapter\Run-Time\FileTransmit\FileTransmitAdapterBatch.cs(47): The type or namespace name 'AsyncBatchedTransmitter' could not be found (are you missing a using directive or an assembly reference?)
F:\KN-Biztalk\Project\Dev\KNEDIAdapter\Run-Time\FileTransmit\FileTransmitAdapterBatch.cs(148): The type or namespace name 'TransmitterMessage' could not be found (are you missing a using directive or an assembly reference?)
July 8, 2004 9:23 PM
 

Scott (MSFT) said:

Do you have the SDK refresh installed?
July 8, 2004 9:42 PM
 

Patrick Wellink said:

July 9, 2004 2:56 AM
 

Patrick Wellink said:

July 9, 2004 2:56 AM
 

Raju said:

Yes I have installed SDK refresh.
The installation of MSI was also successful.
But when used the wizard for new project it gave an Microsoft.Samples.BizTalk.Adapters.BaseAdapter
not found error.
July 9, 2004 12:05 AM
 

Raju said:

After Compiling the Base Adapter project it is working OK. Thanks
July 9, 2004 1:05 AM
 

mark said:

Hi, I have the same problem as Raju. Where is the base adapter is it the sample file adaper? Tryed to use this but the wizard stil complains. If i manually add a ref to this assembly if accepts the namespace but complains about:...does not implement inherited abstract member 'Microsoft.Samples.BizTalk.Adapters.BaseAdapter.ReceiverEndpoint.Add(string...
July 9, 2004 7:50 AM
 

mark said:

Found it, it was the adapers\common dir.
July 9, 2004 8:09 AM
 

Scott (MS) said:

If it doesn't install right go compile the base adapter sample after you have installed the SDK refresh and it should work. If not let me know.
July 9, 2004 12:52 PM
 

Raju said:

I tried to create custom adapter using the wizard.After creating the files i tried to add the adapter to Biztalk admin.It gives the following error :
"Another object with same key properties already exists."

I check the registry for the duplicate record i could not find anything.

Please help.


July 12, 2004 10:22 PM
 

Felipe Roque said:

Hello!

Cool, how about a wizard for custom pipeline components and for custom funtoids? That would also be very nice,developers could save a lot of time.

Thank you.

Felipe.
July 13, 2004 12:15 AM
 

Mitesh said:

Hi,

I too have the same problem of the missing assembly.

Any solution to it?
July 13, 2004 1:52 AM
 

Daniel L. said:

Hi,

nice timing with the vs.net adapter wizard, since I will have to develop my first adapter without any deeper knowledge of BizTalk.

Well, I realized that the receiver framework uses the System.Threading.ThreadPool for receive Operations. Since most of the adapters are in-process I wondered wether this could become a bottleneck in the app. Other articles always tell me that ThreadPool is for very short-lived, nonblocking operations only, since the overall number of threads limited per process is limited. I was thinking about creating dedicated threads for receive operations.

Does the Adapter wizard generate really well-performing code, or will it just give me some working code and a good place to start, with improvements needed for high-perf adapters? Would/does MS use this architecture for their adapters?

Thanks.
July 14, 2004 3:20 AM
 

Mike Taulty's Weblog said:

July 14, 2004 2:01 PM
 

Daniel Losch said:

Really helpful. BizTalk rocks.
July 21, 2004 12:59 PM
 

Rajesh Sharma said:

I used the wizard to create an adapter for Inproc (not isolated) host. When wizard generates the code after successfully going through all the pages, I get following error message "Exception from HRESULT: 0x80041FE0". I don't think I am entering any wrong data in the wizard dialog boxes. When I look at the folders, it creates only a csharp project file.
For Isolated host the wizard creates the code successfully.
Any help?? Thanks,
July 22, 2004 12:20 PM
 

Geek Noise said:

July 22, 2004 6:52 PM
 

Geek Noise said:

July 22, 2004 11:13 PM
 

Boudewijn van der Zwan said:

Rajesh,

I tried to reproduce this but I couldn't. Please send a message to adapterwizard@hotmail.com telling me exactly all the steps you took. Thanks.
July 22, 2004 10:52 PM
 

ds said:

I just downloaded the Adapter Framework Wizard from http://home.comcast.net/~sdwoodgate/DevelopingaBizTalkServer2004SocketAdapterWithTheAdapterWizard2.zip
and I noticed that a number of files in DevelopingaBizTalkServer2004SocketAdapterWithTheAdapterWizard2.zip file are password protected.

Is this the latest version of the Adapter Framework? Is the password in one of the readme files?
August 1, 2004 10:16 AM
 

Scott Woodgate (MSFT) said:

Use WinZip 9 to unpack it. There is something weird with the built in Windows XP zip that causes this problem.
August 1, 2004 12:55 PM
 

Raj said:

Hi guys,
Did anyone find any answer on that ""Another object with same key properties already exists." error when trying to create a new adapter out of the wizard?
Iam stuck with the same error.Any help would be much appreciated
Thanks
Raj
August 4, 2004 3:34 PM
 

CaPo's Integration adventures said:

September 30, 2004 3:38 AM
 

Sachin Kulkarni's Weblog said:

February 11, 2005 1:52 AM
 

NISHIL said:

Well I was searching documents to create custom adapter but dint succeed, so I thought ill create one....
April 17, 2006 12:12 PM
 

Scott Woodgate s OutBursts Announcing VS NET Adapter Framework | Paid Surveys said:

May 29, 2009 5:23 PM
New Comments to this post are disabled

© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Microsoft
Page view tracker