Composant de pipeline Message Editor
Ce composant vous permet de modifier automatiquement une partie d'un message en plusieurs parties dans un pipeline d'envoi ou de réception. Vous ajoutez ce composant à un pipeline existant pour configurer le remplacement dans le cadre du traitement par défaut.
Génération du composant de pipeline Message Editor dans un pipeline existant
Pour utiliser le composant de pipeline Message Editor, vous devez l'ajouter à un pipeline existant. Pour plus d’informations, consultez « Création de pipelines avec Designer de pipeline » dans BizTalk Server aide.
Pour ajouter le composant de pipeline Message Editor à un pipeline existant
Démarrez Visual Studio.
Dans le menu Fichier , pointez sur Ouvrir, puis cliquez sur Projet.
Accédez à C :\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Editor Pipeline Component, sélectionnez MessageEditor.csproj, puis cliquez sur Ouvrir.
Démarrez l’invite de commandes Visual Studio.
À l’invite de commandes, accédez à C :\Program Files (x86)\Accélérateur de version> Microsoft BizTalk <pour RosettaNet\SDK\Message Editor Pipeline Component\obj\debug.
À l'invite de commandes, tapez sn -k MessageEditor.snk pour créer une clé, puis appuyez sur Entrée.
Dans Visual Studio, dans Explorateur de solutions, cliquez avec le bouton droit sur MessageEditor, puis cliquez sur Propriétés.
Dans la page Propriété de MessageEditor , cliquez sur l'onglet Signature , puis cochez la case Signer l'assembly .
Dans la liste déroulante Choisir un fichier de clé de nom fort , accédez à C :\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\ SDK\Message Editor Pipeline Component\obj\debug, sélectionnez MessageEditor.snk , puis cliquez sur Ouvrir.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur MessageEditor, puis cliquez sur Générer. Dans le volet de sortie, vérifiez que la génération a réussi.
Cliquez sur Démarrer, pointez sur Tous les programmes, sur Accessoires, puis cliquez sur Windows Explorer.
Dans Windows Explorer, accédez à C :\Program Files\Microsoft BizTalk 2013 Accelerator for RosettaNet\SDK\Message Editor Pipeline Component\obj\debug, cliquez avec le bouton droit sur Microsoft.Solutions.BTARN.SDK.MessageEditor.dll, puis cliquez sur Copier.
Accédez à C:\Program Files\Microsoft BizTalk 2013 Accelerator for RosettaNet\Pipeline Components, cliquez avec le bouton droit sur Composants de pipeline, puis cliquez sur Coller.
Dans Visual Studio, dans le menu Fichier , pointez sur Ouvrir, puis cliquez sur Projet.
Ouvrez le projet contenant le pipeline auquel vous voulez ajouter l'éditeur.
Dans l'Explorateur de solutions, double-cliquez sur le nom du pipeline pour l'ouvrir dans le Concepteur de pipeline.
Cliquez avec le bouton droit dans le volet Composants de pipeline BizTalk du volet Boîte à outils, puis cliquez sur Ajouter/supprimer des éléments.
Dans la boîte de dialogue Personnaliser la boîte à outils , sous l'onglet Composants de pipeline BizTalk , sélectionnez BTARN Message Editor Component, puis cliquez sur OK.
Dans le volet Composants de pipeline BizTalk du volet Boîte à outils, cliquez en maintenant le bouton enfoncé sur BTARN Message Editor Component, puis faites glisser le composant à l'emplacement souhaité dans le pipeline.
Dans le volet Composants de pipeline BizTalk du volet Boîte à outils, cliquez en maintenant le bouton enfoncé sur BTARN Message Editor Component, puis faites glisser le composant à l'emplacement souhaité dans le pipeline.
Notes
Il est recommandé d'ajouter le composant de pipeline Message Editor après la phase de désassemblage dans le composant de pipeline de réception ou pendant la phase de préassemblage du composant de pipeline d'envoi.
Dans Visual Studio, dans Pipeline Designer, sélectionnez la forme de composant de l’éditeur de messages BTARN.
Dans le volet Propriétés, dans la zone de texte associée à Requête XPath, tapez le nom de l'élément XPath dont vous voulez modifier la valeur.
Dans la zone de texte associée à Valeur XPath, tapez la valeur avec laquelle vous voulez définir l'élément XPath.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Générer. Vérifiez que la génération aboutit.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Déployer. Vérifiez que le déploiement aboutit.
Exemple
Pour modifier la valeur de l'élément ProprietaryDocumentIdentifier dans le schéma PIP 0C1, ajoutez la requête XPath indiquée dans la section de code suivante à la propriété de la requête XPath du composant de pipeline Message Editor.
/*[local-name()='Pip0C1AsynchronousTestNotification' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']/*[local-name()='thisDocumentIdentifier' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']/*[local-name()='ProprietaryDocumentIdentifier' and namespace-uri()='http://schemas.microsoft.com/biztalk/btarn/2004/0C1_MS_R01_02_AsynchronousTestNotification.dtd']
Pour obtenir une requête XPath complète, ouvrez le schéma dans l'Éditeur BizTalk, puis copier le Xpath de la propriété Instance XPath sous la fenêtre Propriétés. La requête XPath que vous fournissez doit contenir toutes les références d'espace de noms.