Configuración de un enlace de puerto físico mediante un archivo de enlace de puerto a Oracle Database

  • Artículo

Cuando se usa el complemento consumir el proyecto de BizTalk del servicio adaptador para generar metadatos para un artefacto de base de datos de Oracle, 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 de envío o recepción físicos. Para obtener instrucciones sobre cómo importar archivos de enlace, consulte Reutilización de enlaces del adaptador de base de datos de Oracle. Si importa este archivo de enlace, no es necesario crear manualmente un puerto de envío o recepción físicos.

Importante

Mientras se usa el complemento Consumir servicio de adaptador de BizTalk Project, 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 un archivo de enlace de puertos siempre crea puertos de envío o recepción bidireccionales. Si desea crear puertos de envío o recepción unidireccionales, puede crearlos manualmente siguiendo el procedimiento mencionado en Configuración manual de un enlace de puerto físico al adaptador de base de datos de Oracle. 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 o recepción unidireccionales.

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

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

    Si generó metadatos para las operaciones entrantes, es decir, recibir mensajes de la base de datos de Oracle, el nombre del archivo se WcfReceivePort_OracleDBBinding_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 los metadatos. Al importar este archivo de enlace 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 se generan metadatos. Por ejemplo, si genera metadatos para una operación Select en la tabla ACCOUNTACTIVITY, la acción del puerto se establece <Operation Name="Select" Action="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/ACCOUNTACTIVITY/Select" />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 lógico (en la orquestación de BizTalk) y el puerto de envío físico (en BizTalk Server consola de administración) son los mismos. Si no es así, recibirá un error al enviar mensajes a la base de datos de Oracle a través del puerto de envío.

  • Solo tiene que proporcionar las credenciales para que el puerto se conecte a la base de datos de Oracle. 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 y continuar de forma segura.

  • 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 enlaces 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, obtendrá un error. Debe editar manualmente el archivo de enlace para especificar un URI único. Puede especificar un URI único mediante la inclusión de un identificador de sondeo.

  • De forma predeterminada, el archivo de enlace de puertos siempre contiene definiciones para puertos bidireccionales (envío o recepción). Al importar este archivo en una aplicación de BizTalk, crea un puerto de envío o recepción bidireccional. Sin embargo, es posible que tenga una orquestación que tenga un puerto de envío o recepción 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 enlaces para realizar los siguientes cambios:

    Para Haga esto
    Para editar el archivo de enlaces de puerto para configurar un puerto de envío unidireccional - 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">

    - Convierta en comentario 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" />
    Para editar el archivo de enlaces de puerto para configurar un puerto de recepción unidireccional - En el siguiente extracto, cambie el valor de la propiedad IsTwoWay a false. Originalmente, se establece en true.

    <ReceivePort Name="port_name" IsTwoWay="false" BindingOption="1">

    - Convierta en comentario los siguientes extractos:

    <SendPipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLTransmit" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLTransmit, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="2" TrackingOption="None" Description="" />

    <SendPipelineData xsi:nil="true" />

    <SendPipelineData xsi:nil="true" />

Configuración de un puerto de WCF-OracleDB mediante el archivo de enlace de puerto generado mediante el complemento de servicio consumir adaptador

El complemento Consumir servicio de adaptador 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 de bizTalk WCF-OracleDB en BizTalk Server consola de administración. Sin embargo, antes de crear WCF-OracleDB 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 por el que agregó el adaptador de WCF-OracleDB en BizTalk Server consola de administración. Por ejemplo, si agregó el adaptador de WCF-OracleDB como "OracleDBAdapter", reemplace "WCF-Custom" por "OracleDBAdapter".

  3. Busque el atributo "ConfigurationClsid" y reemplace el valor existente del atributo por "D7127586-E851-412e-8A8A-2428AEDDC219".

  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 del adaptador de base de datos de Oracle.

Consulte también

Bloques de creación para desarrollar aplicaciones de BizTalk con Oracle Database