BizTalk Message Archiving Pipeline Component : Atomic-Scope

It has been brought to our attention that the current version of the component (version 1.1.30.349) has a minor issue that you may encounter when running the component on BizTalk Server 2009 & 2010 – rest assured that we are currently working on a fix for these issues which should be released in the next few days.

After successfully archiving a message, the  Message Archiving Component writes the archived filename into a custom context-property called ‘ArchiveFilename‘. This property can then be used later in your own solution. From BizTalk Server 2009 onwards, a supporting Property Schema must be deployed to the management database, otherwise the following error will occur:

There was a failure executing the send pipeline: “[YOUR SEND PIPELINE]” Source: “Message Archiving Component” Send Port: “[YOUR SEND PORT]” URI: “[YOUR SEND PORT URI]” Reason: Loading property information list by namespace failed or property not found in the list. Verify that the schema is deployed properly.

By default, we do not deploy this assembly to a BizTalk Application. To deploy the required Property Schema, following the instructions below.

Deploying a Property Schema Assembly to a BizTalk Application

1. Identify the AtomicScope.BizTalk.Pipelines.MessageArchivingComponent.Properties.dll assembly in the installation folder, usually C:\Program Files\Atomic-Scope\BizTalk Message Archiving Component\

2. Open the BizTalk Administration Console and expand the BizTalk Application your would like to deploy the assembly to. Note: this can be any BizTalk Application.

3. Right-click the Application and select Add -> BizTalk Assemblies.

4. In the Add Resources dialog, click the Add button and select the AtomicScope.BizTalk.Pipelines.MessageArchivingComponent.Properties.dll assembly from the installation folder. The assembly will appear in the Selected Files to Add list. Ensure that the checkboxes Overwrite All, Add to the Global Assembly Cache on add resource (gacutil) and Add to the Global Assembly Cache on MSI file install (gacutil) are ticked. Click Ok.

5. Restart all BizTalk Host Instances.

Contact us at support@atomic-scope.com if you have any problems performing these steps.

I’m pleased to announce the release of version 1.1 of the BizTalk Message Archiving Pipeline Component. In addition to several bug-fixes, this new release adds an important feature that didn’t make it into version 1.0 – the ability to create macros for user defined Context-Properties, otherwise known as User-Defined Macros!

In the 1.0 release, there was a fixed set of macros that could be used to create file names for archived messages. Even though this set of macro’s was extensive (we supported over 150 macros across 12 adapters), we didn’t allow you to create custom macro’s from Context-Properties defined in your own BizTalk Property Schemas. In this new 1.1. release, macros are now defined in ‘Macro Definition’ files, Xml files that are referenced by the component at runtime. We’ve also taken this opportunity to move the macro definitions that were previously compiled into the component to this new structure, greatly reducing the overall size of the assembly that is loaded by the BizTalk runtime.

To download this new version, visit http://www.atomic-scope.com/downloadtrial/. This new release is fully compatible with existing trial, developer and production licence keys.

Creating User-Defined Macros

Its incredibly easy to create macro’s to use Context-Properties defined in your own Property Schemas: simply create a new Macro Definition that tells the Archiving Component which message Context-Property it should read when it encounters your custom macro.

In the example below, I have created a new Macro Definition file with two new custom macros – SalesOrderId and CustomerAccountId – which refer to the message Context-Properties SalesOrderId & CustomerAccountId in the namespace http://schemas.atomic-scope.com/orders/sales-order-properties.

Once you have defined your new macros, reference the Macro Definition file through the BizTalk configuration file and start to use it in the archiving component. Messages can now be archived using your custom Context-Properties!

More detailed information on how to create and configure custom macros can be found on our Support site at http://www.atomic-scope.com/support/online-docs/macros.php#UserDefinedMacros

We hope you enjoy using this new feature; please send any comments or questions you may have to support@atomic-scope.com.

It gives me great pleasure to announce Version 1.0 of the BizTalk Message Archiving Pipeline Component.

The component allows you to archive Xml, flat-file, EDI and binary messages as they pass thru receive and send pipelines, without the need for complex ‘archiving’ Send Port configurations, additional load on the MessageBox database and requires zero developer time . just plug-in, configure and use! Archive filenames are created at runtime from Context-Properties written to the message by receive adapters, custom properties defined in your solution or with the standard Send Port macros A free 14-day trial is available – download your copy now.

This new version of the component builds on the excellent feedback received following the launch of the original version on Codeplex and has spent many months in development . this release is a complete re-write and incorporates many of the community requested features, including:

• The ability to enable and disable the component at runtime;The promotion of the archive filename into the Message Context for use in orchestrations, Send Port filters etc.;
• Full streaming support, even for messages that fail when being processed by downstream components (such as flat-file or EDI messages);
• Support for a wide-range of adapter Context-Properties .out-of-the-box. and custom, user-defined Context-Properties;
• Native 32- and 64-bit versions;
• Support for all versions of BizTalk Server 2006, BizTalk Server 2006 R2 & BizTalk Server 2009;

The component is also backed by our business-class Enterprise Support Agreement. You can also read more about Atomic-Scope and see how we are supported by the Microsoft BizSpark Programme.