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.
Hi, thank you for the articul, it%u00b4s really usefull, although i have a quesion about it, i%u00b4m doing the same Orch but instead of using XML disassembler, i%u00b4m using a Flat File desassembler, because i have a flat file with multipul records as an input,and i want a message per record in my out put folder, in my orch the problem that i face, is that in the Listen instead of repeating the loop i t just finish!!
could you help?
please
thanks in advance
You will want to make sure you are inside a Loop Shape. Unless you need all messages processed by the same Orchestration instance you might want to look at debatching the messages inside the pipeline.
Hope this helps.
Stephen W. Thomas