Share via

BizTalk Server: Start Developing a Simple BizTalk Application for BizTalk Beginners

  • Article

Introduction

This Article is designed for the BizTalk Beginners to start with the Simple application.

In BizTalk, the flow of messages can be designed with two different approaches:

  • Message only Solution
  • Orchestration based solution

This Sample is based on Orchestration and it will good for learning how to manage receiving messages on a orchestration and send to the Send Port. Let's design a simple solution to understand how orchestration based solution works.

Basic Steps

  • Create Empty BizTalk Solution In Visual Studio.
  • Create a BizTalk Input and Output Schema.
  • Create the Map
  • Configure BizTalk Orchestration
  • Deploy BizTalk Application
  • Test the Application

1. Start>>Visual Studio 2010 >> Biztalk >> Biztalk Empty Project>> Name your Empty Project/Solution as SimpleBizTalkOrchestration

2. Create a Receive Schema Goto Solution Explorer>>Add new item>>Schema>>schema1 (name it as ReceiveSchema)
3. ReceiveSchema>>In the Root RightClick (RC) >>Add New Child Element>>Name it as FirstName
4. Repeat the above step to create another element as LastName
5. Repeat the steps 2 and 3 and create another schema (name it as SendSchema) and create an element as FullName
6. Solution Explorer>>Add new item >>Map (name it as MapTransform)
7. You will find an interface with Source Schema and Destination Schema on Left and Right side of a Canvas
8. Click on source schema>>Biztalk Type Picker window will open>>Expand the Tree Structure>>Expand the Schema>> Select the Receive Schema and SendSchema for the Source and Destination respectively
9. Expand the root elements on Send and Receive schemas
10. Now Goto Toolbox>>String Functoid>>String Concatenation functoid>>Drag and drop to the canvas
11. From ReceiveSchema drag the connect the FirstName and LastName to the FullName
12. Solution Explorer>>Add new item>>Orchestration (name it as SimpleOrch)
13. All the schemas have to be linked to a message in an orchestration. So we need to Assign the Receiveschema and SendSchema as a message. Goto Orchestration pane and create a message as ReceiveMsg
14. Assign the ReceiveSchema to the message type from the Schema tree selection
15. Repeat steps 2 and 3 and assign SendMsg with SendSchema
16. Now, Drag and drop Receive shape Transform shape and Send shape from the toolbox as shown below
17. Now we need to create Physical ports, Right click on the Port surface and click on New port. Double click on the new port and go through the wizard.
18. Configure the Port binding as shown below, you can also mention the Port binding as specified later
19. Repeat the above steps for Send port
20. You can now see the physical ports being configured as below

21. Now Drag Receive port Green color Icon on to receive Shape, and Send Port Green Color Icon on to send Shape.
22. Configure the transform shape by double clicking the transform shape, in which we will assign the Maps for transformation as shown below

23. Now We are OK with Orchestration and we are going to deploy the project
24. BizTalk Application has to be signed before deploying. Got to project properties>>signing tab>>Create a new key and assign it
25. In Deployment tab, Give the Application name as SimpleBizTalkOrch, Our application will be deployed in this name in the BizTalk Administration console. (Otherwise, this application will go to the default Biztalk Application on the BizTalk server - BiztalkApplication1)
26. Right click on the project, and click on deploy - (You Should have Admin privileges and you should open the Visual Studio as Administrator)
27. Now we are ok with Deployment. Then we should Configure the Application on Biztalk Administration Console.
28. Start >> Biztalk Administration Console - Open as Administrator
29. Go to BizTalk Administration Console, check whether the application is listed
30. Goto Orchestration>>Right click on SimpleBizTalkOrchestration.SimpleOrch>>Properties>>Bindings tab>> assign the Host instance as BizTalkServerApplication

31. If you have selected " Specify Later " when creating ports on the application before deployment, then you should create ports from here. When you click on receive ports, you can add new receive Location and assign to the folder that you have already created. This will be the receive location for the application. The Application pick the message from this folder.
32. Send Ports also same. You can create from here and assign the folder to pass the output Message.
33. Now, You are ready to Test The project.
34. Go to visual Studio Solution and select the Schema, Then right click on that and click on generate Schema. You can see the file location of the generated Schema. Edit Elements of the generated XML file with your first and Last Name, Then Copy the XML file into your receive Folder you have already configured.
35. Yes... Cheers.. It has disappeared .. Please Check your Send Folder (Configured Output Folder). You will be able to see a file with your Full Name.

See Also

Another important place to find a huge amount of BizTalk related articles is the TechNet Wiki itself. The best entry point is BizTalk Server Resources on the TechNet Wiki.