MIME (BizTalk Server Sample)
The MIME sample demonstrates how to perform MIME encoding within a send pipeline.
What This Sample Does
This sample configures the folder MIMEIn as a receive location. When you place a file, such as the sample file ImageInput.gif, in this folder, BizTalk Server processes the message in this file using the following steps:
Retrieve the message file from the receive location folder MIMEIn.
In the receive pipeline, pass the message through unchanged.
In the MessageBox database, route the message to the send pipeline.
In the send pipeline, perform MIME encoding and place the file into the send adapter folder MIMEOut.
Where to Find This Sample
<Samples Path>\Pipelines\MIME\
The following table shows the files in this sample and describes their purpose.
| File(s) | Description |
|---|---|
| Cleanup.bat | Used to undeploy assemblies and remove them from the global assembly cache (GAC). Removes send and receive ports. Removes Microsoft Internet Information Services (IIS) virtual directories as needed. |
| ImageInput.GIF | Sample input file. |
| SampleMimeEncoding.btproj SampleMimeEncoding.sln |
Project and solution files for this sample. |
| SampleMimeEncodingBinding.xml | Used for automated setup such as port binding. |
| SendMimePipeline.btp | BizTalk Server send pipeline file with the MIME Encoder component. |
| Setup.bat | Used to build and initialize this sample. |
Building and Initializing This Sample
Use the following procedure to build and initialize the MIME sample.
To build and initialize this sample
In a command window, navigate to the following folder:
<Samples Path>\Pipelines\MIME
Run the file Setup.bat, which performs the following actions:
Creates the input (MIMEIn) and output (MIMEOut) folders for this sample in the folder:
<Samples Path>\Pipelines\MIME
Compiles the Visual Studio project for this sample.
Creates and binds the BizTalk Server receive location, and the send and receive ports.
Note
This sample displays the following warning when creating and binding the ports:
Note
Warning: Receive handler not specified for receive location "MIMEReceiveLocation"; updating with first receive handler with matching transport type.Note
You can safely ignore these warnings. (To accommodate for possible naming differences in user installations, the host name and receive handler have been omitted from the binding file.)
Enables the receive location, and starts the send port.
Note
If you run this sample from a location other than where it is installed, you must first add a reference to the Microsoft.BizTalk.Pipeline.Components assembly.
Note
You should confirm that BizTalk Server did not report any errors during the build and initialization process before attempting to run this sample.
Note
If you choose to open and build the project in this sample without running the file Setup.bat, you must first create a strong name key pair using the .NET Framework Strong Name utility (sn.exe). Use this key pair to sign the resulting assembly. To undo changes made by Setup.bat, run Cleanup.bat. You must run Cleanup.bat before running Setup.bat a second time.
Running This Sample
Use the following procedure to run the MIME sample.
To run this sample
Put a copy of the file ImageInput.gif into the folder MIMEIn.
Observe the text file created in the folder MIMEOut. The name of this text file is based on the message ID GUID. This file contains MIME-encoded content of the input file ImageInput.gif.