Prepend and Append Text to SourceFileName Macro

This sample shows how use the %SourceFileName% macro to append or prepend text to the original file name of the file received by the file adapter. This sample includes a helper class with three methods to help with string manipulation of the file name.

This uses an Orchestration to set the Received File Name Message Context Property that the SourceFileName Macro uses. 

This sample will work for BizTalk 2004 and BizTalk 2006.

Get more information from the original blog post on this topic:http://www.biztalkgurus.com/biztalk_server/biztalk_blogs/b/biztalk/archive/2005/08/01/how-to-prepend-to-the-sourcefilename-in-biztalk-sample.aspx

Updated Version of Biztalk 2004 Pipeline Component Wizard Available

Martijn has made some excellent updates to his
pipeline component wizard for Biztalk 2004. 

This visual studio
wizard is a must have for anyone trying to write custom pipeline components. 

This new version
supports IDisassembler and message spitting.  It also has useful comments for each
method explaining what each one does and how to use them.

This wizard can be
downloaded from his GotDotNet Workspace.

Biztalk Server 2006 Beta Available

The Biztalk 2006 Beta Program is now available for sign-up. 



Biztalk 2006 simplifies the administration and deployment process.  Some of the other major enhancements are improved BAM, executing pipelines inside an Orchestration, a flat file schema wizard, and suspended message routing, just to name a few.


 


To sign-up for the program follow these steps:


1.  Go to http://beta.microsoft.com


2.  Sign in with your passport


3.  At the top of the page it should say something like “if you have a Guest Id click here”. 


4.  Enter: BizTalkBetaTeam (case sensitive) as your guest id.


5.  Fill out the survey.  I think the link is located on the left side of the screen.  Make sure you do not use a PO Box.


6.  You should get a welcome email once you are processed.  I do not know how long this will take.  Mine took several days.



I recommend anyone interested in Biztalk to take advantage to this beta program.  It will give you a great opportunity to see the new features of the upcoming release and to have access to the beta news group.  Just a note, Visual Studios 2005 Beta 2 is also required.



Once you have installed Biztalk 2006, do not forget to check out www.BizTalkGurus.com for samples and videos covering the new features of Biztalk Server 2006.


 

Recoverable Interchange Processing Video

This 9:07 minute video covers one of the new features of Biztalk 2006, Recoverable Interchange Processing. This is the ability to fail a single message inside an interchange without failing the whole interchange. This works with both the Xml Disassembler and the Flat File Disassembler.

This video was made for BizTalk 2006 but should still be relevant for other versions of BizTalk.

Recoverable Interchange Processing Inside a Pipeline

Biztalk 2006 introduces many new and exciting features. One of these new features is Recoverable Interchange Processing for inbound receive interchanges. Biztalk 2006 now allows the option to fail the whole interchange or process just the non-errored single messages. This sample shows how easy it is to take advantage for this new feature. Please see the ReadMe.txt for setup instructions.

This sample should work with BizTalk 2006 and BizTalk 2006 R2.

Get more information from the original blog post on this topic: http://www.biztalkgurus.com/biztalk_server/biztalk_blogs/b/biztalk/archive/2005/07/20/biztalk-2006-recoverable-interchange-processing.aspx

Watch the video related to this sample here: http://www.biztalkgurus.com/biztalk_server/biztalk_2006/m/biztalk_2006_samples/32417.aspx

BizTalk 2006 Recoverable Interchange Processing

Biztalk 2006 introduces many new and exciting features.  One of these new features is Recoverable Interchange Processing for inbound receive interchanges.



First off, what is an Interchange?  An interchange is simply an item received by Biztalk.  In Biztalk terms, an interchange is typically used to define a message that contains several messages inside it. Some typical examples are batch flat files and Xml envelopes.



A specific example of this is a flat file document that contains a Header and many Detail records like this:







If we were to debatch this message using the flat file disassembler it would produce three single records.  In this case, it is one interchange that will produce three messages into the message box.



In Biztalk 2004, if a single record inside the flat file contained bad data the whole interchange (i.e. all the single messages) would fail.  In some business scenarios this is the desired behavior. 



This should not be confused with Adapter Batching.  Adapter batching will pick up and process many different interchanges together inside a configurable (usually) batch.  The interchanges inside a batch can fail in Biztalk 2004, just not individual messages inside a specific interchange.  Got it?



Biztalk 2006 now allows the option to fail the whole interchange or process just the non-errored single messages.  This is called Recoverable Interchange Processing.



Setting this up is as simple as setting the RecoverableInterchangeProcessing flag to True inside the XmlDisassembler pipeline component.  This can be done at runtime inside the Biztalk Server Admin tool without having to recompile any code. 



As the single messages are passing through the pipeline, the pipeline sets a new message property called BTS.InterchangeSequenceNumber.  When a single message inside an interchange fails, the sequence number along with useful message information is written to the event log.



Enough of my rambling…  How about taking a look at this for yourself.


Note this is based off of CTP build of Biztalk Server 2006.



Watch the video: Recoverable Interchange Processing Video



Download the sample:
Recoverable Interchange Processing Sample



See the readme.txt for setup instructions for the sample.  The default install is not configured to support recoverable interchanges.  You will need to change the property.



One additional point, I have heard that recoverable interchange processing will only work on flat files that have tag identifiers defined on the records.  I have not verified this but it makes sense.

Flat File Disassembler Output Options Video

This 9:49 minute video covers the three different output options from the biztalk flat file Disassembler provided in Biztalk. The three options are single detail records without headers or trailers, all detail records together without header and trailers, or all details together with the header and trailer.

This video was made for BizTalk 2004 but should still be relevant for other versions of BizTalk.

Working with the BizTalk Flat File Disassembler Video


I have put together a short 10 minute biztalk training video covering some of the different output options available using the Flat File Disassembler in Biztalk Server 2004. 



This video covers three different output options from the flat file disassembler. The three options covered are single detail records without a header or trailer, all detail records together without a header or trailer, or all details together with the header and trailer.



This video walks through the Flat File Disassembler Sample from a past post. It might be helpful to have the sample downloaded before watching the video.



I have the video available for live play via shock wave or downloadable via Windows Media Player.



Watch the video: Flat File Disassembler Output Options Video



Comments and feedback are strongly recommended.


Envelope and XPath Debatching in an Orchestration Lab

This lab walks through two different types of message debatching in Biztalk. It shows how envelopes can be used with the Xml Disassembler to break up larger Xml messages into single messages. It also covers xpath in a loop inside an Orchestration.

Get more information from the original blog post on this topic: http://www.biztalkgurus.com/biztalk_server/biztalk_blogs/b/biztalk/archive/2005/07/12/xpath-debatching-and-envelope-debatching-biztalk-lab.aspx