Módulo 3: XML a Base de Datos¶

Introducción¶

Módulo 3 en la Introducción a Harmony Cloud Studio El curso de capacitación demuestra la lectura de datos XML de un servidor SFTP y su conversión a una base de datos PostgreSQL.

Requisitos Previos¶

Esta página asume que ha completado Módulo 1 - Base de datos a texto, donde configuró las conexiones a la base de datos PostgreSQL de entrenamiento de Jitterbit y al servidor SFTP.

Resumen¶

En este módulo, se conectará al servidor SFTP de capacitación para extraer registros del customer.xml archivo y agréguelos al customer tabla en la base de datos PostgreSQL.

La operación completa se verá así:

Esta operación utiliza este mapeo de transformación:

1. Descarga un Esquema XML¶

Primero, descargue un archivo XML para proporcionarlo como esquema en un paso posterior:

1. Inicie sesión en el servidor SFTP de entrenamiento de Jitterbit.
2. En el DataSets > Customer directorio, descarga el customer.xml archivo.

2. Configurar una Actividad FTP¶

Para este módulo, continúa trabajando dentro del mismo proyecto y reutiliza la misma conexión de servidor SFTP que en el Módulo 1, pero configura una actividad de lectura FTP separada para extraer los datos XML del servidor:

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

2. Desde la pestaña Conexiones 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:

   

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

4. Cambie el nombre de la operación a "XML a DB".

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

6. Configure la Actividad de lectura de FTP:

   • Nombre: "XML SFTP"
   • Proporcionar esquema de respuesta: Seleccione Sí, proporcionar nuevo esquema y haga clic en Cargar archivo para buscar y cargar el customer.xml que descargó del servidor SFTP de entrenamiento.
   • Ruta: Proporcione la ruta al customer.xml archivo en el servidor SFTP de entrenamiento: "/DataSets/Customer"
   • Obtener archivos: "*.xml". Haga clic en Siguiente**.
   • Esquema de datos: Revise el esquema de datos y haga clic en Terminado para volver al tela de diseño.

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

3. Configurar una Actividad de Base de Datos¶

En este paso, utiliza la misma conexión a la base de datos PostgreSQL que en el Módulo 1, pero configura una actividad Upsert separada:

1. Desde la pestaña Conexiones de la paleta de componentes bajo el filtro Extremos, haga clic en la conexión "Base de datos de Postgres" que creó en el Módulo 1 para mostrar los tipos de actividad de la conexión:

   

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

3. Haga doble clic en la actividad Actualizar base de datos dentro de la operación para abrir su configuración.

4. Configure la Actividad Upsert de base de datos:

   • Nombre: "Actualizar a Postgres DB"
   • Proporcione la referencia de los nombres de las tablas: Actualice las tablas y seleccione la tabla de clientes. Haga clic en Siguiente**.
   • Seleccione Actualizar claves: Borre la id (Clave) y seleccione el campo company campo. Haga clic en Siguiente**.
   • Esquema de datos: Revise el esquema de datos y haga clic en Terminado para volver al tela de diseño.

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

4. Configurar una Transformación¶

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

1. En el tela de diseño, desplace el cursor sobre el área entre la actividad Lectura de FTP y la actividad Upsert de base de datos 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 Transformación: "XML a DB"
   • Fuente: El esquema de origen ya se proporciona (a la izquierda).
   • Objetivo: El esquema de destino ya se proporciona (a la derecha).

3. Arrastre el customer nodo fuente al customer nodo de destino y seleccione Automapa.

4. En la parte superior del encabezado de transformación, haga clic en el botón gris Vista previa para comenzar el proceso de vista previa para probar y validar las asignaciones. Haga clic en Siguiente para desplegar los componentes enumerados. En la siguiente pantalla, seleccione Cargar nuevo archivo para probar y proporcione el customer.xml archivo que descargó anteriormente. Haga clic en Terminado.

5. La pantalla de vista previa muestra los datos del origen y se asignan al destino. Haga clic en las flechas derecha e izquierda para recorrer los datos importados.

6. Después de revisar los datos, haga clic en Volver al Flujo de Trabajo. Al hacer clic en este botón, se guarda el trabajo realizado en la transformación.

La vista previa de la transformación debería ser similar a esto:

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 desde 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 la base de datos PostgreSQL de Jitterbit y ver los registros adicionales en la tabla de clientes.