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 Consumir Servicio de Adaptador de Proyecto BizTalk para generar metadatos para un artefacto de SQL Server, además 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 mediante 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 puertos para crear puertos de envío unidireccionales.

Nota:

Para las operaciones entrantes, el archivo de enlace de puertos 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 Consumo del Servicio de Adaptador y usarlo para crear un puerto de WCF-SQL. Para obtener más información, consulte Configuración de un puerto WCF-SQL usando el archivo de enlace de puerto generado mediante el complemento Consume Adapter Service.

A continuación se presentan algunos puntos clave que debe comprender con respecto al archivo de enlace que genera el complemento del 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 del 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 de inserción en la tabla del cliente, la acción en el puerto se establece en <Operation Name="Insert" Action="TableOp/Insert/dbo/CustomerTable" />. Sin embargo, es posible que el nombre de la operación no sea el mismo en el puerto de envío lógico que cree dentro de la orquestación de BizTalk. 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 la consola de administración de BizTalk Server) son 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 asignación de puertos

  • 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 con un puerto de envío unidireccional. Por lo tanto, al configurar esta orquestación y usar el puerto creado mediante la importación del 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 esto Haga esto
    Para editar el archivo de enlace de puertos para configurar un puerto de envío unidireccional 1. En el fragmento siguiente, 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

    Para las operaciones entrantes, el archivo de enlace de puertos 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 utilizando el archivo de vinculación de puerto generado con el complemento Consume Adapter Service

El Complemento de Servicio del Adaptador de Consumo también crea un archivo de enlace de puerto que se puede importar en la consola de administración de BizTalk Server. Puede usar el mismo archivo de enlace de puerto para crear también el puerto de bizTalk WCF-SQL en la consola de administración de BizTalk Server. Sin embargo, antes de crear WCF-SQL puerto, 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 con el que agregó el adaptador de WCF-SQL en la consola de administración de BizTalk Server. Por ejemplo, si agregó el adaptador de 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 la consola de administración de BizTalk Server. Para obtener instrucciones sobre cómo importar el archivo de enlace, consulte Reutilización de enlaces de adaptador.

Véase también

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