La canalización del procesador de errores de ESB
Microsoft BizTalk ESB Toolkit instala un puerto de envío denominado ALL. Excepciones que usan la canalización de envío de ESBFaultProcessor. En la figura 1 se muestran las propiedades de ALL. Puerto de envío de excepciones.
Ilustración 1
Configuración de ALL. Puerto de envío de excepciones, incluido su uso de la canalización de ESBFaultProcessor
La canalización DE ESBFaultProcessor contiene los siguientes componentes de canalización: ESB Exception Encoder, ESB Business Activity Monitoring (BAM) Tracker y ESB Transform.
Todo. Las excepciones envían puerto se suscribe a todos los mensajes de error de ESB y a todos los mensajes generados por el mecanismo de enrutamiento de mensajes con error de BizTalk. En la figura 2 se muestra la configuración de la propiedad de filtro de ALL. Puerto de envío de excepciones.
Ilustración 2
Propiedad filter de ALL. El puerto de envío de excepciones define la suscripción de puerto.
Componente del codificador de excepciones de canalización de procesador de errores
El componente de canalización del codificador de excepciones de ESB normaliza los mensajes de error generados en el mecanismo de enrutamiento de excepciones de orquestación con errores de ESB y el mecanismo de enrutamiento de mensajes con error de BizTalk en mensajes canónicos que cumplen con el esquema de informes de excepciones de ESB.
En el caso de una excepción de enrutamiento de excepciones de orquestación con errores, el componente enriquece y serializa todas las propiedades del mensaje de error, los mensajes XLANG, las propiedades de contexto y la información de System.Exception en un mensaje XML.
En el caso de una excepción de enrutamiento de mensajes con error, el componente enriquece los datos agregando el nombre de la aplicación y otras propiedades ambientales, y aplica el espacio de nombres de esquema al contenido del mensaje XML saliente.
Opcionalmente, el componente de canalización del codificador de excepciones de ESB también puede aplicar instrucciones de procesamiento de Microsoft InfoPath al mensaje saliente. Puede modificar las instrucciones de InfoPath estableciendo las propiedades del componente de canalización en la vista de diseño. Las siguientes propiedades en tiempo de diseño afectan al comportamiento en tiempo de ejecución del componente de canalización del codificador de excepciones de ESB:
EscapeCDATA. Esta propiedad determina si el componente escapará cualquier sección de CDATA que se encuentre en mensajes persistentes para que InfoPath pueda mostrarlas correctamente.
FaultDocumentNamespace. Esta propiedad tiene un valor predeterminado de
http://schemas.microsoft.biztalk.practices.esb.com/exceptionhandling. Esto se puede modificar para usar un espacio de nombres de salida personalizado para los mensajes persistentes.ProcessingInstruction. Esta propiedad puede contener cualquier instrucción de procesamiento de InfoPath que cumpla con el esquema de error del informe de excepciones de ESB. Microsoft BizTalk ESB Toolkit incluye una plantilla de InfoPath que se ajusta a la siguiente instrucción de procesamiento.
<?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"?>
Componente de seguimiento de BAM de canalización de procesador de errores
El componente de canalización de seguimiento de BAM de ESB recibe el mensaje del componente Del codificador de excepciones de ESB y escribe los datos de error seleccionados en las tablas de importación principal de BAM creadas durante la instalación del marco de administración de excepciones de ESB.
El componente de seguimiento de BAM de ESB usa el método GetEventStream del contexto de canalización para agregar los siguientes campos como registro de actividad a la base de datos de importación principal de BAM:
Aplicación
Descripción
FaultSeverity
ServiceName
ErrorType
FaultCode
MachineName
MessageID
DateTime
FaultDescription
Ámbito
FailureCategory
FaultGenerator
ServiceInstanceID
El componente de seguimiento de BAM de ESB usa el valor del identificador de mensaje (la propiedad MessageID ) del mensaje de error de ESB como identificador de actividad de BAM. El componente de seguimiento de BAM de ESB expone dos propiedades en tiempo de diseño que puede establecer para cambiar su comportamiento en tiempo de ejecución:
Habilitado. Esta propiedad determina si el componente procesará el mensaje y lo escribirá en la base de datos bam. Cuando se establece en False, el componente simplemente envía el mensaje al siguiente componente de la canalización.
FaultDocumentNamespace. Esta propiedad tiene un valor predeterminado de
http://schemas.microsoft.biztalk.practices.esb.com/exceptionhandling.
Componente de transformación de canalización de procesador de errores
La canalización del procesador de errores de ESB usa el componente de canalización de transformación de ESB para ejecutar un mapa de BizTalk que traduce el mensaje de error ESB codificado en un formato que coincida con el esquema del adaptador de SQL de BizTalk (ExceptionSql.xsd). A continuación, el componente pasa el mensaje transformado al adaptador de SQL, que inserta el mensaje de error de ESB en la base de datos del Portal de administración de ESB.
El componente de canalización transformación de ESB expone tres propiedades en tiempo de diseño que se pueden modificar para cambiar su comportamiento en tiempo de ejecución:
Habilitado. Esta propiedad habilita o deshabilita el componente.
Validar. Esta propiedad especifica si se debe validar un mensaje.
MapName. Esta propiedad contiene el nombre del mapa que se debe ejecutar para traducir el mensaje de almacenamiento en la base de datos del Portal de administración de ESB. A continuación se muestra el valor predeterminado.
Microsoft.Practices.ESB.ExceptionHandling.Maps.FaultMessage_to_ExceptionSql, Microsoft.Practices.ESB.ExceptionHandling.Maps, Version=2.0.0.0, Culture=neutral, PublicKeyToken=c2c8b2b87f54180aUna vez que todos los componentes de canalización terminen de ejecutarse, el adaptador de base de datos de BizTalk SQL Server inserta el mensaje de error en la base de datos del Portal de administración de ESB.