Tutorial: Usar el adaptador de BizTalk para TIBCO Rendezvous para recibir datos
Puede usar el Adaptador de BizTalk para TIBCO Rendezvous para recibir datos de un sistema TIBCO. En este tutorial se describe un ejemplo de SDK que ilustra este proceso.
Requisitos previos
Instale Visual Studio en el BizTalk Server en el que se ejecuta el adaptador para compilar e implementar el ejemplo.
Sobre el ejemplo
Este ejemplo usa el Adaptador de BizTalk para TIBCO Rendezvous para recibir datos de un sistema TIBCO. Una orquestación procesa el mensaje y, mediante el adaptador de archivos, escribe los datos como un archivo XML en una carpeta especificada.
En este ejemplo, diseñado en Visual Studio, se muestra la funcionalidad básica mediante el adaptador de BizTalk para TIBCO Enterprise Message Service con una orquestación de BizTalk.
Nota
Este ejemplo supone que sabe cómo enviar un mensaje desde TIBCO para que la aplicación lo procese.
La ubicación predeterminada del ejemplo es
C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Rendezvous(r)\Sdk\OneWayReceive
, e incluye los siguientes archivos:Nombre del archivo del proyecto de tiempo de ejecución Descripción del archivo del proyecto de tiempo de ejecución OneWayReceive.btproj,
OneWayReceive.slnArchivos de proyectos y soluciones para la aplicación. PureMessage.xsd, Archivo de esquema de la aplicación. TIBCORvOWR.odx La orquestación usada por la aplicación. TIBCORv.snk Archivo de clave de nombre seguro.
Paso 1: Agregar el adaptador a la administración de BizTalk
En administración de BizTalk Server, expanda Grupo de BizTalk, expanda Configuración de la plataforma y, a continuación, haga clic en Adaptadores.
Haga clic con el botón derecho en Adaptadores y seleccione Nuevo, Adaptador... para mostrar el cuadro de diálogo Propiedades del adaptador .
Escriba un valor para el campo Nombre , por ejemplo , TIBCO Rendezvous.
Seleccione TIBCO(r) Rendezvous(r) en la lista de adaptadores disponibles en la lista desplegable Adaptador y haga clic en Aceptar.
Paso 2: Crear un puerto de recepción
En administración de BizTalk Server, expanda Grupo de BizTalk, Aplicaciones, Aplicación de BizTalk 1 y haga clic en Puertos de recepción.
Haga clic con el botón derecho en la carpeta Puertos de recepción y, a continuación, haga clic en Nuevo puerto de recepción unidireccional... para mostrar el cuadro de diálogo Propiedades del puerto de recepción.
Escriba un valor para el campo Nombre , por ejemplo , TIBCORvOneWayRP y haga clic en Aceptar.
Paso 3: Crear una ubicación de recepción
Haga clic con el botón derecho en el nuevo puerto de recepción y, a continuación, haga clic en Nuevo, Ubicación de recepción... para mostrar el cuadro de diálogo Propiedades de ubicación de recepción .
Escriba un valor para el campo Nombre . Por ejemplo, escriba TIBCORvOneWayRL.
Seleccione el adaptador TIBCO Rendezvous de la lista de adaptadores disponibles en el cuadro desplegable Tipo y haga clic en el botón Configurar para mostrar el cuadro de diálogo Propiedades de transporte del adaptador.
Nota
Este valor es el nombre que se especificó cuando se creó el adaptador de TIBCO en la consola de administración de BizTalk Server.
Escriba un valor para RendezvousSubjectName en AdapterRequiredProperties.
Escriba los valores de Las propiedades del agente de escucha certificado:
Propiedad Valor Nombre de archivo de contabilidad Nombre del archivo de contabilidad que se va a usar para la entrega de mensajes certificados persistentes. Nombre reutilizable Nombre reutilizable correspondiente que se va a usar para la entrega de mensajes certificados. El nombre debe ser único entre todos los nombres de correspondientes de mensajes certificados en la red. Escriba valores para las credenciales:
Propiedad Valor Contraseña La contraseña para el servidor TIBCO Rendezvous. Nombre de usuario El nombre de usuario para el servidor TIBCO Rendezvous. Escriba los valores de RendezvousTransport:
Propiedad Valor Demonio Parámetro del demonio del transporte de Rendezvous. Red Parámetro de red del transporte de Rendezvous. Servicio Parámetro de servicio del transporte de Rendezvous. Para obtener más información sobre las propiedades, consulte Creación de artefactos de recepción.
Haga clic en OK.
Seleccione XMLReceive en la lista de canalizaciones disponibles en el cuadro desplegable Canalización de recepción y haga clic en Aceptar.
Haga clic con el botón derecho en la ubicación de recepción y haga clic en Habilitar.
Paso 4: Crear un puerto de envío unidireccional
Cree una carpeta de destino que va a usar el puerto de envío; por ejemplo C:\FilesOut.
En la consola de administración de BizTalk Server, expanda administración BizTalk Server, expanda Grupo de BizTalk, aplicaciones, aplicación de BizTalk 1 y haga clic en Puertos de envío.
Haga clic con el botón derecho en Puertos de envío y seleccione Nuevo, Estático One-Way Puerto de envío... para mostrar el cuadro de diálogo Propiedades del puerto de envío.
Escriba un valor para el campo Nombre , por ejemplo , TIBCORvOneWayFileSP.
Seleccione ARCHIVO en la lista de adaptadores disponibles en el cuadro desplegable Tipo y haga clic en el botón Configurar para mostrar el cuadro de diálogo Propiedades de transporte del adaptador.
En la propiedad Carpeta de destino , escriba la ubicación de la carpeta que creó anteriormente y haga clic en Aceptar.
Seleccione la canalización XMLTransmit en la lista de canalizaciones disponibles en la lista desplegable Enviar canalización y haga clic en Aceptar.
Haga clic con el botón derecho en el puerto de envío y haga clic en Iniciar para inscribirse e iniciar el puerto de envío.
Paso 5: Compilar e implementar el proyecto
Haga clic con el botón derecho en el proyecto OneWayReceive en Explorador de soluciones y haga clic en Propiedades para iniciar project Designer para el proyecto.
Haga clic en la pestaña Implementación .
Escriba los valores adecuados para la propiedad Server y la propiedad Base de datos de configuración en la categoría Grupo de BizTalk .
Haga clic con el botón derecho en el proyecto OneWayReceive en Explorador de soluciones y haga clic en Implementar para compilar el proyecto e implementar el ensamblado en la base de datos de configuración de BizTalk Server.
Paso 6: Enlazar, Inscribir e iniciar la orquestación
En la consola de administración de BizTalk Server, expanda administración BizTalk Server, expanda Grupo de BizTalk, aplicaciones, aplicación de BizTalk 1 y haga clic en Orquestaciones.
Haga clic en el botón Actualizar de la barra de herramientas de la consola de administración de BizTalk Server o presione la tecla F5 en el teclado para actualizar la vista de consola de administración de BizTalk Server.
Haga doble clic en la orquestación para mostrar el cuadro de diálogo Propiedades de orquestación .
Haga clic en Enlaces en el panel izquierdo del cuadro de diálogo para mostrar las opciones Enlaces de la orquestación.
Especifique los valores adecuados para las opciones de enlace, por ejemplo:
Parámetro Valor Host BizTalkServerApplication SendPort TIBCORvOneWayFileSP ReceivePort TIBCORvOneWayRP Haga clic en OK.
Haga clic con el botón derecho en la orquestación y haga clic en Iniciar para inscribirse e iniciar la orquestación.
Paso 7: Confirmar que la aplicación recibe un mensaje
Abra la carpeta a la que está configurado el puerto de envío de archivos para enviar y compruebe que se generó un documento de salida.
Si la instancia de documento se procesa correctamente, se produce la siguiente secuencia de eventos:
El adaptador de TIBCO Rendezvous recibe un mensaje del sistema TIBCO y lo publica en el cuadro de mensajes como un mensaje de BizTalk.
La orquestación se suscribe a este mensaje publicado para que el motor de mensajería de BizTalk active una instancia de la orquestación y envíe el mensaje a ésta.
La instancia de orquestación publica el mensaje en el cuadro de mensajes.
El puerto de envío de archivos se suscribe a este mensaje, por lo que BizTalk envía el mensaje al adaptador de archivo.
El adaptador de archivos escribe un mensaje que contiene el conjunto de resultados en la carpeta de salida designada.
Consulte también
Tutorial: Uso del adaptador de BizTalk para TIBCO Rendezvous para enviar datos
Tutoriales: Uso del Adaptador de Microsoft BizTalk para TIBCO Rendezvous
Introducción