Módulo 5: Servicio Web RESTful¶

Introducción¶

Módulo 5 de la Introducción a Harmony Cloud Studio el curso de capacitación demuestra cómo consultar un servicio web REST 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. También requiere completar el Módulo 4 - Servicio web SOAP, ya que reutiliza varios componentes del proyecto de este módulo.

Resumen¶

En este módulo, consultar un servicio web RESTful sobre el clima según 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 este mapeo de transformación:

1. Configurar una Conexión HTTP¶

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

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

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

   

3. Configure la conexión HTTP:

   • Nombre del Extremo: "Código postal – REST"
   • URL base: Pegue la URL base de este servicio: "https://trainingoptrial112860.jitterbit.net/TrainingOpsCloud/v1/REST_Service/".

4. Haga clic en Guardar cambios.

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

2. Configurar una Actividad HTTP¶

A continuación, configure una actividad asociada a la conexión HTTP para obtener los datos del servicio web:

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 "Código postal - REST" que acaba de crear:

   

2. Arrastre un tipo de actividad HTTP GET a la área de inserción de componentes en el tela de diseño para crear una instancia de una actividad HTTP GET en una nueva operación.

3. Cambie el nombre de la operación a "Código postal – REST".

4. Haga doble clic en la actividad HTTP GET dentro de la operación para abrir su configuración.

5. Configure la actividad HTTP:

   • Nombre: "Detalles del código postal"

   • Verbo HTTP: "OBTENER"

   • Ruta: "zip"

   • Parámetros de solicitud: Haga clic en Agregar para establecer un parámetro de consultar llamado "código" con un valor de su código postal (por ejemplo, "94501"). Haga clic en Siguiente**.

   • Proporcionar esquema de solicitud: Como no es necesario proporcionar un esquema de solicitud (una solicitud GET estándar no contiene un cuerpo), haga clic en Siguiente nuevamente.

   • Proporcionar esquema de respuesta: Seleccione Sí, proporcionar nuevo esquema, proporcione un nombre de esquema de "Detalle del código postal" y luego pegue esta estructura de respuesta JSON esperada en el cuadro de texto inferior:

     {
       "zip": 12345,
       "type": "",
       "primaryCity": "",
       "state": "",
       "county": "",
       "timeZone": "",
       "areaCodes": "",
       "latitude": "",
       "longitude": "",
       "country": "",
       "population": 123456
     }
     

     Haga clic en Siguiente.

   • Esquema de datos: Revise el esquema de datos y haga clic en Terminado para regresar al tela de diseño.

La pantalla final de configuración de la actividad debería verse similar a esta:

3. Configurar una Actividad FTP¶

En este paso, reutilizará la actividad de escritura FTP que creó en el Módulo 4:

1. Desde la pestaña Componentes del panel del proyecto, expanda Extremos > Extremos FTP para ubicar la conexión "SFTP" y la actividad de escritura de "Datos de código postal" que creó como parte del Módulo 4.
2. Arrastre la actividad de escritura "Datos del código postal" a una área de inserción a la derecha de la actividad HTTP dentro de la operación en el tela de diseño para reutilizarla en la operación.

4. Configurar una Transformación¶

A continuación, crea una transformación para transformar los datos del origen HTTP al destino FTP:

1. En el tela de diseño, pase el cursor sobre el área entre la actividad HTTP GET y la actividad FTP Write 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 REST"
   • Fuente: El esquema de origen ya está proporcionado (a la izquierda) porque lo definiste en la actividad GET.
   • Objetivo: Debe definir el esquema de destino (a la derecha). Haga clic en Definir esquema y luego seleccione Usar archivo de muestra. Configure el esquema de archivo de muestra:
     • Proporcionar archivo de esquema: Seleccione Usar esquema guardado.
     • Esquemas guardados: Utilice el menú desplegable para seleccionar el esquema de "Datos de código postal" delimitado por tabulaciones que definió como parte del Módulo 4. Haga clic en Finalizar.
3. En la parte superior derecha del esquema de destino, haga clic en Asignar automáticamente coincidencias exactas. Luego haga clic en Volver al Flujo de Trabajo.

El mapeo de transformación debería verse similar a este:

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