Asistente de Base de Datos a XML¶

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 ejecuta 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. Las convenciones de pantalla en este documento son Origen a la izquierda y Destino a la derecha.

Crear una Base de Datos para la Transformación Estándar XML¶

• Inicie sesión en Salesforce a través de Jitterbit.

• Para usar el Asistente de conexión de Jitterbit, en el menú principal, haga clic en Ayuda y luego en Comenzar. La pestaña Comenzar aparece en el panel derecho de la pantalla.

O

• Abra Jitterbit y haga clic en el Icono Jitterbit Connect en la parte superior de la pantalla.

• Aparece el menú del asistente Jitterbit Connect.

• Inicie el Asistente haciendo clic en el botón Base de datos a XML en la columna Estándar del menú del Asistente de Jitterbit Connect. Esto muestra la pantalla de selección de fuente de base de datos.

• Comience a crear su Proyecto con el asistente.

Crear Selección de Origen de Base de Datos¶

• Desde Fuentes de base de datos disponibles, seleccione Crear nuevo … o una Fuente de base de datos existente.

Para crear una Nueva fuente de base de datos, complete la información solicitada.

• • Ingrese un Nombre apropiado para su nueva fuente en el campo Nombre.

  • Elija Base de datos en el menú desplegable Tipo.

  • Seleccione el Controlador de base de datos apropiado haciendo clic en el botón Seleccionar junto al campo del controlador. Dependiendo del controlador que seleccione, diferentes campos pueden habilitarse o deshabilitarse.

  • Ingrese el Nombre del servidor de base de datos (ya sea nombre o dirección IP) al que desea acceder en el campo Nombre del servidor.

  • Ingrese el Nombre de la base de datos a la que desea acceder en el campo Nombre de la base de datos.

  • Ingrese un Nombre de usuario y una Contraseña válidos que permitirán el acceso a su base de datos en los campos de Inicio de sesión y Contraseña.

OPCIONAL:

• Si el servidor de la base de datos está escuchando en un puerto no predeterminado, puede anular la selección de Usar puerto predeterminado y especificar un Puerto personalizado. El puerto predeterminado varía según el controlador seleccionado.

• Seleccione el Nivel de aislamiento de transacciones en el menú desplegable. Las opciones son las de Transact-SQL estándar. No se admiten niveles de aislamiento de transacciones específicos del conductor. El valor predeterminado es utilizar el nivel de aislamiento de transacciones predeterminado del controlador o del servidor de base de datos.

• Si desea establecer un límite de tiempo de espera para una conexión exitosa a la base de datos, ingrese el Número de segundos en el campo de tiempo de espera.

• Si está utilizando un controlador JDBC, puede configurar la Propiedad de tamaño de recuperación. Esta propiedad le da al controlador una pista sobre la cantidad de filas que se deben recuperar de la base de datos cuando se necesitan más filas. Esta configuración se puede utilizar para un procesamiento más eficiente de grandes conjuntos de datos.

• Si hay parámetros adicionales que desea agregar a la cadena de conexión de su base de datos, ingrese Parámetros en el campo Parámetros de cadena de conexión adicionales.

• La casilla de verificación Construir cadena de conexión manualmente no está marcada de forma predeterminada. Si desea definirlo usted mismo, marque esta Casilla de verificación. Luego debe ingresar la Cadena de conexión en el campo de texto correspondiente. Para obtener más información, consulte Cadena de conexión manual.

  • Es posible que desees probar tus Conexiones antes de hacer clic en Siguiente. Al hacer clic en este botón se asegura 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. También puede comunicarse con la mesa de ayuda de Jitterbit.
  • Haga clic en el botón Siguiente para ir a Selección de tabla.

Crear Selección de Fuente de Tabla¶

• 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 en la ventana de búsqueda de filtro. Marque las casillas Tabla o Ver para limitar los objetos a seleccionar.

• Puede seleccionar la Casilla de verificación para incluir tablas del sistema en los nombres de las tablas descargadas.

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

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.

• Para eliminar tablas de la columna Tablas seleccionadas, resalte las Tablas que se copiarán en la columna Tablas seleccionadas y haga clic en la Flecha izquierda.

• Las selecciones luego regresan a la columna Tablas disponibles.

Después de completar tus tablas:

• Haga clic en el botón Siguiente para mostrar la pantalla Relaciones jerárquicas de origen, si las tablas seleccionadas tienen una relación jerárquica. De lo contrario, se mostrará la pantalla de opciones SQL Where Clause.

• Haga clic en el botón Cancelar para cerrar el asistente y regresar a la pestaña Introducción sin guardar sus entradas.

• Para volver a la pantalla anterior, haga clic en el botón Volver.

Crear Relaciones Jerárquicas¶

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

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

• 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 enlace, arrastre y suelte una Columna principal (OrderHeader en este ejemplo) a 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 Radio para identificar el tipo de unión. El valor predeterminado es Uno o Más. En este ejemplo, hemos dejado el valor predeterminado en Uno o Más.

• Haga clic en Aceptar para regresar a la pantalla Relaciones jerárquicas de origen, que muestra su árbol de tablas con las relaciones definidas actualmente O haga clic en Cancelar para regresar a la pantalla Relaciones jerárquicas de origen sin guardar sus entradas.

• Para volver a la pantalla anterior, haga clic en el botón Volver.

• Haga clic en el botón Siguiente para mostrar la pantalla opcional Cláusula Where de SQL.

• Haga clic en el botón Cancelar para cerrar el asistente y regresar a la pestaña "Comenzar" sin guardar sus entradas.

• Para volver a la pantalla anterior, haga clic en el botón Volver.

Crear Selección de Cláusula Where de SQL de Origen (opcional)¶

• Ingrese cualquier cláusula Where de SQL que desee para filtrar los datos de origen.

• Haga clic en el botón Siguiente para mostrar la pantalla de selección de clave principal opcional.

• Haga clic en el botón Cancelar para cerrar el asistente y regresar a la pestaña Introducción sin guardar sus entradas.

• Para volver a la pantalla anterior, haga clic en el botón Volver.

Crear Selección de Clave Principal de Origen (opcional)¶

• Seleccione una Clave principal haciendo clic en la Casilla de verificación en la columna Seleccionar a la izquierda del Nombre.

• La casilla de verificación Anulable está marcada de forma predeterminada. Déjelo seleccionado si desea que una columna contenga elementos de datos nulos.

• Haga clic en el botón Anular selección para eliminar sus selecciones. Luego podrá realizar nuevas selecciones.

• Haga clic en Aceptar para guardar sus selecciones y regresar a la pantalla Insertar/Actualizar, que ahora muestra sus selecciones.

• Haga clic en Cancelar para descartar sus selecciones y regresar a la pantalla Insertar/Actualizar.

Actualice la Selección del Campo de Datos de Origen (opcional y Se Muestra Solo Si la Transformación Es a un Destino Plano).¶

• Seleccione un Campo en los Datos de origen para actualizar cuando desee filtrar filas que ya se han transformado.

• Haga clic en el botón Siguiente para mostrar la pantalla de selección de Formato de archivo de destino.

• Haga clic en el botón Cancelar para cerrar el asistente y regresar a la pestaña Introducción sin guardar sus entradas.

• Para volver a la pantalla anterior, haga clic en el botón Volver.

Crear el Objetivo¶

• Esta pantalla le solicita que genere un XSD (un esquema XML) basado en la tabla Fuente.

• Haga clic en el botón No para rechazarlo.

• Haga clic en el botón Sí para generar un XSD. La pantalla se expande para mostrar un campo de nombre y un botón Generar XSD.

• Ingrese un Nombre de archivo XSD y haga clic en el botón Generar XSD. La pantalla se expande para mostrar el documento de esquema XML.

• Puede hacer clic en el botón Opciones para especificar opciones para el nombre raíz, el espacio de nombres de destino y la inclusión de valores predeterminados.

• Haga clic en el botón Siguiente para mostrar la pantalla Opciones de destino.

• Haga clic en el botón Cancelar para cerrar el asistente y regresar a la pestaña Introducción sin guardar sus entradas.

• Para volver a la pantalla anterior, haga clic en el botón Volver.

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

  Nota

  Si desea tener la opción de generar un atributo xsi:schemaLocation en el XML de destino, ingrese una Ubicación del esquema en el campo de texto. En este ejemplo, no seleccionamos esta opción.

• Haga clic en el botón Siguiente para mostrar la pantalla Seleccionar un destino de archivo.

• Haga clic en el botón Cancelar para cerrar el asistente y regresar a la pestaña Introducción sin guardar sus entradas.

• Para volver a la pantalla anterior, haga clic en el botón Volver.

En este ejemplo, el destino MyXML se creó previamente fuera de la operación del asistente y aparece aquí.

• Para seleccionar un destino de archivo existente, haga clic en el Despliegue desplegable y haga su selección.

• Para editar un destino de archivo existente, seleccione en el menú desplegable, que abrirá un cuadro de diálogo en el que podrá editar los parámetros del destino.

• Haga clic en el botón Crear nuevo y complete los Campos para crear un Nuevo destino de archivo.

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

Revisar el Resumen de la Operación¶

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 su proyecto, haga clic en el botón Volver para regresar a la pantalla anterior y realizar los cambios necesarios.

• Después de revisar su proyecto, haga clic en Finalizar para mostrar la pestaña Transformación. 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. El mensaje Asignaciones también se muestra encima de la pestaña.

• Si recibió este mensaje, haga clic en Cerrar. Antes de cerrar, también puede seleccionar la casilla No mostrarme otra vez.

• 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 junto al nombre de cada elemento asignado válidamente.

• Una línea roja indica un mapeo no válido.

• 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 Fuente 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 ver el resumen gráfico de la operación, haga doble clic en Operación Nombre en Jitterbit Connect/Base de datos a XML en el panel izquierdo.

Desplegar el Proyecto¶

• En la parte superior del panel izquierdo, haga clic derecho en Nombre del proyecto para resaltarlo y luego haga clic izquierdo en Desplegar en el menú desplegable resultante.

• Se mostrarán las opciones para desplegar el proyecto.

• Haga clic en el botón Desplegar para desplegar su proyecto.

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

• Para ejecutar este mensaje de progreso en segundo plano, haga clic en el botón Ejecutar en segundo plano.

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