Kader Yildirim
A la découverte de BizTalk Server 2006 3/3
Développer un assembleur pour BizTalk Server 2006 R2
Par Kader Yildirim publié le 06/05/2008 à 13:20, lu 1164 fois, 6 pages
 2 | Génération et configuration du projet
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 :
 
/content/9090aac7-4114-420a-bcf2-af9544628ffb/NewProject.PNG
 
Cette fois-ci nous allons choisir un composant de type assembleur :
 
/content/9090aac7-4114-420a-bcf2-af9544628ffb/AssemblerPpty.PNG
 
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 :
 
/content/9090aac7-4114-420a-bcf2-af9544628ffb/Sign.PNG
 
La mise à jour dans le GAC est faite automatiquement grâce aux lignes de commandes suivantes (les mêmes que ceux du premier article) :
 
/content/9090aac7-4114-420a-bcf2-af9544628ffb/BuildEvts.PNG
 
 
» Démarrer une discussion