Compartir vía

Propiedades de configuración para adaptadores integrados de BizTalk

  • Artículo

El modelo de objetos de BizTalk Explorer expone las propiedades IReceiveLocation.CustomData e ISendPort.CustomData que contienen el contenedor de propiedades de configuración del adaptador en forma de cadena XML de par nombre/valor. Esta cadena XML de par nombre-valor se almacena en un <elemento CustomProps> dentro de un <elemento TransportTypeData> en un archivo de enlace. La mayoría de la información del <elemento CustomProps> corresponde a la información que se puede establecer para un adaptador en la interfaz de usuario de BizTalk Server (como la Consola de administración de BizTalk o el Explorador de BizTalk). Si estos valores se encuentran en un archivo de enlace, se aplicarán a la configuración del adaptador para las ubicaciones de recepción y los puertos de envío especificados cuando se importa el archivo de enlace. La información de configuración de todos los adaptadores se almacena en la base de datos de Inicio de sesión único.

En esta sección se describen las propiedades de configuración que se pueden definir para cada adaptador integrado de BizTalk.

Nota

La información de contraseña almacenada en el <elemento TransportTypeData> de un archivo de enlace se enmascara para que los datos confidenciales no se guarden en texto no cifrado. En función del transporte, la información de la contraseña se reemplaza con un valor nulo (NULL) o con asteriscos. Debe especificar manualmente esta información en el archivo de enlace para actualizar la configuración del adaptador antes de importar el archivo de enlace a la configuración del BizTalk Server de destino.

Los datos de configuración de los adaptadores creados mediante el marco de trabajo del adaptador se almacenan en un <elemento AdapterConfig> . Puesto que el <elemento AdapterConfig> especifica el tipo de datos VT_BSTR (vt="8"), los < > caracteres contenidos en este elemento deben ser de escape o se producirá un error al intentar importar el archivo de enlace. Esto causa que el texto de los datos de configuración sea menos legible para las personas que si estos caracteres no estuvieran acompañados de marcas de escape. En el ejemplo siguiente se muestra el efecto de las marcas de escape de estos caracteres desde los datos de configuración de ejemplo para un puerto de envío enlazado al adaptador de POP3.

Datos de configuración de TransportTypeData que no escapan de los <> caracteres usados en el <elemento AdapterConfig>

Estos datos de configuración no son válidos porque el elemento AdapterConfig> especifica el tipo de datos VT_BSTR (vt="8") y los <> caracteres contenidos en el <elemento AdapterConfig> no tienen escape:<

<TransportTypeData>  
<CustomProps>  
<AdapterConfig vt="8">  
<Config xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
<mailServer>test.microsoft.com</mailServer>  
<serverPort>0</serverPort>  
<userName>testuser</userName>  
<password>******</password>  
<authenticationScheme>Basic</authenticationScheme>  
<sslRequired>false</sslRequired>  
<applyMIME>true</applyMIME>  
<bodyPartContentType>text/xml</bodyPartContentType>  
<bodyPartIndex>1</bodyPartIndex>  
<errorThreshold>10</errorThreshold>  
<pollingInterval>5</pollingInterval>  
<pollingUnitOfMeasure>Minutes</pollingUnitOfMeasure>   
<uri>POP3://test.microsoft.com#testuser</uri>  
</Config>  
</AdapterConfig>  
</CustomProps>  
</TransportTypeData>

Datos de configuración de TransportTypeData que se escapan de los <> caracteres usados en el <elemento AdapterConfig>

Dado que el <elemento AdapterConfig> especifica el tipo de datos VT_BSTR (vt="8"), los <> caracteres deben escaparse del <elemento AdapterConfig> , como se muestra a continuación:

<TransportTypeData>  
<CustomProps>  
<AdapterConfig vt="8">  
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
xmlns:xsd="http://www.w3.org/2001/XMLSchema"><mailServer>test  
microsoft.com</mailServer><serverPort>0</serverPort>&  
lt;userName>testuser</userName><password>******</pass  
word><authenticationScheme>Basic</authenticationScheme>&  
lt;sslRequired>false</sslRequired><applyMIME>true</ap  
plyMIME><bodyPartContentType>text/xml</bodyPartContentType&  
gt;<bodyPartIndex>1</bodyPartIndex><errorThreshold>10  
</errorThreshold><pollingInterval>5</pollingInterval>  
<pollingUnitOfMeasure>Minutes</pollingUnitOfMeasure><uri  
>POP3://test.microsoft.com#testuser</uri></Config>  
</AdapterConfig>  
</CustomProps>  
</TransportTypeData>

Entre los adaptadores integrados que se han creado con el marco de trabajo de adaptadores se incluyen los siguientes:

  • Adaptador de FTP

  • Adaptador de MQSeries

  • Adaptador de MSMQ

  • Adaptador de POP3

  • Adaptador de Windows Sharepoint Services

    Para ver una cadena de ejemplo usada como los datos de configuración de TransportTypeData para cada adaptador integrado, consulte en esta sección el tema sobre propiedades de configuración asociado al adaptador que corresponda.

En esta sección

Tipos de variables de las propiedades de configuración

Propiedades de configuración del adaptador de archivo

Propiedades de configuración del adaptador de FTP

Propiedades de configuración del adaptador de HTTP

Propiedades de configuración del adaptador de MQSeries

Propiedades de configuración del adaptador de MSMQ

Propiedades de configuración del adaptador de POP3

Propiedades de configuración del adaptador de SMTP

Propiedades de configuración del adaptador de SOAP

Propiedades de configuración del adaptador de Windows SharePoint Services