Asistente de XML a Base de Datos¶

Cree una Transformación Estándar de XML a Base de Datos con el Asistente Jitterbit Connect¶

Jitterbit Connect^TM proporciona una enrutar rápida y sencilla hacia la transformación de datos. Esto es posible gracias a una herramienta de integración basada en un 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 el 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 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 Estándar de XML a Base de Datos¶

• Inicie sesión en su Jitterbit.

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

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

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

  

• Inicie el asistente haciendo clic en el botón XML a base de datos en la columna Estándar en el menú del asistente Jitterbit Connect, que muestra la pantalla de selección de fuente de 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 en la base de datos.

• Comience a crear su proyecto con el asistente.

  Nota

  Si no ha iniciado sesión al comienzo del proyecto, se le pedirá 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	Ingrese su nombre de usuario**.
  Contraseña	Ingresa tu contraseña**.
  Casilla 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 opciones de enlace avanzadas: Uso de HTTPS al comunicarse con el servidor. Selección de un puerto. Para detalles, haga clic en el botón Ayuda en la esquina inferior derecha de este diálogo.

• Después de haber completado los campos:

  Controlar	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 radio:

  • Seleccione 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 y cargar otra DTD o esquema.

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

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

• Haga clic en el botón Volver para volver a la pantalla anterior.

Crear Elemento Raíz de Origen¶

• Seleccione uno de los botones de radio:

  • Seleccione un nodo raíz de la lista - revela nodos de datos y puede elegir uno como raíz.
  • Buscar la raíz de 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 nombre_compañía.

  Controlar	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 Volver para volver a la pantalla anterior.

  

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

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

• Haga clic en el botón Volver para volver a la pantalla anterior.

Crear Fuente de Archivo¶

• Para editar una fuente de archivo existente, seleccione en el 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 hicimos 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 a ingresar. Para obtener más información, 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 donde 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 nombre de usuario y haga clic en el botón Contraseña. Aparece un cuadro de diálogo para ingresar su contraseña.
  Obtener archivos	Introduzca 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 permitirá 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:

  Controlar	Descripción
  Probar conexión	Antes de hacer clic en Siguiente, haga clic en este botón para asegurarse de que todas sus conexiones funcionen. Aparece un cuadro de diálogo que confirma que la conexión fue exitosa. Si la prueba de conexión no tiene éxito, regrese y verifique sus parámetros y corríjalos si es necesario. Haga clic en Aceptar para volver 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 Volver para volver a la pantalla anterior.

Crear Selección de Destino de Base de Datos¶

• Para editar un destino de base de datos existente, seleccione en el menú desplegable y haga clic en Editar. La pantalla se expande para mostrar el nombre y el tipo de destino de la 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 en el menú desplegable y hicimos 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 a ingresar.

  

• Campos PostgreSQL:

  Campo	Descripción
  Nombre	Este campo se completa automáticamente con un nombre asignado por el sistema. Este es un campo editable donde 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
  Conductor	Haga clic en el botón Seleccionar y resalte el nombre del controlador donde reside la base de datos.
  Nombre del servidor	Ingrese el servidor nombre.
  Nombre de la base de datos	Ingrese la base de datos nombre.
  Iniciar sesión	Ingrese su nombre de usuario y Haga clic en el botón Contraseña. Aparece un cuadro de diálogo para ingresar su contraseña.

• Después de completar tus entradas:

  Controlar	Descripción
  Probar conexión	Antes de hacer clic en Siguiente, haga clic en este botón para asegurarse de que todas sus conexiones funcionen. Aparece un cuadro de diálogo que confirma que la conexión fue exitosa. Si la prueba de conexión no tiene éxito, regrese y verifique sus parámetros y corríjalos si es necesario. Haga clic en Aceptar para volver 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 Volver 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 ingresar 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 inicio del proyecto, se le pedirá 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	Ingrese su nombre de usuario.
  Contraseña	Ingrese su contraseña.
  Casilla 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 opciones avanzadas de enlace : Uso de HTTPS al comunicarse con el servidor. Selección de un puerto. < /ul> Para obtener más información, Haga clic en el botón Ayuda en la esquina inferior derecha de este diálogo.

• Después de haber completado los campos:

  Controlar	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 mesa.
  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 descargadas las tablas, puede copiar tablas de la columna Tablas disponibles a la columna Tablas seleccionadas.

• Resalte las tablas que se copiarán en la columna Tablas disponibles y haga clic en la flecha derecha.

• Las selecciones luego se copian en la columna Tablas seleccionadas, como en el siguiente ejemplo.

  

• Después de completar tus tablas:

  Controlar	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 Volver para volver a la pantalla anterior.

Crear relaciones jerárquicas

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

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

• Luego haga clic en el botón Unirse a mesas. Aparece el cuadro de diálogo Propiedades de unión.

  

• En la sección Claves de vínculo, 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 Vincular 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 (valor predeterminado) o Alfabético.

• Después de completar la unión de padres e hijos, 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:

  Controlar	Descripción
  OK	Haga clic en este botón para regresar a la pantalla Relaciones jerárquicas de origen, que muestra su á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 Volver para volver a la pantalla anterior.

  

  Controlar	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 Volver para volver a la pantalla anterior.

  

• En este ejemplo, no utilizamos condiciones de filtro.

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

• Haga clic en el botón Volver 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 de servicios web.

Tómate unos momentos para explorar todos los elementos del proyecto.

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

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

Revisar el Mapeo¶

• Cuando haces clic en Finalizar en la pantalla Resumen, se abre la pestaña Transformaciones en el espacio de trabajo. (También puede abrirlo 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 encima de la pestaña.

  

• Si dejó 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, por la presencia de un cuadrado azul al lado de cada nombre de 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 el mapeo es válido para todas las posibilidades de datos, pero intentará la transformación con este mapeo.

• Puedes completar el mapeo en la pestaña Transformaciones arrastrando y soltando desde Origen a la izquierda hasta Destino a la derecha. Cuando lo haga, el elemento de destino tomará el mismo nombre que el elemento de origen y aparecerá un cuadrado azul a la izquierda tanto del elemento de origen como del elemento de destino. Vea Transformaciones para obtener 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 X en el extremo derecho de la pestaña.

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

• Haga clic en la pestaña Asistentes SFDC para mostrar la pantalla Crear cuenta. Aquí puede cambiar configuraciones como Chunking 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 SFDC, también puede ejecutar o probar la operación.

• Vea 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 con el botón derecho en el proyecto que acaba de crear y luego haga clic con el botón izquierdo en Desplegar en el menú desplegable resultante; o

• Haga clic derecho en Operaciones en la parte superior del panel Diseño y luego haga clic 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.

Esto concluye el proceso de XML a base de datos. Si desea exportar este proyecto tiene un Jitterpak, haga clic aquí.