Compartir a través de


Configuración de un enlace de puerto físico mediante un archivo de enlace de puerto para usar el adaptador de SQL

Cuando se usa el Complemento de proyecto de BizTalk de servicio de adaptador de consumo para generar metadatos para un artefacto de SQL Server, aparte de los archivos de esquema, el complemento consumir servicio de adaptador también genera un archivo de enlace de puerto. Puede importar este archivo de enlace en la aplicación de BizTalk para crear un puerto físico de envío o recepción. Para obtener instrucciones sobre cómo importar archivos de enlace, consulte Reutilización de enlaces de adaptador. Si importa este archivo de enlace, no es necesario crear manualmente un puerto de envío o recepción físicos.

Importante

Al usar el Complemento de servicio de adaptador de consumo, si no especifica un valor para una propiedad de enlace de tipo cadena y cuyo valor predeterminado es NULL, esa propiedad de enlace no estará disponible en el archivo de enlace. Debe agregar manualmente la propiedad de enlace y su valor en el archivo de enlace, si es necesario.

La creación de un puerto mediante el archivo de enlace de puertos siempre crea un puerto de envío bidireccional o un puerto de recepción unidireccional. Si desea crear un puerto de envío unidireccional, puede crearlo manualmente siguiendo los pasos descritos en Configuración manual de un enlace de puerto físico al adaptador de SQL. O bien, puede seguir las soluciones alternativas documentadas en este tema para modificar el archivo de enlace de puerto para crear puertos de envío unidireccionales.

Nota

En el caso de las operaciones entrantes, el archivo de enlace de puerto siempre creará un puerto de recepción unidireccional. Esto se debe a que el adaptador de SQL solo admite el puerto de recepción unidireccional para las operaciones entrantes.

Importante

El uso del Asistente para agregar metadatos del adaptador no crea un archivo de enlace de puerto mediante el que puede crear un puerto WCF-SQL. Sin embargo, puede realizar algunos cambios en el archivo de enlace de puerto generado por el Complemento de servicio consumir adaptador y usarlo para crear un puerto WCF-SQL. Para obtener más información, vea Configuración de un puerto WCF-SQL mediante el archivo de enlace de puertos generado mediante el complemento de servicio consumir adaptador.

A continuación se muestran algunos puntos clave que debe comprender con respecto al archivo de enlace que genera el complemento de servicio de adaptador de consumo:

  • Los archivos se crean con una convención de nomenclatura específica. Si generó metadatos para las operaciones salientes, es decir, para enviar mensajes a SQL Server, el nombre del archivo es WcfSendPort_SqlAdapterBinding_Custom.bindinginfo.xml.

    Si generó metadatos para las operaciones entrantes, es decir, para recibir mensajes de SQL Server, el nombre del archivo es WcfReceivePort_SqlAdapterBinding_Custom.bindinginfo.xml.

  • El archivo contiene información sobre la configuración de enlace, el tipo de enlace, el URI del punto de conexión y la acción de puerto en función de las operaciones para las que se generaron metadatos. Al importar este archivo de enlace en la aplicación de BizTalk para crear un puerto, toda la información pertinente necesaria para configurar un puerto físico se establece automáticamente en el puerto.

    Importante

    De forma predeterminada, la acción en el puerto de envío se asigna al nombre de la operación para la que generó metadatos. Por ejemplo, si genera metadatos para la operación Insertar en la tabla Customer, la acción en el puerto se establece <Operation Name="Insert" Action="TableOp/Insert/dbo/CustomerTable" />en . Sin embargo, es posible que el nombre de la operación en el puerto de envío lógico que cree en la orquestación de BizTalk no sea el mismo. Debe asegurarse de que el nombre de la operación en el puerto de envío lógico (en la orquestación de BizTalk) y el puerto de envío físico (en BizTalk Server consola de administración) sean los mismos. Si no es así, recibirá un error al enviar mensajes a SQL Server a través del puerto de envío.

  • Solo tiene que proporcionar las credenciales para que el puerto se conecte a SQL Server. Aunque el archivo de enlace conserva el nombre de usuario con el que conectarse, por motivos de seguridad el archivo de enlace no contiene la contraseña.

Consideraciones clave para usar el archivo de enlace de puerto

  • Al importar el archivo de enlace, es posible que reciba un mensaje de diálogo que informa de que el nombre de la aplicación de BizTalk en el archivo de enlace no coincide con el nombre de la aplicación al que va a importar el archivo de enlace. Puede omitir este mensaje de forma segura y continuar.

  • El archivo de enlace también contiene nombres de puertos y ubicaciones de recepción. Si la aplicación de BizTalk a la que va a importar el archivo de enlace crea un puerto o una ubicación de recepción que tiene el mismo nombre que un puerto ya existente en la misma aplicación de BizTalk, obtendrá un error. Debe editar manualmente el archivo de enlace para especificar un nombre único para los puertos o ubicaciones de recepción.

  • El archivo de enlace también contiene información sobre el URI de conexión. Si el archivo de enlace crea una ubicación de recepción que tiene el mismo URI de recepción que una ubicación de recepción ya existente en la misma aplicación de BizTalk, recibirá un error. Debe editar manualmente el archivo de enlace para especificar un URI único.

  • De forma predeterminada, el archivo de enlace de puertos para las operaciones salientes siempre contiene definiciones para un puerto de envío bidireccional. Al importar este archivo en una aplicación de BizTalk, se crea un puerto de envío bidireccional. Sin embargo, es posible que tenga una orquestación que tenga un puerto de envío unidireccional. Por lo tanto, al configurar esta orquestación y usar el puerto creado importando el archivo de enlace, el puerto no está disponible en la lista. Esto sucede porque el puerto lógico que creó como parte de la orquestación es un puerto unidireccional mientras que el puerto físico creado en la orquestación es un puerto bidireccional. En tales casos, puede editar el archivo de enlace para realizar los siguientes cambios:

    Para Haga esto
    Para editar el archivo de enlace de puerto para configurar un puerto de envío unidireccional 1. En el siguiente extracto, cambie el valor de la propiedad IsTwoWay a false. Originalmente, se establece en true.
    <SendPort Name="port_name" IsStatic="true" IsTwoWay="false" BindingOption="0">
    2. Comente los siguientes extractos:
    <ReceivePipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLReceive" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="1" TrackingOption="None" Description=""/>
    <ReceivePipelineData xsi:nil="true" />

    Importante

    En el caso de las operaciones entrantes, el archivo de enlace de puerto siempre creará un puerto de recepción unidireccional. Esto se debe a que el adaptador de SQL solo admite el puerto de recepción unidireccional para las operaciones entrantes.

Configurar un puerto WCF-SQL mediante el archivo de enlace de puerto generado mediante el complemento de servicio consumir adaptador

El Complemento de servicio consumir adaptador también crea un archivo de enlace de puerto que puede importar en BizTalk Server consola de administración. Puede usar el mismo archivo de enlace de puerto para crear también el puerto WCF-SQL de BizTalk en BizTalk Server consola de administración. Sin embargo, antes de crear el puerto WCF-SQL, debe realizar las siguientes tareas para modificar el archivo de enlace de puerto.

  1. Abra el archivo de enlace de puertos en un editor de texto.

  2. Busque y reemplace "WCF-Custom" por el nombre por el que agregó el adaptador WCF-SQL en BizTalk Server consola de administración. Por ejemplo, si agregó el adaptador WCF-SQL como "SQLAdapter", reemplace "WCF-Custom" por "SQLAdapter".

  3. Busque el atributo "ConfigurationClsid" y reemplace el valor existente del atributo por "59B35D03-6A06-4734-A249-EF561254ECF7".

  4. Guarde y cierre el archivo de enlace.

  5. Importe el archivo de enlace en BizTalk Server consola de administración. Para obtener instrucciones sobre cómo importar el archivo de enlace, consulte Reutilización de enlaces de adaptador.

Consulte también

Bloques de creación para desarrollar aplicaciones de BizTalk con el adaptador de SQL