Step 1: Develop the Application

Parent Previous Next

Rather than develop an application from scratch, we'll start with a simple application from the BizTalk Server SDK: the Orchestrations HelloWorld sample.


TIP: You'll normally want to create a deployment project for your application very early in your development process.  It will not only speed your development cycle, but also offer additional flexibility in your application development through features like the SSO Resolver and SSO Settings API.


Step 1: Copy the HelloWorld sample application to a working folder

1a. Create a new folder to hold the walkthrough application files at C:\BTDF\Walkthrough1.


1b. Copy the folder <BizTalkInstallationPath>\SDK\Samples\Orchestrations\HelloWorld into C:\BTDF\Walkthrough1.  You should now have the entire sample application in C:\BTDF\Walkthrough1\HelloWorld.


Step 2: Delete unnecessary files

Delete the files Setup.bat and Cleanup.bat from the HelloWorld folder.


Step 3: Move the solution file

Move HelloWorld.sln from the HelloWorld folder to the Walkthrough1 folder.  We want the solution file to be at the top of our folder structure since we will be adding a deployment project folder next to the HelloWorld application folder.


Step 4: Create a strong-name key (SNK) file

4a. Open a Visual Studio Command Prompt from the Start/Microsoft Visual Studio <version> folder that corresponds to your BizTalk version.  Run the following two commands:


cd "C:\BTDF\Walkthrough1\HelloWorld"

sn -k HelloWorld.snk


4b. Close the Command Prompt window.


Step 5: Create file input and output folders and grant permissions

5a. Create a new folder to hold input XML files at C:\BTDF\Walkthrough1\In.  Create another new folder to hold output XML files at C:\BTDF\Walkthrough1\Out.


5b. In Windows Explorer, open the Properties page for C:\BTDF\Walkthrough1\In and switch to the Security tab.  Click the Edit... button, then the Add... button.  Enter the name of the user account used by your BizTalk host instances, then click OK.  Check the Allow > Full Control box and click OK twice to return to Explorer.  The BizTalk host instance user account should now have Full Control access to the C:\BTDF\Walkthrough1\In folder.


5c. Repeat the previous steps to grant permissions on the C:\BTDF\Walkthrough1\Out folder.


Step 6: Open and build the HelloWorld sample application

6a. Run the version of Visual Studio that corresponds to your BizTalk version and, on Windows Vista or above, ensure that you run Visual Studio "as Administrator".


6b. Open the HelloWorld solution file (C:\BTDF\Walkthrough1\HelloWorld.sln).  You will see an error that one or more projects did not load correctly -- just click OK.


6c. In the Solution Explorer window, select the HelloWorld project (marked as unavailable).  With the project selected, press Alt-Enter or use the View menu to display the Properties window.  Update the "File path" property to reflect the new path to the project file: C:\BTDF\Walkthrough1\HelloWorld\HelloWorld.btproj.


6d. Back in the Solution Explorer, right-click the HelloWorld project and choose the Reload Project command.


6e. The project should now be loaded.  Rebuild the solution using the Build\Rebuild Solution command and ensure that the build succeeded.


Step 7: Disable the built-in deployment option

In recent versions of BizTalk, every BizTalk project has a "Deploy" option in addition to the standard "Build" option.  When using the Deployment Framework for BizTalk, you always want to disable the built-in Deploy option.


Right-click the HelloWorld solution and choose the Configuration Manager command.  In the Deploy column, un-check the Deploy checkbox.  Change the "Active solution configuration" to Release and again un-check the Deploy checkbox.  Switch the Active configuration back to Debug and click the Close button to close the dialog.


Created with the Personal Edition of HelpNDoc: Create iPhone web-based documentation