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

Cuando se usa el Complemento de Proyecto BizTalk para Consumir Servicio de Adaptador para generar metadatos para un artefacto de base de datos de Oracle, aparte de los archivos de esquema, el complemento para 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 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

Al usar el complemento de proyecto Consumir servicio de adaptador de BizTalk, 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 crearlo 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 del servicio Adaptador Consume:

• 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 es 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 es 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 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 en el 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 en <Operation Name="Select" Action="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/ACCOUNTACTIVITY/Select" />. 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 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 la base de datos de Oracle a través del puerto de envío.

• Solo tiene que proporcionar las credenciales del puerto para conectarse 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 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 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, recibirá 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, puede que tenga una orquestación con un puerto de envío o recepción 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 enlaces para realizar los siguientes cambios:

  Para esto	Haga esto
  Para editar el archivo de enlaces de puerto para configurar un puerto de envío unidireccional	- En el fragmento siguiente, cambie el valor de la propiedad IsTwoWay a false. Originalmente, se establece en verdadero. <SendPort Name="port_name" IsStatic="true" IsTwoWay="false" BindingOption="0"> - Comentar 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 fragmento siguiente, cambie el valor de la propiedad IsTwoWay a false. Inicialmente, se establece en verdadero. <ReceivePort Name="port_name" IsTwoWay="false" BindingOption="1"> - Comentar 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 del puerto generado mediante el complemento Consumir Servicio de Adaptador.

El complemento Consumir Adaptador de Servicio 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-OracleDB en la consola de administración de BizTalk Server. 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 con el que agregó el adaptador de WCF-OracleDB en la consola de administración de BizTalk Server. 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 la consola de administración de BizTalk Server. Para obtener instrucciones sobre cómo importar el archivo de enlace, consulte Reutilización de enlaces del adaptador de base de datos de Oracle.

Véase también

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