Compartir a través de

Tutorial: Uso del adaptador de BizTalk para TIBCO Rendezvous para enviar datos

  • Artículo

Puede usar BizTalk Adapter para TIBCO Rendezvous para enviar datos a 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.

  • En el ejemplo se utiliza una DLL que contiene las propiedades del contexto del mensaje: Microsoft.BizTalk.Adapters.TibRV.Properties.dll. Puede necesitar actualizar la referencia de la solución a esta biblioteca. Para obtener más información, vea BizTalk Server propiedades de contexto de mensaje (controladores de envío).

Sobre el ejemplo

  • Este ejemplo toma un archivo XML de una carpeta de archivos, envía el archivo a una orquestación y, luego, usa BizTalk Adapter para TIBCO Rendezvous para crear un registro en el sistema TIBCO.

  • En este ejemplo, diseñado en Visual Studio, se muestra la funcionalidad básica mediante el adaptador de BizTalk para TIBCO Rendezvous con una orquestación de BizTalk.

  • La ubicación predeterminada para el ejemplo es C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Rendezvous(r)\Sdk\OneWaySende 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
    OneWaySend.btproj

    OneWaySend.sln    		 Archivos de proyectos y soluciones para la aplicación.
    Schema.xsd

    PropertySchema.xsd    		 Esquema y archivos de esquema de propiedades para la aplicación.
    Orchestration.odx La orquestación usada por la aplicación.
    TIBCORendezvousOneWaySend.snk Archivo de clave de nombre seguro.

Paso 1: Agregar el adaptador a la administración de BizTalk

  1. En BizTalk Server Administración, expanda Grupo de BizTalk, expanda Configuración de la plataforma y, a continuación, haga clic en Adaptadores.

  2. Haga clic con el botón derecho en Adaptadores y seleccione Nuevo, Adaptador... para mostrar el cuadro de diálogo Propiedades del adaptador .

  3. Escriba un valor para el campo Nombre . Por ejemplo, escriba TIBCO Rendezvous.

  4. 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 envío

  1. En BizTalk Server Administración, expanda Grupo de BizTalk, Aplicaciones, Aplicación de BizTalk 1 y haga clic en Puertos de envío.

  2. 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.

  3. Escriba un valor para el campo Nombre , por ejemplo TIBCORndOneWaySP.

  4. Seleccione el adaptador TIBCO Rendezvous 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.

    Nota

    Este valor es el nombre que se especificó cuando se creó el adaptador del sistema de mensajes de empresa tiBCO en la consola de administración de BizTalk Server.

  5. Escriba valores para las propiedades del remitente 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.

  6. 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.

  7. 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 los artefactos de envío.

  8. Haga clic en OK.

  9. Seleccione la canalización de transmisión XML en la lista de canalizaciones disponibles en la lista desplegable Enviar canalización y haga clic en Aceptar.

  10. Haga clic con el botón derecho en el puerto de envío y haga clic en Iniciar para dar de alta e iniciar el puerto de envío.

Paso 3: Crear un puerto de recepción

  1. En administración de BizTalk Server, expanda Grupo de BizTalk, Aplicaciones, Aplicación de BizTalk 1 y haga clic en Puertos de recepción.

  2. 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.

  3. Escriba un valor para el campo Nombre , por ejemplo TIBCORndOneWayFileRP, y haga clic en Aceptar.

Paso 4: Crear una ubicación de recepción

  1. Cree una carpeta para la ubicación de recepción de archivos que se debe supervisar, por ejemplo, C:\Filesource.

  2. Haga clic con el botón derecho en el nuevo puerto de recepción y, a continuación, haga clic en Nueva, Ubicación de recepción... para mostrar el cuadro de diálogo Propiedades de ubicación de recepción .

  3. Escriba un valor para el campo Nombre , por ejemplo TIBCORndOneWayFileRL.

  4. Seleccione FILE 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.

  5. Escriba la ubicación de la carpeta que creó anteriormente para la propiedad Receive Folder y haga clic en Aceptar.

  6. Seleccione XMLReceive en la lista de canalizaciones disponibles en el cuadro desplegable Recibir canalización y haga clic en Aceptar.

  7. Haga clic con el botón derecho en la ubicación de recepción y haga clic en Habilitar.

Paso 5: Generación de una instancia de documento a partir del esquema

  1. En Visual Studio, haga clic con el botón derecho en Schema.xsd en Explorador de soluciones y haga clic en Propiedades.

  2. En el ventana Propiedades, haga clic para seleccionar la opción Nombre de archivo de instancia de salida en la sección General.

  3. Haga clic en el botón de puntos suspensivos (...) para mostrar el cuadro de diálogo Seleccionar archivo de salida .

  4. Especifique una carpeta y un nombre para la instancia del archivo de salida, por ejemplo ,C:\instance.xml y haga clic en Guardar.

    Nota

    No especifique aquí la ubicación de la carpeta que se especificó para la ubicación de recepción de archivos.

  5. Haga clic con el botón derecho en Schema.xsd en Explorador de soluciones y haga clic en Generar instancia para generar una instancia de documento en la ubicación especificada.

Paso 6: Actualizar la instancia de documento generada

  1. Abra la instancia de documento generada en un editor de texto (funciona el Bloc de notas) y edite el contenido de la instancia de documento para asegurarse de que los datos generarán un registro único en el sistema TIBCO. Por ejemplo, el código siguiente muestra la primera parte del archivo de datos:

    <ns0:Root xmlns:ns0="http://TibcoRendezvousOneWaySend.TibcoRendezvousOneWaySendSchema">  
    <Name>Punya Palit</Name>  
    <MailAddress>Prose Ware, Inc.</MailAddress>  
</ns0:Root>

  2. Guarde la instancia de documento modificada.

Paso 7: Compilar e implementar el proyecto

  1. Haga clic con el botón derecho en el proyecto OneWaySend en Explorador de soluciones y haga clic en Propiedades para iniciar el proyecto Designer del proyecto.

  2. Haga clic en la pestaña Implementación .

  3. Escriba los valores adecuados para la propiedad Server y la propiedad Base de datos de configuración en Grupo de BizTalk.

  4. Haga clic con el botón derecho en el proyecto OneWaySend 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 8: Enlazar, inscribir e iniciar la orquestación

  1. En BizTalk Server Administración, expanda Grupo de BizTalk, Aplicaciones, Aplicación de BizTalk 1 y haga clic en Orquestaciones.

  2. Haga clic en el botón Actualizar de la barra de herramientas de MMC o presione la tecla F5 del teclado para actualizar la vista de consola de administración de BizTalk Server.

  3. Haga doble clic en la orquestación para mostrar el cuadro de diálogo Propiedades de orquestación .

  4. Haga clic en Enlaces en el panel izquierdo del cuadro de diálogo para mostrar las opciones Enlaces de la orquestación.

  5. Especifique los valores adecuados para las opciones de enlace, por ejemplo:

    Parámetro Valor
    Host BizTalkServerApplication
    FileReceivePort TIBCORndOneWayFileRP
    TibcoRendezvousSend TIBCORndOneWaySP

  6. Haga clic en Aceptar.

  7. Haga clic con el botón derecho en la orquestación y haga clic en Iniciar para inscribirse e iniciar la orquestación.

Paso 9: Quitar un documento y comprobar el sistema TIBCO

  • Copie la instancia de documento que se creó anteriormente en la carpeta de recepción de archivos que la aplicación supervisa.

  • Use la interfaz web de TIBCO para comprobar que el registro se creó a partir de los datos del archivo XML.

Si la instancia de documento se procesa correctamente, se produce la siguiente secuencia de eventos:

  1. El adaptador de archivo recupera el archivo de la carpeta y lo publica en el cuadro de mensaje como un mensaje de BizTalk.

  2. La orquestación se suscribe a este mensaje publicado, por lo que el motor de mensajería de BizTalk activará una instancia de la orquestación y enviará el mensaje a la instancia de orquestación.

  3. La instancia de la orquestación procesa el mensaje mediante la lógica especificada en la orquestación y vuelve a publicar el mensaje en el cuadro de mensaje.

  4. El puerto de envío de TIBCO se suscribe a este mensaje publicado, por lo que el motor de mensajería de BizTalk envía el mensaje al puerto de envío de TIBCO.

  5. El puerto de envío entrega el mensaje a BizTalk Adapter para TIBCO Rendezvous.

  6. BizTalk Adapter para TIBCO Rendezvous envía el mensaje al sistema TIBCO.

Consulte también

Tutorial: Uso del adaptador de BizTalk para TIBCO Rendezvous para recibir datos
Tutoriales: Uso del Adaptador de Microsoft BizTalk para TIBCO Rendezvous
Introducción