HelloWorld

The HelloWorld sample demonstrates the most basic implementation of the Deployment Framework for BizTalk on a very simple, single-assembly BizTalk application.

What this Sample Does

The HelloWorld sample is based on the Orchestrations HelloWorld sample included in the BizTalk Server SDK.  The documentation for the BizTalk Server 2010 version of the sample application (it hasn't changed through many BizTalk releases) may be found here.  It is a simple application that picks up a file from a file system folder, runs it through an orchestration and writes it out to another file system folder.

How this Sample is Designed and Why

This sample demonstrates a very stripped-down and compact implementation of the Deployment Framework on a BizTalk application that consists of one assembly.  It uses a standard BizTalk XML bindings file, so it does not take advantage of the Deployment Framework's environment-specific configuration features.  All non-essential features are disabled in this sample.  Even so, the sample still demonstrates the ease with which you can deploy and test a BizTalk project from Visual Studio, then package it as an MSI for deployment to your BizTalk servers.

One extensibility feature demonstrated in the sample's HelloWorld.Deployment.btdfproj project file is how to package additional files into the MSI so that they are deployed to the server along with the application binaries and other project files.  The CustomRedist target is called during MSI packaging, and in the sample it copies the files in the TestFiles folder into the MSI staging folder (defined by the $(RedistDir) MSBuild property).

Where to Find this Sample

<BTDFInstallFolder>\Samples\BizTalk2006\HelloWorld or <BTDFInstallFolder>\Samples\BizTalk2009\HelloWorld

NOTE: The BizTalk 2006/2006 R2 version of the sample must be prepared by running PrepareSample.bat in the Samples\BizTalk2006\HelloWorld folder.

Building and Deploying this Sample

1. Open the solution file HelloWorld.sln in Visual Studio.  If necessary, upgrade the solution and projects to Visual Studio 2010 format.
2. Build the solution and ensure that the build succeeded
3. Deploy the application using the Deployment Framework's Visual Studio Deploy command
4. The Deployment Framework will create an input folder at C:\DeploymentFrameworkForBizTalk\Samples\HelloWorld\In
5. Confirm that the deployment process succeeded and the application is now running in BizTalk (see the Visual Studio Output window and BizTalk Admin Console)
6. If desired, package the application into an MSI using the Build Server MSI command

Running this Sample

1. Copy the file SamplePOInput.xml from TestFiles into C:\DeploymentFrameworkForBizTalk\Samples\HelloWorld\In
2. Watch for an output XML file to appear in C:\DeploymentFrameworkForBizTalk\Samples\HelloWorld\Out

Removing this Sample

1. With the HelloWorld.sln open in Visual Studio, use the Deployment Framework's Visual Studio Undeploy command
2. Delete the folder C:\DeploymentFrameworkForBizTalk\Samples\HelloWorld

Created with the Personal Edition of HelpNDoc: Easily create Web Help sites