Message Inspector Pipeline Component
Ce composant de pipeline vous permet d'examiner les différentes parties et le contexte d'un message à parties multiples pour déterminer si un problème existe au niveau du message. Ce composant est utilisé à des fins de dépannage.
Le composant de pipeline dépose les fichiers XML dans un répertoire que vous désignez. Chacun de ces fichiers contient l'une des quatre parties d'un message RNIFv2.0 (en-tête de préambule, en-tête de livraison, en-tête de service et contenu du service) ou l'une des trois parties d'un message RNIFv1.1 (en-tête de préambule, en-tête de service et contenu du service). Un autre fichier XML contient le contexte du message.
Ce composant est généré dans un pipeline personnalisé et attaché à un port d'envoi. Vous créez un filtre dans le port d'envoi pour vous abonner aux messages à surveiller. Ce dépannage se produit en plus du traitement standard déjà effectué par Microsoft® BizTalk Accelerator pour RosettaNet (BTARN).
Génération d'un pipeline personnalisé à l'aide de Message Inspector Pipeline Component
Pour utiliser Message Inspector Pipeline Component, vous devez générer et déployer un pipeline personnalisé qui inclut le composant. Pour plus d’informations, consultez « Création de pipelines avec pipeline Designer » dans BizTalk Server aide.
Pour déployer le composant de pipeline Message Inspector
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 Inspector Pipeline Component, sélectionnez MessageInspector.csproj, puis cliquez sur Ouvrir.
Ouvrez l'invite de commandes Visual Studio.
À l’invite de commandes, accédez à C :\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug.
À l'invite de commandes, tapez "sn -k MessageInspector.snk" pour créer une clé, puis appuyez sur Entrée.
Dans Visual Studio, dans Explorateur de solutions, cliquez avec le bouton droit sur MessageInspector, puis cliquez sur Propriétés.
Dans la page Propriété MessageInspector , cliquez sur l’onglet Signature , puis cliquez sur La case à cocher 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 Inspector Pipeline Component\obj\debug, sélectionnez MessageInspector.snk , puis cliquez sur Ouvrir.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur MessageInspector, 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 sur Windows Explorer.
Dans Windows Explorer, accédez à C :\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug, cliquez avec le bouton droit sur Microsoft.Solutions.BTARN.SDK.MessageInspector.dll, puis cliquez sur Copier.
Accédez à C :\Program Files (x86)\Microsoft BizTalk <version> Accelerator pour 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 Nouveau, puis cliquez sur Projet.
Dans le volet Modèles de la boîte de dialogue Nouveau projet , sélectionnez Projet BizTalk Server vide, puis nommez le projet dans la zone Nom . Dans la zone Emplacement , accédez au dossier dans lequel vous souhaitez enregistrer le projet, puis cliquez sur OK.
Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, pointez sur Ajouter, puis cliquez sur Ajouter un nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément , sélectionnez Pipeline d'envoi, nommez le fichier de pipeline personnalisé dans la zone Nom , puis cliquez sur Ouvrir.
Notes
Ajoutez uniquement Message Inspector Pipeline Component à des ports d'envoi, et non à des ports de réception.
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 Inspector Component, puis cliquez sur OK.
Dans le volet Composants de pipeline BizTalk du volet Boîte à outils, cliquez et maintenez la touche BTARN Message Inspector Component, puis faites glisser le composant dans une zone Déposer ici ! .
Dans Visual Studio, dans Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet de pipeline, puis cliquez sur Propriétés.
Dans la boîte de dialogue Pages de propriétés , cliquez sur Propriétés communes, puis cliquez sur Assembly.
Dans le volet droit, dans la zone de texte associée au fichier de clé d’assembly, cliquez sur les points de suspension, passez à C :\Program Files (x86)\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\Message Inspector Pipeline Component\obj\debug, sélectionnez MessageInspector.snk, puis cliquez sur OK.
Dans le Designer de pipeline Visual Studio, sélectionnez la forme composant de l’inspecteur de messages BTARN.
Dans Visual Studio Fenêtre Propriétés, dans la zone Répertoire, tapez le nom du répertoire dans lequel vous souhaitez supprimer les fichiers XML.
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.
Dans Visual Studio, dans le menu Affichage, cliquez sur BizTalk Explorer.
Cliquez avec le bouton droit sur Ports d'envoi, puis cliquez sur Ajouter un port d'envoi.
Dans la boîte de dialogue Créer un port d'envoi , cliquez sur OK.
Dans la boîte de dialogue Propriétés de port d'envoi , dans la zone Nom , nommez le port d'envoi. Sélectionnez ensuite Principal dans le volet gauche, cliquez sur Type de transport dans le volet droit, puis sélectionnez Fichier.
Dans la boîte de dialogue Propriétés de port d'envoi , dans la zone Adresse (URI) , cliquez sur le bouton de sélection (...).
Dans la boîte de dialogue Propriétés du transport de fichier , tapez le nom du dossier Destination , puis cliquez sur Envoyer dans le volet gauche. Sélectionnez ensuite le pipeline personnalisé que vous venez de créer comme Pipeline d'envoi dans le volet droit.
Cliquez sur Filtres & Cartes dans le volet gauche, puis cliquez sur Filtres.
Entrez une expression de filtre dans le volet droit pour désigner le type de fichiers pour lesquels vous souhaitez le pipeline dépose des fichiers XML. Par exemple, si vous souhaitez déposer des fichiers pour tous les messages RNIF v1.1, sélectionnez Microsoft.Solutions.BTARN.Schemas.RNIFv11.GlobalBusinessAction en tant que Propriété et « Existe » en tant qu' Opérateur , puis cliquez sur OK.
Dans l'Explorateur BizTalk, cliquez avec le bouton droit sur le port d'envoi que vous venez de créer, cliquez sur Inscrire, cliquez à nouveau avec le bouton droit sur le port d'envoi, puis cliquez sur Démarrer.
Remarques
Dans le cadre d'un traitement standard, vous pouvez examiner une seule partie du message à la fois (la partie que vous avez désignée comme le corps du message dans l'orchestration). Vous pouvez donc examiner une seule partie dans la console Administration de BizTalk, et votre capacité à résoudre les problèmes est limitée. Message Inspector Pipeline Component vous aide à contourner cet obstacle.