La première étape consiste à créer un nouveau projet pour l'assembleur Biztalk. Pour cela nous allons procéder de la même manière que pour le
désassembleur en utilisant le
Biztalk Server Pipeline Component Wizard :
Cette fois-ci nous allons choisir un composant de type
assembleur :
A l'avant dernière étape du wizard nous allons ajouter les variables
PropertyName et
PropertyNameSpace de type
string. Ces variables vont être utilisées par l'assembleur afin de rechercher dans le contexte des messages à fusionner leur identifiant unique (
Guid) pour connaître l'emplacement auquel il faut les insérer dans le message principal afin de créer le résultat de sortie.
Si on regarde le code généré par le wizard il y a deux fonctions principales.
La première
AddDocument est appelée par Biztalk pour fournir à l'assembleur les messages à traiter. Toutefois, dans les versions existantes de Biztalk,
cette fonction n'est appelée qu'une seule fois lors de l'envoi et ne permet pas de jouer le rôle d'accumulateur qu'on pourrait en attendre :
public void AddDocument(Microsoft.BizTalk.Component.Interop.IPipelineContext pc,
Microsoft.BizTalk.Message.Interop.IBaseMessage inmsg)
{
// store the message for later use
_inmsgs.Add(inmsg);
}
Toutefois un comportement similaire à un accumulateur de messages peut être obtenu en invoquant ce composant par programmation depuis une orchestration.
Etant donné que dans notre article nous souhaitons fusionner les parties de notre message après transformation nous allons mettre en oeuvre cette technique pour accumuler les messages issus de la transformation avant de les agréger.
Enfin la seconde fonction importante de l'assembleur se nomme
Assemble et est appelée par Biztalk pour effectuer le traitement principal. Dans notre cas c'est dans cette fonction que sera implémentée l'agrégation :
public Microsoft.BizTalk.Message.Interop.IBaseMessage Assemble(Microsoft.BizTalk.Component.Interop.IPipelineContext pc)
{
// TODO: implement assembling logic
// BizTalk 2004 documentation: "In this release of BizTalk Server 2004,
// assembling functionality is not used, so BizTalk Server always passes
// one document to the component input."
return ((Microsoft.BizTalk.Message.Interop.IBaseMessage)(_inmsgs[0]));
}
Bien sûr comme la plupart des assemblies utilisées par Biztalk il ne faut pas oublier de la signer et la déployer dans le GAC :
La mise à jour dans le GAC est faite automatiquement grâce aux lignes de commandes suivantes (les mêmes que ceux du
premier article) :