Módulo 4: Servicio Web SOAP¶

Introducción¶

Módulo 4 de la Introducción a Harmony Cloud Studio el curso de capacitación demuestra cómo consultar un servicio web SOAP y escribir la respuesta en un servidor SFTP como un archivo de texto.

Requisitos Previos¶

Esta página supone que ha completado el Módulo 1: Base de datos a texto, donde configuró una conexión al servidor SFTP de entrenamiento de Jitterbit.

Resumen¶

En este módulo, realizará una llamada SOAP utilizando un WSDL proporcionado para consultar un servicio meteorológico basado en el código postal y luego escribirá esos datos en el servidor SFTP de entrenamiento como un archivo de texto.

La operación completa se verá así:

Esta operación utiliza estas asignaciones de transformación de solicitud y respuesta:

1. Configurar una Conexión y Actividad SOAP¶

Para este módulo, continúa trabajando dentro del mismo proyecto que en el Módulo 1 y crea una nueva conexión y actividad SOAP:

1. Dentro del mismo proyecto que el Módulo 1, cree un nuevo flujo de trabajo y asígnele el nombre "Módulo 4".

2. Desde la pestaña Conectores y extremos del proyecto de la paleta de componentes bajo el filtro Conectores, haga clic en el conector SOAP:

   

   Consejo

   SOAP, o Protocolo simple de acceso a objetos, es un protocolo basado en estándares bien establecido para acceder a servicios web.

3. Configure la conexión SOAP:

   • Nombre del Extremo: "Código postal – SOAP"
   • Subir URL: Pegue la URL en este archivo de lenguaje de definición de servicios web (WSDL): "https://trainingoptrial112860.jitterbit.net/TrainingOpsCloud/v1/SOAP_Service/?WSDL". Haga clic en Subir.
   • Puerto: Seleccione "ZipCodeSoap".
   • URL del servicio web: Esto se completa automáticamente a partir del WSDL cargado.
   • Seleccione métodos: Seleccione "Código postal". Haga clic en Guardar cambios.

4. Desde la pestaña Conectores y extremos del proyecto de la paleta de componentes bajo el filtro Extremos, haga clic en la conexión "Código postal – SOAP" que acaba de crear. Esto muestra el tipo de actividad SOAP para el método que seleccionó al configurar la conexión SOAP:

   

5. Arrastre el tipo de actividad SOAP a una área de inserción de componentes en el tela de diseño para crear una instancia de una actividad SOAP en una nueva operación.

6. Cambie el nombre de la operación "Código postal – SOAP". No es necesario abrir la actividad SOAP para configurarla porque ya está configurada automáticamente con toda la información requerida.

La conexión SOAP debería tener una configuración similar a esta:

2. Configurar una Actividad FTP¶

En este paso, utiliza la misma conexión al servidor SFTP que en el Módulo 1, pero configura una actividad de escritura FTP separada:

1. Desde la pestaña Conectores y extremos del proyecto de la paleta de componentes bajo el filtro Extremos, haga clic en la conexión "SFTP" que creó en el Módulo 1 para mostrar los tipos de actividad de la conexión:

   

2. Arrastre una actividad de escritura FTP a una área de inserción de componentes a la derecha de la actividad SOAP dentro de la operación en el tela de diseño.

3. Haga doble clic en la actividad de escritura FTP dentro de la operación para abrir su configuración.

4. Configure la Actividad de escritura FTP:

   • Nombre: "Datos del código postal"
   • Nombre(s) de archivo: "zipCode.txt"
   • Usar cambio de nombre de FTP: Borre esta selección. Haga clic en Siguiente**.
   • Esquema de datos: Como no proporcionó un esquema, no hay nada que revisar en la segunda pantalla. Haga clic en Terminado.

3. Configurar una Transformación de Solicitud¶

A continuación, crea una transformación para la solicitud de servicio web SOAP:

1. En el tela de diseño, pase el cursor sobre el área a la izquierda de la actividad SOAP hasta que aparezca una área de inserción de componentes.
2. Haga clic en la área de inserción y seleccione Nueva Transformación. Se abrirá una nueva transformación para que la configures:
   • Nombre de la Transformación: "Código postal – Solicitud SOAP "
   • Fuente: Deje el esquema de origen sin definir (a la izquierda).
   • Objetivo: Dentro del esquema de destino (a la derecha), coloque el cursor sobre el ZipCode campo y haga clic en el icono de agregar . En el menú, haga clic en Agregar valor personalizado. Luego ingrese un código postal en el área de texto. Haga clic en Volver al Flujo de Trabajo.

La transformación de la solicitud debería ser similar a esta:

4. Configurar una Transformación de Respuesta¶

A continuación, crea una transformación para escribir la respuesta del servicio web SOAP en el destino FTP:

1. En el tela de diseño, pase el cursor sobre el área entre la actividad SOAP y la actividad de escritura FTP hasta que aparezca una área de inserción de componentes.
2. Haga clic en la área de inserción y seleccione Nueva Transformación. Se abrirá una nueva transformación para que la configures:
   • Nombre de la Transformación: "Código postal – Respuesta SOAP "
   • Fuente: El esquema fuente ya está proporcionado (a la izquierda).
   • Objetivo: Debe definir el esquema de destino (a la derecha). Haga clic en Definir esquema y luego seleccione Crear plano. Configure el esquema plano personalizado:
     • Nombre del esquema: "Datos del código postal"
     • Opciones: Cambie el Delimitador de una coma a una pestaña ingresando "\t".
     • Agregar campo: Utilice este botón para agregar estos campos: zip, tipo, estado, ciudad primaria, condado, zona horaria, códigos de área, país y población. Una vez agregados los campos, haga clic en Guardar cambios.
3. Arrastra el zipCodeResponse nodo fuente al __flat__ nodo de destino y seleccione Asignación automática. Luego haga clic en Volver al Flujo de Trabajo.

La configuración del esquema plano personalizado debería ser similar a esta:

La transformación de la solicitud debería ser similar a esta:

5. Desplegar y Ejecutar la Operación¶

Finalmente, con todos los pasos de la operación configurados, desplegar y ejecuta la operación:

1. En la parte superior derecha de la operación, haga clic en el icono del menú de acciones y en el menú haga clic en Desplegar y ejecutar. El estado de la operación se muestra en la parte inferior izquierda de la operación.
2. Una vez que la operación sea exitosa, inicie sesión en el servidor SFTP de entrenamiento de Jitterbit y vea el archivo que generó.