Compartir a través de

Tutorial: Uso del adaptador de BizTalk para PeopleSoft Enterprise para recuperar datos de PeopleSoft Enterprise

  • Artículo

El adaptador de BizTalk para PeopleSoft Enterprise se puede usar para ejecutar una consulta en un sistema PeopleSoft y devolver los resultados de la misma. En este tutorial se describe un ejemplo de SDK que muestra esta función.

Requisitos previos

  • La plataforma Java 2 debe instalarse en la BizTalk Server en la que se ejecuta el adaptador de BizTalk para PeopleSoft Enterprise Geis.

  • El archivo JAR del adaptador de objetos de Java de PeopleSoft, psjoa.jar debe copiarse en una carpeta a la que se pueda acceder a la BizTalk Server en la que se ejecuta el adaptador de BizTalk para PeopleSoft Enterprise.

  • Visual Studio debe instalarse en el BizTalk Server en el que se ejecuta el adaptador de BizTalk para PeopleSoft Enterprise para compilar e implementar el ejemplo.

Descripción del ejemplo

Este ejemplo toma un archivo XML de una carpeta, envía el archivo a una orquestación y, luego, usa el adaptador de BizTalk para PeopleSoft Enterprise para ejecutar una consulta en un sistema PeopleSoft. El resultado de la consulta se escribe en un archivo XML.

Cómo se ha diseñado este ejemplo y por qué

Este ejemplo se diseñó en Visual Studio y se creó para ilustrar la funcionalidad básica mediante el adaptador de BizTalk para PeopleSoft Enterprise con una orquestación de BizTalk.

Ubicación del ejemplo

El ejemplo se encuentra en la siguiente carpeta:

\Archivos de programa\Microsoft BizTalk Adapters for Enterprise Applications\PeopleSoft Enterprise(r)\Sdk\PeopleSoftTwoWaySend

En la tabla siguiente se enumeran los archivos del ejemplo y se describe su propósito.

Nombre del archivo del proyecto de tiempo de ejecución Descripción del archivo del proyecto de tiempo de ejecución
TwoWaySend.btproj,

TwoWaySend.sln		 Archivos de proyectos y soluciones para la aplicación.
LOCATIONService.xsd,

LOCATIONService_1.xsd,

LOCATIONService_2.xsd		 Archivos de esquema para la aplicación. Nota: Los archivos de esquema del adaptador del proyecto se crearon originalmente con el Asistente para agregar metadatos del adaptador. Para obtener más información sobre el Asistente para agregar metadatos de adaptador, vea el tema "Cómo agregar metadatos de adaptador a un proyecto de BizTalk" en la documentación de BizTalk Server.
PeopleSoftTwoWaySend.odx La orquestación usada por la aplicación.
PeopleSoftTwoWaySend.snk Archivo de clave de nombre seguro.

Uso del ejemplo

Crear una nueva instancia del adaptador de PeopleSoft Enterprise

  1. Inicie la consola de administración de BizTalk Server. Haga clic en Inicio, Programas, MicrosoftBizTalk Server BizTalk Server Administración.

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

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

  4. Escriba un valor para el campo Nombre , por ejemplo PeopleSoft.

  5. Seleccione PeopleSoft Enterprise(r) en la lista de adaptadores disponibles en la lista desplegable Adaptador y haga clic en Aceptar.

Crear un puerto de envío de petición-respuesta de BizTalk

  1. En la consola de administración de BizTalk Server, expanda administración de BizTalk Server, 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 Solicit-Response 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 PeopleSoftTwoWaySP.

  4. Seleccione el adaptador peopleSoft 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 especificado cuando se creó el adaptador de PeopleSoft Enterprise en la consola de administración.

  5. Escriba los valores siguientes para las propiedades necesarias del adaptador:

    Propiedad Valor
    Ruta de acceso de servidor de aplicaciones Equipo y ubicación de puerto de PeopleSoft Server, por ejemplo, //PSServer:8888. Nota: Si no especifica un número de puerto, se usa el puerto predeterminado de 9000, por lo que en el ejemplo anterior podría escribir un valor de //PSServer si PeopleSoft Server usa el valor de puerto predeterminado de 9000.
    JAVA_HOME Ruta de acceso para el directorio principal asociado a los archivos SDK de la plataforma Java 2, por ejemplo, C:\j2sdk1.4.2_08
    Contraseña Contraseña usada al conectar con el sistema PeopleSoft.
    Archivos JAR de PeopleSoft 8.x Ubicación del archivo JAR del adaptador de objetos de Java peopleSoft, psjoa.jar, por ejemplo C:\JARS\psjoa.jar.
    Nombre de usuario Nombre de usuario para conectar con el sistema PeopleSoft.

  6. Haga clic en OK.

  7. Seleccione la canalización XMLTransmit en la lista de canalizaciones disponibles en la lista desplegable Enviar canalización .

  8. Seleccione la canalización XMLReceive en la lista de canalizaciones disponibles en la lista desplegable Canalización de recepción y haga clic en Aceptar.

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

Crear un puerto de envío unidireccional de BizTalk

  1. Cree la carpeta de destino que va a usar el puerto de envío, por ejemplo, C:\Files\Out.

  2. En la consola de administración de BizTalk Server, expanda administración de BizTalk Server, expanda Grupo de BizTalk, aplicaciones, aplicación de BizTalk 1 y haga clic en Puertos de envío.

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

  4. Escriba un valor para el campo Nombre , por ejemplo PeopleSoftTwoWayFileSP.

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

  6. Escriba la ubicación de la carpeta que creó anteriormente para la propiedad Carpeta de destino y haga clic en Aceptar.

  7. Seleccione la canalización XMLTransmit en la lista de canalizaciones disponibles en la lista desplegable Enviar canalización y haga clic en Aceptar.

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

Crear un puerto de recepción de archivos

  1. En la consola de administración de BizTalk Server, expanda 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 Nuevopuerto 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 PeopleSoftTwoWayFileRP y haga clic en Aceptar.

Crear una ubicación de recepción de archivos

  1. Cree la carpeta que la ubicación de recepción de archivos supervisará, por ejemplo, C:\Files\In.

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

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

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

  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 Canalización de recepció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.

Modificar la propiedad del espacio de nombres de destino del esquema del adaptador

  1. Inicie Visual Studio y abra TwoWaySend.sln. Haga clic en Archivo, Abrir, Proyecto o Solución para mostrar el cuadro de diálogo Abrir proyecto .

  2. Vaya al archivo TwoWaySend.sln, haga clic para seleccionar este archivo y haga clic en Abrir para abrir la solución que contiene el proyecto de ejemplo.

  3. Haga clic en el menú Ver y seleccione Explorador de soluciones para mostrar el Explorador de soluciones.

  4. Haga doble clic en el archivo LOCATIONService_1.xsd en el Explorador de soluciones para abrirlo.

  5. Haga clic con el botón derecho en el nodo Esquema de LOCATIONService_1.xsd y seleccione la opción de menú Propiedades para mostrar las propiedades del esquema.

  6. Edite la propiedad Espacio de nombres de destino para usar los valores adecuados para el nombre del adaptador, por ejemplo, la propiedad Espacio de nombres de destino debe leer de la siguiente manera:

    http://schemas.microsoft.com/[PeopleSoft://CI/LOCATION]

    Donde PeopleSoft es el nombre del adaptador de PeopleSoft tal y como se ve en la consola de administración de BizTalk Server.

    Importante

    Si el valor configurado para el espacio de nombres de destino no coincide con el espacio de nombres especificado en la instancia de documento de entrada, se producirá un error de enrutamiento cuando BizTalk Server procese la instancia del documento de entrada.

Generar una instancia de documento desde el esquema de adaptador

  1. Haga doble clic en LOCATIONService_1.xsd en Explorador de soluciones para abrir el archivo en el Editor de esquemas.

  2. Haga clic con el botón derecho en el nodo Esquema> en el< Editor de esquemas y haga clic en Propiedades para mostrar las propiedades del nodo.

  3. Seleccione Obtener en la lista de nodos disponibles en el cuadro desplegable Referencia raíz . Esto se debe hacer para que cuando genere una instancia de documento de ejemplo, se generará a partir del nodo Obtener del esquema.

  4. Haga clic con el botón derecho en LOCATIONService_1.xsd en Explorador de soluciones y haga clic en Propiedades para mostrar las propiedades en el ventana Propiedades.

  5. En el ventana Propiedades, haga clic para seleccionar la opción Nombre de archivo de instancia de salida.

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

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

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

  9. Haga clic con el botón derecho en el nodo Esquema> en el< Editor de esquemas y haga clic en Propiedades para mostrar las propiedades del nodo.

  10. Seleccione (Valor predeterminado) en la lista de nodos disponibles en el cuadro desplegable Referencia raíz .

Modificar la instancia de documento generada

  1. Abra la instancia de documento generada en un editor de texto como el Bloc de notas y edite el contenido de la instancia de documento para asegurarse de que los datos de estos campos devolverán un registro existente:

    <ns0:Get xmlns:ns0="http://schemas.microsoft.com/[PeopleSoft://CI/LOCATION]">  
<ns0:SETID>SHARE</ns0:SETID>  
<ns0:LOCATION>WFKLOC</ns0:LOCATION>  
<ns0:getHistory>true</ns0:getHistory>  
</ns0:Get>

    Nota

    En el ejemplo anterior, PeopleSoft es un marcador de posición para el nombre real del adaptador tal como se ve en la Consola de administración de BizTalk. SHARE y WFKLOC son marcadores de posición para los valores usados para identificar un registro determinado en el sistema PeopleSoft.

  2. Guarde la instancia de documento modificada.

Generar e implementar el proyecto

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

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

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

Enlazar y dar de alta la orquestación

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

  2. 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 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 PeopleSoftTwoWayFileRP
    PeopleSoftTwoWaySend678 PeopleSoftTwoWaySP
    ResponsePort PeopleSoftTwoWayFileSP

  6. Haga clic en Aceptar.

Iniciar la orquestación

  • En la consola de administración de BizTalk Server, haga clic con el botón derecho en la orquestación y haga clic en Iniciar para inscribirse e iniciar la orquestación.

Soltar una instancia de documento en la carpeta supervisada por la ubicación del archivo de recepción

  • Copie la instancia de documento que creó anteriormente en la carpeta que la ubicación de recepción de archivos está configurada para supervisar.

Comprobar que el adaptador de BizTalk para PeopleSoft Enterprise procesó la instancia de documento

  • Abra la carpeta a la que el puerto de envío de archivos debe enviar elementos y compruebe que se generó un documento de salida. Este archivo debe contener los resultados de la consulta que ha procesado el adaptador de BizTalk para PeopleSoft Enterprise.

    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 para que el motor de mensajería de BizTalk active una instancia de la orquestación y envíe el mensaje a ésta.

  3. La instancia de orquestación publica el mensaje en el cuadro de mensajes.

  4. El puerto de envío de petición-respuesta 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 PeopleSoft.

  5. El puerto de envío entrega el mensaje al adaptador de BizTalk para PeopleSoft Enterprise.

  6. El adaptador de BizTalk para PeopleSoft Enterprise ejecuta una instrucción Get en el sistema PeopleSoft usando los parámetros definidos en el archivo de entrada.

  7. El adaptador de BizTalk para PeopleSoft Enterprise devuelve los resultados de la instrucción Get como mensaje de respuesta para el puerto de petición-respuesta de la orquestación.

  8. La orquestación publica el conjunto de resultados en el cuadro de mensajes.

  9. El puerto de envío de archivos se suscribe a este mensaje, por lo que BizTalk envía el mensaje al adaptador de archivo.

  10. El adaptador de archivos escribe un mensaje que contiene el conjunto de resultados en la carpeta de salida designada.

Consulte también

Tutoriales: Uso del adaptador de BizTalk para PeopleSoft Enterprise