Asistente de conversión de XML a base de datos en Jitterbit Design Studio

Cree una transformación de XML a estándar de base de datos con el asistente de conexión Jitterbit

Jitterbit Connect^TM ofrece una enrutar rápida y sencilla para la transformación de datos. Esto es posible gracias a una herramienta de integración basada en asistente integrada directamente en Jitterbit. El asistente crea para el usuario todas las operaciones y componentes complejos y detallados de un proyecto de Transformación. Al seguir los pasos del asistente, los usuarios pueden crear un proyecto de integración sin necesidad de codificación.

Esta sección de ayuda cubre la creación de XML en la base de datos. Las convenciones de pantalla en este documento son: Origen está a la izquierda, Destino está a la derecha.

Crear una transformación de XML a estándar de base de datos

• Inicia sesión en tu Jitterbit.

• Para utilizar el asistente de conexión Jitterbit, desde el menú principal, haga clic en Ayuda > Introducción. La pestaña Introducción aparece en el panel derecho de la pantalla.

• Ahora haga clic en el botón etiquetado Iniciar el asistente Connect^TM; O

• Haga clic en el archivo en la parte superior de la pantalla para visualizar el menú Jitterbit Connect.

  

• Inicie el asistente haciendo clic en el botón XML a base de datos en la columna Estándar del menú Asistente de Jitterbit Connect, que muestra la pantalla Selección de origen de la base de datos; O

• Haga clic con el botón derecho en la subrama de Jitterbit Connect deseada en el panel Diseño y seleccione Nuevo XML a base de datos.

• Comience a crear su proyecto con el asistente.

  Nota

  Si no ha iniciado sesión al comienzo del proyecto, se le solicitará que lo haga cuando haga clic en XML a base de datos.

  

• Complete los campos de la siguiente manera:

  Campo	Descripción
  Servidor Jitterbit	Seleccione el nombre del servidor Jitterbit en el menú desplegable.
  Usuario	Ingresa tu nombre de usuario.
  Contraseña	Ingresa tu contraseña.
  Casilla de verificación Recordar contraseña	Marque esta casilla si desea que el sistema recuerde su contraseña en el futuro.
  enlace avanzado	Haga clic en el triángulo izquierdo para revelar las opciones avanzadas del enlace : Uso de HTTPS al comunicarse con el servidor. Selección de un puerto. Para obtener más detalles, haga clic en el botón Ayuda en la esquina inferior derecha de este diálogo.

• Después de haber completado los campos:

  Control	Descripción
  Iniciar sesión	Haga clic en este botón para iniciar sesión en el servidor Jitterbit y mostrar la pantalla Fuente.
  Cancelar	Haga clic en este botón para cerrar el asistente sin guardar sus entradas.
  Signo de interrogación	Haga clic en el signo de interrogación para mostrar ayuda para este diálogo.

Crear estructura XML de origen

• Seleccione uno de los botones de opción:

  • Seleccionar una estructura XML: revela cualquier esquema XML existente (extensión .xsd o .dtd). Luego, resalte su selección.
  • Cargar un archivo de estructura XML: le permite navegar hasta otro DTD o esquema y cargarlo.

• En este ejemplo, elegimos el botón de opción Seleccionar una estructura XML y resaltamos PurchaseOrder.dtd.

  Control	Descripción
  Siguiente	Haga clic en este botón para mostrar la pantalla Seleccionar una raíz.
  Cancelar	Haga clic en este botón para cerrar el asistente sin guardar sus entradas.

• Haga clic en el botón Atrás para volver a la pantalla anterior.

Crear elemento raíz de origen

• Seleccione uno de los botones de opción:

  • Seleccionar un nodo raíz de la lista: revela los nodos de datos y puede elegir uno como raíz.
  • Buscar la raíz en un documento XML de muestra: le permite navegar a otro documento XML para determinar su nodo raíz.

• En este ejemplo, elegimos el botón de opción Seleccionar un nodo raíz de la lista y resaltamos company_name.

  Control	Descripción
  Siguiente	Haga clic en este botón para mostrar la pantalla Opciones de fuente.
  Cancelar	Haga clic en este botón para cerrar el asistente sin guardar sus entradas.

• Haga clic en el botón Atrás para volver a la pantalla anterior.

  

• La casilla de verificación Validar instancias XML con el XSD o DTD seleccionado está marcada de forma predeterminada. En este ejemplo, dejamos la casilla de verificación marcada.

  Control	Descripción
  Siguiente	Haga clic en este botón para mostrar la pantalla Seleccionar una fuente de archivo.
  Cancelar	Haga clic en este botón para cerrar el asistente sin guardar sus entradas.

• Haga clic en el botón Atrás para volver a la pantalla anterior.

Crear fuente de archivo

• Para editar una fuente de archivo existente, seleccione del menú desplegable (por ejemplo, Fuente XML, Fuente de texto, Texto complejo) y haga clic en Editar. La pantalla se expande para mostrar el nombre y el tipo de fuente XML y los parámetros de conexión.

• Para crear una nueva fuente de archivo, haga clic en el botón Crear nuevo y complete los campos.

• En este ejemplo, elegimos una fuente XML del menú desplegable y hacemos clic en Editar para actualizar los parámetros de conexión de la fuente.

  Nota

  El tipo de fuente de archivo seleccionado determinará los parámetros de conexión que se deben ingresar. Para obtener más detalles, consulte Habilitación de fuentes de archivos locales.

  

• Campos de origen XML:

  Campo	Descripción
  Nombre	Este campo se completa automáticamente con un nombre asignado por el sistema. Este es un campo editable en el que puede elegir ingresar cualquier nombre.
  Tipo	Utilice el menú desplegable para seleccionar su tipo. En este ejemplo, hemos seleccionado File3-are.

• Complete los campos de parámetros de conexión de la siguiente manera.

  Parámetro	Descripción
  Ruta	Ingrese la ruta donde residen los archivos "Obtener".
  Iniciar sesión	Ingrese su inicio de sesión y haga clic en el botón Contraseña. Aparecerá un cuadro de diálogo para ingresar su contraseña.
  Obtener archivos	Ingrese el nombre del archivo de origen de datos. Puede incluir comodines para obtener varios archivos.
  Opciones de filtro	Haga clic en este botón para abrir un diálogo que le permita ignorar mayúsculas y minúsculas o utilizar una expresión regular.
  enlace de opciones	Haga clic en este enlace para realizar mejoras en la operación, es decir, eliminar o cambiar el nombre de un archivo después del procesamiento.

• Después de completar tus entradas:

  Control	Descripción
  Probar conexión	Antes de hacer clic en Siguiente, haga clic en este botón para asegurarse de que todas las conexiones funcionan. Aparecerá un cuadro de diálogo que confirma que la conexión se realizó correctamente. Si la prueba de conexión no es exitosa, vuelva atrás y verifique los parámetros y corríjalos si es necesario. Haga clic en Aceptar para regresar a la pantalla Fuente.
  Siguiente	Haga clic en este botón para mostrar la pantalla de selección de destino de la base de datos.
  Cancelar	Haga clic en este botón para cerrar el asistente sin guardar sus entradas.

• Haga clic en el botón Atrás para volver a la pantalla anterior.

Crear selección de objetivos de base de datos

• Para editar un destino de base de datos existente, seleccione una opción del menú desplegable y haga clic en Editar. La pantalla se expande para mostrar el nombre y el tipo de destino de base de datos, y los parámetros de conexión.

• Para crear un nuevo destino de base de datos, haga clic en el botón Crear nuevo y complete los campos.

• En este ejemplo, elegimos PostgreSQL del menú desplegable y hacemos clic en Editar para actualizar los parámetros de conexión.

  Nota

  El tipo de destino de base de datos seleccionado determinará los parámetros de conexión que se deben ingresar.

  

• Campos de PostgreSQL:

  Campo	Descripción
  Nombre	Este campo se completa automáticamente con un nombre asignado por el sistema. Este es un campo editable en el que puede elegir ingresar cualquier nombre.
  Tipo	Utilice el menú desplegable para seleccionar su tipo. En este ejemplo, hemos seleccionado Base de datos.

• Complete los campos de parámetros de conexión de la siguiente manera.

  Parámetro	Descripción
  Controlador	Haga clic en el botón Seleccionar y resalte el nombre del controlador donde reside la base de datos.
  Nombre del servidor	Ingrese el nombre del servidor.
  Nombre de la base de datos	Ingrese el nombre de la base de datos.
  Iniciar sesión	Ingrese su nombre de usuario y haga clic en el botón Contraseña. Aparecerá un cuadro de diálogo para ingresar su contraseña.

• Después de completar tus entradas:

  Control	Descripción
  Probar conexión	Antes de hacer clic en Siguiente, haga clic en este botón para asegurarse de que todas las conexiones funcionen. Aparecerá un cuadro de diálogo que confirma que la conexión se realizó correctamente. Si la prueba de conexión no es exitosa, vuelva atrás y verifique los parámetros y corríjalos si es necesario. Haga clic en Aceptar para regresar a la pantalla Fuente.
  Siguiente	Haga clic en este botón para mostrar la pantalla de selección de tabla de destino.
  Cancelar	Haga clic en este botón para cerrar el asistente sin guardar sus entradas.

• Haga clic en el botón Atrás para volver a la pantalla anterior.

Crear selección de tabla de destino

• Haga clic en el botón Descargar lista de tablas para descargar la lista de tablas disponibles.

• Opcional:

  • Puede introducir una cadena de búsqueda como filtro. Marque las casillas de verificación Tabla o Vista para limitar los objetos a seleccionar.

  • Puede seleccionar la casilla de verificación para incluir el esquema/propietario.

  Nota

  Si no ha iniciado sesión al comienzo del proyecto, se le solicitará que lo haga cuando haga clic en el botón Descargar lista de tablas.

  

• Complete los campos de la siguiente manera:

  Campo	Descripción
  Servidor Jitterbit	Seleccione el nombre del servidor Jitterbit en el menú desplegable.
  Usuario	Ingresa tu nombre de usuario.
  Contraseña	Ingresa tu contraseña.
  Casilla de verificación Recordar contraseña	Marque esta casilla si desea que el sistema recuerde su contraseña en el futuro.
  enlace avanzado	Haga clic en el triángulo izquierdo para revelar las opciones avanzadas del enlace : Uso de HTTPS al comunicarse con el servidor. Selección de un puerto. Para obtener más detalles, haga clic en el botón Ayuda en la esquina inferior derecha de este diálogo.

• Después de haber completado los campos:

  Control	Descripción
  Iniciar sesión	Haga clic en este botón para iniciar sesión en el servidor Jitterbit y mostrar la pantalla de selección de tabla.
  Cancelar	Haga clic en este botón para cerrar el asistente sin guardar sus entradas.
  Signo de interrogación	Haga clic en el signo de interrogación para mostrar ayuda para este diálogo.

  

• Una vez que se hayan descargado las tablas, puede copiarlas de la columna Tablas disponibles a la columna Tablas seleccionadas.

• Resalte las tablas que desea copiar en la columna Tablas disponibles y haga clic en la flecha hacia la derecha.

• Luego, las selecciones se copian en la columna Tablas seleccionadas, como en el siguiente ejemplo.

  

• Después de completar tus tablas:

  Control	Descripción
  Siguiente	Haga clic en este botón para mostrar la pantalla Relaciones jerárquicas de origen.
  Cancelar	Haga clic en este botón para cerrar el asistente sin guardar sus entradas.

• Haga clic en el botón Atrás para volver a la pantalla anterior.

Crear relaciones jerárquicas

• Haga clic en el menú desplegable Seleccionar tabla principal y seleccione una opción. En este ejemplo, hemos seleccionado OrderHeader de la lista.

• Haga clic en el menú desplegable Seleccionar tabla secundaria y seleccione una opción. En este ejemplo, hemos seleccionado OrderDetail de la lista.

• Luego, haga clic en el botón Unir tablas. Aparece el cuadro de diálogo Propiedades de unión.

  

• En la sección Claves de enlace, arrastre y suelte una columna principal (OrderHeader en este ejemplo) en una columna secundaria (OrderDetail en este ejemplo) para enlace. Como alternativa, puede seleccionar una columna en cada tabla para activar el botón Enlazar y luego hacer clic en este botón para enlace las columnas.

• Puede seleccionar un enlace entre dos columnas para activar el botón Eliminar enlace y luego hacer clic en ese botón para eliminar el enlace.

• Haga clic en el botón Orden de visualización de columnas para seleccionar Base de datos (predeterminado) o Alfabético.

• Después de completar la unión de padre e hijo, seleccione un botón de opción para identificar el tipo de unión. El valor predeterminado es 1 a N. En este ejemplo, hemos dejado el valor predeterminado en 1 a N.

  

• Después de completar tus tablas:

  Control	Descripción
  Aceptar	Haga clic en este botón para regresar a la pantalla Relaciones jerárquicas de origen, que muestra el árbol de tablas con las relaciones definidas actualmente.
  Cancelar	Haga clic en este botón para regresar a la pantalla Relaciones jerárquicas de origen sin guardar sus entradas.

• Haga clic en el botón Atrás para volver a la pantalla anterior.

  

  Control	Descripción
  Siguiente	Haga clic en este botón para mostrar la pantalla Cláusula Where de SQL.
  Cancelar	Haga clic en este botón para cerrar el asistente sin guardar sus entradas.

• Haga clic en el botón Atrás para volver a la pantalla anterior.

  

• En este ejemplo, no utilizamos condiciones de filtro.

  Control	Descripción
  Siguiente	Haga clic en este botón para mostrar la pantalla de Objetivo.
  Cancelar	Haga clic en este botón para cerrar el asistente sin guardar sus entradas.

• Haga clic en el botón Atrás para volver a la pantalla anterior.

Revisar el resumen de la base de datos

Este paso le permite revisar los elementos de su proyecto antes de que Jitterbit cree automáticamente todas las definiciones del proyecto, incluidas operaciones, transformaciones y llamadas a servicios web.

Tómese unos minutos para explorar todos los elementos del proyecto.

• Si necesita realizar ajustes en el proyecto, haga clic en el botón Atrás para regresar a la pantalla anterior y realizar los cambios necesarios.

• Después de revisar el proyecto, haga clic en Finalizar para visualizar la pestaña Transformaciones. Se completará el panel Diseño.

Revisar el mapeo

• Cuando hace clic en Finalizar en la pantalla Resumen, se abre la pestaña Transformaciones en el espacio de trabajo. (También puede abrirla en cualquier momento seleccionando el nombre de su proyecto en el panel Diseño y haciendo doble clic). El mensaje Asignaciones también se muestra sobre la pestaña.

  

• Si ha dejado marcada la casilla de verificación Usar Automapper, es posible que la mayoría o todos los campos ya estén asignados. La asignación válida se indica mediante líneas verdes entre los elementos de las columnas Origen y Destino y, además, mediante la presencia de un cuadrado azul junto al nombre de cada elemento asignado válidamente.

• Una línea roja indica una asignación no válida.

• Una línea amarilla indica que Jitterbit no está seguro de si la asignación es válida para todas las posibilidades de datos, pero intentará la transformación con esta asignación.

• Puede completar la asignación en la pestaña Transformaciones arrastrando y soltando desde Origen a la izquierda hasta Destino a la derecha. Al hacerlo, el elemento Destino adoptará el mismo nombre que el elemento Origen y aparecerá un cuadrado azul a la izquierda tanto del elemento Origen como del elemento Destino. Consulte Transformaciones para más detalles transformación.

• Para guardar su transformación, haga clic en la flecha hacia abajo en la cinta Estado y seleccione Guardar.

• Para salir de esta pantalla, haga clic en la X en el extremo derecho de la pestaña.

La pestaña Asistentes de SFDC también se abre al hacer clic en Finalizar.

• Haga clic en la pestaña Asistentes de SFDC para visualizar la pantalla Crear cuenta. Aquí puede cambiar configuraciones como Fragmentación y Truncar campos. La última configuración truncará los campos según sea necesario si el campo de destino es más pequeño que el campo de origen. Desde la pestaña Asistentes de SFDC, también puede ejecutar o probar la operación.

• Para ver el resumen gráfico de todo el proyecto, haga clic en la pestaña Operaciones o haga clic derecho en el nombre del proyecto en el panel Diseño.

  

Desplegar el proyecto

• En el panel Diseño, en Transformaciones, haga clic derecho en el proyecto recién creado y luego haga clic izquierdo en Desplegar en el menú desplegable resultante; o

• Haga clic con el botón derecho en Operaciones en la parte superior del panel Diseño y luego haga clic con el botón izquierdo en Desplegar.

• El proceso de despliegue comienza a enviar los datos al servidor y aparece un mensaje de progreso.

• Para cancelar el proceso de despliegue, haga clic en el botón Cancelar, que lo regresará a la pantalla anterior.

Con esto finaliza el proceso de conversión de XML a base de datos. Si desea exportar este proyecto a Jitterpak, haga clic aquí.