Le pipeline du processeur d’erreurs ESB

Microsoft BizTalk ESB Toolkit installe un port d’envoi nommé ALL. Exceptions qui utilisent le pipeline d’envoi ESBFaultProcessor. La figure 1 montre les propriétés de ALL. Port d’envoi d’exceptions.

Figure 1

Configuration de ALL. Port d’envoi d’exceptions, y compris son utilisation du pipeline ESBFaultProcessor

Le pipeline ESBFaultProcessor contient les composants de pipeline suivants : ESB Exception Encoder, ESB Business Activity Monitoring (BAM) Tracker et ESB Transform.

The ALL. Les exceptions d’envoi du port s’abonnent à tous les messages d’erreur ESB et à tous les messages générés par le mécanisme de routage des messages bizTalk ayant échoué. La figure 2 montre les paramètres de propriété de filtre de ALL. Port d’envoi d’exceptions.

Figure 2

Propriété filter de l’objet ALL. Le port d’envoi d’exceptions définit l’abonnement de port

Composant Encodeur d’exception de pipeline du processeur d’erreur

Le composant de pipeline ESB Exception Encoder normalise les messages d’erreur générés dans le mécanisme de routage des exceptions d’orchestration ESB et le mécanisme de routage des messages ayant échoué bizTalk en messages canoniques conformes au schéma de rapport d’exceptions ESB.

Pour une exception de routage d’exception d’orchestration ayant échoué, le composant enrichit et sérialise toutes les propriétés de message d’erreur, les messages XLANG, les propriétés de contexte et les informations System.Exception dans un message XML.

Pour une exception de routage de messages ayant échoué, le composant enrichit les données en ajoutant le nom de l’application et d’autres propriétés ambiantes, et applique l’espace de noms de schéma au contenu du message XML sortant.

Si vous le souhaitez, le composant de pipeline ESB Exception Encoder peut également appliquer des instructions de traitement Microsoft InfoPath au message sortant. Vous pouvez modifier les instructions InfoPath en définissant les propriétés du composant de pipeline en mode Création. Les trois propriétés suivantes au moment de la conception affectent le comportement d’exécution du composant de pipeline Esb Exception Encoder :

• EscapeCDATA. Cette propriété détermine si le composant va échapper à toutes les sections CDATA trouvées dans les messages persistants afin qu’InfoPath puisse les afficher correctement.

• FaultDocumentNamespace. Cette propriété a la valeur par défaut .http://schemas.microsoft.biztalk.practices.esb.com/exceptionhandling Cela peut être modifié pour utiliser un espace de noms sortant personnalisé pour les messages persistants.

• ProcessingInstruction. Cette propriété peut contenir n’importe quelle instruction de traitement InfoPath conforme au schéma d’erreur de rapport d’exception ESB. Microsoft BizTalk ESB Toolkit inclut un modèle InfoPath conforme à l’instruction de traitement suivante.

  <?mso-infoPathSolution solutionVersion="1.0.0.346" productVersion="11.0.6565"  
  PIVersion="1.0.0.0"   
  href=file:///\\localhost\publish\Microsoft.Practices.ESB.ExceptionHandling.InfoPath.Reporting.xsn  
  name="urn:schemas-microsoft-com:office:infopath:  
  Microsoft-Practices-ESB-ExceptionHandling-InfoPath-Reporting:  
  http---schemas-microsoft-biztalk-practices-esb-com-exceptionhandling"  
  language="en-us" ?><?mso-application progid="InfoPath.Document"?>  
  

Composant De suivi BAM du pipeline de processeur d’erreur

Le composant de pipeline ESB BAM Tracker reçoit le message du composant ESB Exception Encoder et écrit les données d’erreur sélectionnées dans les tables d’importation principales BAM créées lors de l’installation de l’infrastructure de gestion des exceptions ESB.

Le composant ESB BAM Tracker utilise la méthode GetEventStream du contexte de pipeline pour ajouter les champs suivants en tant qu’enregistrement d’activité à la base de données d’importation principale BAM :

• Application

• Description

• FaultSeverity

• ServiceName

• ErrorType

• Faultcode

• MachineName

• MessageID

• DateTime

• FaultDescription

• Étendue

• ÉchecCategory

• FaultGenerator

• ServiceInstanceID

  Le composant ESB BAM Tracker utilise la valeur de l’identificateur de message (propriété MessageID ) du message d’erreur ESB comme ID d’activité BAM. Le composant ESB BAM Tracker expose deux propriétés de temps de conception que vous pouvez définir pour modifier son comportement d’exécution :

• Activé. Cette propriété détermine si le composant traite le message et l’écrit dans la base de données BAM. Lorsqu’il est défini sur False, le composant envoie simplement le message au composant suivant dans le pipeline.

• FaultDocumentNamespace. Cette propriété a la valeur par défaut .http://schemas.microsoft.biztalk.practices.esb.com/exceptionhandling

Composant de transformation du pipeline du processeur d’erreur

Le pipeline de processeur d’erreurs ESB utilise le composant de pipeline De transformation ESB pour exécuter une carte BizTalk qui traduit le message d’erreur ESB encodé dans un format qui correspond au schéma de l’adaptateur SQL BizTalk (ExceptionSql.xsd). Le composant transmet ensuite le message transformé à l’adaptateur SQL, qui insère le message d’erreur ESB dans la base de données du portail de gestion ESB.

Le composant de pipeline de transformation ESB expose trois propriétés au moment du design qui peuvent être modifiées pour modifier son comportement d’exécution :

• Activé. Cette propriété active ou désactive le composant.

• Procédez à la validation. Cette propriété spécifie si un message doit être validé.

• MapName. Cette propriété contient le nom de la carte qui doit être exécutée pour traduire le message pour le stockage dans la base de données du portail de gestion ESB. Voici la valeur par défaut.

  Microsoft.Practices.ESB.ExceptionHandling.Maps.FaultMessage_to_ExceptionSql,  
  Microsoft.Practices.ESB.ExceptionHandling.Maps,  
  Version=2.0.0.0,  
  Culture=neutral,  
  PublicKeyToken=c2c8b2b87f54180a  
  

  Une fois l’exécution de tous les composants du pipeline terminée, l’adaptateur de base de données BizTalk SQL Server insère le message d’erreur dans la base de données du portail de gestion ESB.