The QuickStart Guide to Building Your First BizTalk Server 2004 Application

This guide walks you through the creation and deployment of a BizTalk Server 2004 application that copies a file from one folder and places it in another using the File Adapter. You will create an empty BizTalk Server project and then work with schemas, maps, functoids, and the built in File adapter. This should take about 30 minutes to complete and is targeted at first time users for BizTalk Server. Check out the Photo Story below to get a 2 minute multimedia overview of what you will be doing.

QuickStart Photo Story! (3MB)

Note: This guide assumes you have a complete installation of BizTalk Server 2004 and a general understanding of Visual Studio .NET development concepts.

Comments

• Anonymous
  November 19, 2004
  I am facing problem in section "Create and Configure Ports".
  When i try to configure "2-Create Receive Location" then at step 6 i cannot set "Receive Handler" property, i can see nothing to select in this property even i cannot write anything....
  
  any idea

• Anonymous
  November 22, 2004
  BizTalkServerApplication is the name of the host for the receive handler. Do you have this host up and running? You also need to ensure you pick the transport type property before setting this property or you will not be able to modify the value.

• Anonymous
  November 22, 2004
  Thanks Luke!
  
  i have successfuly created the application but now when i Drop Instance.xml into C:BTSQuickStartIn then nothing happens... what i am missing to do?

• Anonymous
  November 22, 2004
  Take a look at your application event log. It should tell you what the problem is...or at least give you some clue ;) Feel free to post the error message here for analysis.

• Anonymous
  November 22, 2004
  I can see this error many times:
  ====================================
  Event Type: Error
  Event Source: ENTSSO
  Event Category: Enterprise Single Sign-On
  Event ID: 10589
  Date: 11/23/2004
  Time: 5:28:48 AM
  User: N/A
  Computer: SPIDER
  Description:
  The master secret has not been backed up. If you lose the master secret all the information stored in the SSO system will be lost permanently and your systems may fail to work correctly. Please use the SSO admin tools to back up your master secret.
  
  For more information, see Help and Support Center at http://go.microsoft.com/fwlink/events.asp.
  ===============================================
  

• Anonymous
  November 22, 2004
  Hi Ahmad,
  
  This message just indicates you haven't backed up the master secret. You should back it up. Do the following:
  
  1. Open a command prompt
  2. Browse to C:Program FilesCommon FilesEnterprise Single Sign-On
  3. Type ssoconfig -backupsecret C:ssobackup.bak
  
  W/R/T your problem, ensure you have enabled and enlisted the ports and that your application is running. Thanks!

• Anonymous
  November 24, 2004
  Hi Luke,
  
  I have backed up master secret and ports are enabled & enlisted but still facing the same problem.
  
  i can see Host in BT Admin Console but when i select a host in the list, i can't see any instance of that host, do i have to have instance of host to work my application properly???
  
  what do you mean by "application is running", how i can check wether its running or not? ...
  
  Thanks!!!

• Anonymous
  November 24, 2004
  Hi Luke,
  
  I have backed up master secret and ports are enabled & enlisted but still facing the same problem.
  
  i can see Host in BT Admin Console but when i select a host in the list, i can't see any instance of that host, do i have to have instance of host to work my application properly???
  
  what do you mean by "application is running", how i can check wether its running or not? ...
  
  Thanks!!!

• Anonymous
  November 24, 2004
  Hi Luke,
  
  I have backed up master secret and ports are enabled & enlisted but still facing the same problem.
  
  i can see Host in BT Admin Console but when i select a host in the list, i can't see any instance of that host, do i have to have instance of host to work my application properly???
  
  what do you mean by "application is running", how i can check wether its running or not? ...
  
  Thanks!!!

• Anonymous
  September 08, 2005
  Finally! A sample that is working and that I can learn from. All the samples in the SDK are provided as is, without any explanations and are to a newbie almost worthless.
  
  This worke dfirst time and explained the magic step that I have not been able to do before, to connect the incoming and outgoing parts.

• Anonymous
  October 04, 2005
  This is EXACTLY the kind of starter examples the BizTalk Help and documentation should contain!! Sadly the BizTalk Startup Modules end up being way to complicated for a person starting BizTalk for the first time and end up being utterly USELESS!
  
  This is a GREAT example - something that is simple enough to understand and try and then move on to more complex examples! thanks.
  

• Anonymous
  November 08, 2005
  Excellent example. Thanks!

• Anonymous
  November 08, 2005
  I am using BT 2006, and when I click on Outbound maps, I do not have any options. There does not appear to be any way for me to apply the map that I created.

• Anonymous
  November 10, 2005
  Nevermind. Refresh needed after deploy.

• Anonymous
  December 13, 2005
  Exactly what I was looking for.
  Now I need to work out how to transform flat files. I can't go to 2006 at the mo.
  
  Mike
  

• Anonymous
  December 14, 2005
  I am getting this error when building the application. Any thoughts.
  
  Performing main compilation...
  D:RESEARCHBiztalkServer2004BTSQuickStartSourceBTSQuickStartBTSQuickStart.btm(4,95): error CS0234: The type or namespace name 'source' does not exist in the class or namespace 'BTSQuickStart.BTSQuickStart' (are you missing an assembly reference?)
  D:RESEARCHBiztalkServer2004BTSQuickStartSourceBTSQuickStartBTSQuickStart.btm(4,6): error CS1501: No overload for method 'SchemaReferenceAttribute' takes '1' arguments
  D:RESEARCHBiztalkServer2004BTSQuickStartSourceBTSQuickStartBTSQuickStart.btm(5,100): error CS0234: The type or namespace name 'Destination' does not exist in the class or namespace 'BTSQuickStart.BTSQuickStart' (are you missing an assembly reference?)
  D:RESEARCHBiztalkServer2004BTSQuickStartSourceBTSQuickStartBTSQuickStart.btm(5,6): error CS1501: No overload for method 'SchemaReferenceAttribute' takes '1' arguments
  
  Build complete -- 4 errors, 0 warnings
  

• Anonymous
  February 02, 2006
  swfseeffe

• Anonymous
  April 23, 2006
  i have done the same as mentioned in ur tutorial...i have taken the sample as in C:Program FilesMicrosoft BizTalk Server 2004SDKSamplesAdaptersSubmitDirect and modified the adpaters to File..
  now my message gets thru the Biztlak and i am able to get output on my 'out' folder but map transformation is not applied to that...i get the same input xml file .....
  plz help me asap...
  thanks

• Anonymous
  May 16, 2006
  Thank Luke,
  
  Your tutorial helped me a lot to understand the basic of BizTalk and Visual Studio!

• Anonymous
  June 18, 2006
  I have followed the tutorial step by step and the excitement was enormous when I dropped the instance.xml into the 'In' folder. It got even better when the BizTalk server consumed the file!!
  
  The disappointment, however, was unbearable when no xmlfile could be found in the 'Out' folder...
  
  I can see from the 'Health and Activity Tracking' - tool under 'Find Message View' that the messages are being handled as send events, but no Receive Events have been detected!?!

• Anonymous
  June 19, 2006
  What did your event logs say? There should be an error/warning in there that describes the problem. Could be permissions...

• Anonymous
  August 07, 2006
  hi Luke,
  
  Well I was following your tutorial and all was well until I tried to creating the receive port, then I got an error that the rpc server is unavailable, I checked my event log and noticed an error like the one mentioned above about backing up the master secret but when I try to do this on the command prompt it just says again:
  ERROR: 0x800706BA : The RPC server is unavailable.
  
  I have installed this on my own laptop with windows xp sp2, I followed the following page to install it and it all seems to be ok:
  http://aspadvice.com/blogs/biztalk/archive/2006/04/25/16882.aspx
  
  do you have any idea what I might need to do?
  Thanks,
  Sharon

• Anonymous
  August 07, 2006
  Hi, this article will help troubleshoot your RPC issues (SSO or not!)
  http://support.microsoft.com/?kbid=841893
  

• Anonymous
  October 22, 2006
  Thats a pretty good start. Thanks for that.

• Anonymous
  December 11, 2006
  I am having same problem as Todd (see quote below) however I am using BT 2004. One of the other gentlemen in my company said that this is simply a bug in the program, is this the case, or is there something I am missing? I believe I have followed all tutorial steps to that point correctly. Thanks in advance. [Quote]I am using BT 2006, and when I click on Outbound maps, I do not have any options. There does not appear to be any way for me to apply the map that I created. [/Quote]

• Anonymous
  November 15, 2011
  Hi Luke, While deploying the BTSQuickStart i am getting following error. An error occurred while enlisting in a distributed transaction. Unspecified exception: An error occurred while enlisting in a distributed transaction. Thanks Jais

• Anonymous
  November 15, 2011
  hi Luke While deploying it i am getting the following error, can you please look into this An error occurred while enlisting in a distributed transaction. Unspecified exception: An error occurred while enlisting in a distributed transaction. Thanks Jais