Implementación de canalizaciones

Las canalizaciones se compilan e implementan como parte del proceso de compilación e implementación de la solución. El compilador llama al método Validate en cada componente, lo que permite a los componentes devolver errores de compilación en la información configurada. Después de la compilación, la canalización se implementa en el mismo ensamblado con el resto de la solución cuando se implementa la solución.

Configuración de canalización por instancia

La configuración de canalización por instancia se usa para modificar las propiedades de los componentes de canalización dentro de una canalización implementada en el puerto de envío o en el nivel de ubicación de recepción. La configuración de canalización por instancia es útil cuando solo es necesario modificar algunas propiedades de componentes de canalización por instancia. Por ejemplo, si necesita admitir diferentes tipos de mensajes en varias ubicaciones de recepción y tener una única canalización de recepción XML personalizada, la configuración de canalización por instancia le permite implementar la canalización e invalidar la configuración predeterminada (incluida la especificación de sobres y nombres de especificación de documentos diferentes). Este mecanismo se admite en la consola de administración de BizTalk y mediante programación a través del modelo de objetos del Explorador.

Per-Instance Configuración de la Canalización mediante la Consola de Administración de BizTalk

Puede realizar la configuración de canalización por instancia mediante la consola de administración de BizTalk. Una vez que haya implementado su canalización personalizada, cree tantas ubicaciones de recepción o puertos de envío como sea necesario. A continuación, para cada ubicación de recepción o puerto de envío, invalide los valores de propiedad predeterminados a través del cuadro de diálogo Configurar canalización. Por ejemplo, para especificar un esquema de documento diferente, escriba un nombre de esquema para la propiedad EnvelopeDocSpecNames .

Advertencia

No se realizará ninguna validación de los valores de configuración especificados en la ubicación de recepción o el puerto de envío. Si la configuración es incorrecta, se producirá un error en los mensajes en tiempo de ejecución al pasar por la canalización.

Per-Instance configuración de canalización mediante el modelo de objetos del Explorador

Cuando se lee el archivo XML que describe la configuración por instancia de los componentes de canalización, invalida las propiedades establecidas en el archivo de canalización.

La configuración de canalización por instancia se establece mediante el modelo de objetos del Explorador de BizTalk. El modelo de objetos del Explorador de BizTalk proporciona la propiedad ReceivePipelineData en las interfaces IReceiveLocation e ISendPort para establecer la configuración de los componentes de canalización de recepción. El modelo de objetos de BizTalk Explorer también proporciona el método SendPipelineData en las interfaces IReceivePort e ISendPort para establecer la configuración de componentes de canalización de envío.

La configuración de canalización por instancia no admite lo siguiente:

• Reorganización de fases dentro de la canalización

• Agregar o quitar fases

• Reorganización de componentes dentro de fases

• Adición o eliminación de componentes

  Los únicos cambios admitidos están en la configuración de los componentes de canalización. La configuración por instancia de un componente de canalización invalida la configuración del componente de canalización común. Si no se especifica un parámetro de un componente en la configuración de canalización por instancia, se usa la configuración común para ese parámetro (como configurado en el Diseñador de canalizaciones).

  A continuación se muestra un ejemplo de datos de configuración por instancia.

<?xml version="1.0" encoding="utf-16"?>  
<Root xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
    <Stages>  
        <Stage CategoryId="9d0e4103-4cce-4536-83fa-4a5040674ad6">  
            <Components>  
                <Component Name=Microsoft Microsoft.BizTalk.Component.MIME_SMIME_Decoder>  
                    <Properties>  
                        <AllowNonMIMEMessage vt=11>true</AllowNonMIMEMessage>  
                    </Properties>  
                </Component>  
            </Components>  
        </Stage>  
        <Stage CategoryId="9d0e4105-4cce-4536-83fa-4a5040674ad6">  
            <Components>  
                <Component Name=Microsoft.BizTalk.Component.XmlDasmComp>  
                    <Properties>  
                        <EnvelopeSpecNames vt=8>MySchemas.EnvelopeSpecNames</EnvelopeSpecNames>  
                        <AllowUnrecognizedMessage vt=11>false</AllowUnrecognizedMessage>  
                    </Properties>  
                </Component>  
            </Components>  
        </Stage>  
        <Stage CategoryId="9d0e410d-4cce-4536-83fa-4a5040674ad6" ExecutionSequence="2">  
            <Components>  
                 <Component Name=Microsoft.BizTalk.Component.XmlValidator >  
                    <Properties>  
                        <DocumentSpecName vt=8>MySchemas.DocspecName</DocumentSpecName>  
                    </Properties>  
                </Component>  
            </Components>  
        </Stage>  
    </Stages>  
</Root>  

Véase también

Desarrollo de componentes de canalización personalizados