Esquema de archivo de muestra en Jitterbit Integration Studio

Introducción

Puedes crear un esquema a partir de un archivo existente que contenga la estructura de datos que deseas utilizar. Sube un archivo de muestra para definir un esquema en una transformación. Después de subir un archivo de muestra, se convierte en un esquema personalizado. Puedes editar este esquema en el editor de esquemas para un esquema plano personalizado o esquema jerárquico personalizado.

Esta opción funciona como proporcionar el esquema durante la configuración de una actividad. Sin embargo, no puedes editar un esquema que proporciones durante la configuración de la actividad después de subirlo.

Usar un archivo de muestra

Cuando usas un archivo de muestra, puedes proporcionar un nuevo esquema o usar un esquema guardado.

Para definir un esquema utilizando un archivo de muestra en una transformación, primero crea una transformación.

Proporcionar archivo de esquema

Puedes proporcionar un nuevo esquema desde la zona de carga. La zona de carga aparece solo cuando una transformación no hereda un esquema de una actividad adyacente o de una actividad adyacente inicialmente que fue eliminada. Los esquemas de estas actividades tienen prioridad sobre los esquemas definidos en una transformación.

Cuando se cumple esta condición, la zona de carga aparece en modo de mapeo en cada lado de la transformación que no tiene un esquema definido en una actividad:

Se abre un cuadro de diálogo de selección de archivos. Selecciona el archivo y luego haz clic en Subir:

El editor de esquemas se abre:

• Nombre del esquema: Ingresa un nombre para el esquema en el cuadro de texto superior. Incluye la extensión del archivo (.csv, .json, .xml, .xsd o .zip). Si no proporcionas una extensión de archivo, el sistema analiza el contenido para detectar el tipo de archivo para la validación. El nombre se completa automáticamente cuando se carga el archivo.

• Cargar URL: Haz clic para abrir un diálogo donde puedes cargar un esquema desde una URL:

  

  • Tipo de archivo: Usa el menú desplegable para seleccionar entre los tipos de archivo compatibles, incluyendo CSV, JSON, XML, XSD y ZIP. Toma nota:

    • XSD: Un XSD proporcionado por URL puede importar/incluir otras URLs de XSD por referencia.

    • ZIP: Un archivo ZIP puede contener una colección de XSDs, que pueden importar/incluirse entre sí por referencia. Cualquier archivo que no sea XSD en el archivo se ignora. Se admiten múltiples niveles de directorio.

  • URL: Ingresa una URL que sea accesible sin autenticación. Se pueden cargar archivos de hasta 5 MB de tamaño.

  • Cargar: Haz clic para cargar el esquema desde la URL. Ten en cuenta que el archivo se recupera solo una vez para la generación del esquema. Además, ten en cuenta que algunos datos pueden ser convertidos durante el procesamiento como se describe en Procesamiento de esquemas.

  • Cancelar: Haz clic para cerrar el diálogo de Cargar esquema URL sin guardar.

• Cargar archivo: Haz clic para abrir un diálogo donde puedes cargar un esquema desde un archivo que sea accesible desde la máquina actual:

  

  • Tipo de archivo: Usa el menú desplegable para seleccionar entre los tipos de archivo compatibles, incluyendo CSV, JSON, XML, XSD y ZIP.

    Nota

    Un archivo ZIP puede contener una colección de XSDs, que pueden importar/incluirse entre sí por referencia. Cualquier archivo que no sea XSD en el archivo se ignora. Se admiten múltiples niveles de directorio.

• Archivo: Utiliza el botón Examinar a la derecha para buscar un archivo que aún no se haya utilizado en el proyecto actual. Se pueden cargar archivos de hasta 5 MB de tamaño.

• Cargar: Haz clic para cargar el esquema desde el archivo. Ten en cuenta que algunos datos pueden ser convertidos durante el procesamiento, como se describe en Procesamiento de esquemas.

• Cancelar: Haz clic para cerrar el diálogo de Cargar archivo de esquema sin guardar.

• Ver/Editar Esquema: Si no estás cargando un esquema, puedes ingresar uno manualmente en el área de texto debajo de los botones Cargar URL y Cargar Archivo. De lo contrario, después de cargar un esquema, puedes ver o editar el esquema directamente en esa área de texto.

  Para ver o editar el esquema en un área más grande, haz clic en el ícono de expansión (después de abrir esa área, haz clic en el ícono de retorno para volver a esta pantalla).

  Esta área de texto también se puede copiar usando Control+C (Windows o Linux) o Command+C (macOS).

• Validación: A medida que editas un esquema, se proporciona información de validación debajo del área de texto, con cualquier error reportado línea por línea. Es decir, después de resolver un error en una línea, pueden reportarse errores de sintaxis adicionales para las líneas siguientes. La validación se basa en la extensión del archivo del esquema proporcionado.

• Vista Previa del Esquema: Se muestra una vista previa del esquema a la derecha. Después de cargar un nuevo esquema o hacer ediciones en el área de texto a la izquierda, primero debes hacer clic en el botón Guardar Cambios para que los cambios se reflejen en el área de vista previa. El esquema se muestra utilizando los elementos de interfaz estándar descritos en Nodos y campos.

• Guardar Cambios: Haz clic para guardar el esquema y actualizar la vista previa del esquema que se muestra en el lado derecho.

  Advertencia

  Si intentas cargar un archivo con el mismo nombre que un archivo existente ya definido en el proyecto, un diálogo (transcrito a continuación) pregunta si deseas sobrescribir el archivo existente. Si haces clic en Continuar, el archivo se reemplaza con el nuevo archivo con el mismo nombre en todos los lugares donde se utiliza en el proyecto. Si no deseas sobrescribir el archivo, haz clic en Cancelar y luego modifica manualmente el archivo para que tenga un nombre que no se esté utilizando, y luego intenta guardarlo nuevamente.

  Texto del diálogo

  ¿Sobrescribir archivo?
  Ya existe un archivo con el mismo nombre. ¿Está seguro de que desea sobrescribir el archivo antiguo?

  Nota

  Al cargar un archivo XSD que contiene múltiples elementos de nivel superior, al hacer clic en Guardar cambios, se le solicita seleccionar el nodo raíz deseado. Seleccione el elemento deseado y luego haga clic en Finalizar para guardar:

  Texto del diálogo

  Por favor seleccione la raíz a utilizar
  Existen más de una raíz posible en el archivo XSD seleccionado.

• Finalizar: Haga clic para guardar el esquema y cerrar el editor de esquemas.

• Cancelar: Haga clic para cerrar el editor de esquemas.

  Nota

  Si ya ha utilizado el botón Guardar cambios, los cambios ya se han guardado y usar Cancelar solo cierra la configuración. Usar Cancelar sin haber utilizado primero Guardar cambios cierra el editor de esquemas sin guardar.

Usar un esquema guardado

Puede acceder y seleccionar esquemas guardados utilizando la opción Esquemas guardados. Esta opción es visible solo cuando una transformación no está heredando ya un esquema de una actividad adyacente o de una actividad adyacente inicial que ha sido eliminada. Los esquemas en tales actividades tienen prioridad sobre un esquema definido en una transformación.

Siempre que se cumpla esta condición, la opción Esquema guardado se muestra en modo de mapeo en cada lado de la transformación que no tiene ya un esquema definido en una actividad:

Se abre el editor de esquemas:

• Esquemas guardados: Use el menú desplegable para seleccionar un esquema existente para reutilizar.

• Ver esquema: Después de seleccionar un esquema existente cargado, puede ver el esquema directamente en el área de texto debajo del menú desplegable. Para ver el esquema en un área más grande, haga clic en el ícono de expansión (después de abrir esa área, haga clic en el ícono de colapso para volver a esta pantalla).

  Aunque un esquema guardado no es editable, esta área de texto se puede copiar usando Control+C (Windows o Linux) o Command+C (macOS).

  Esta área de texto es solo para la visualización de esquemas subidos existentes y no muestra esquemas personalizados planos, jerárquicos o espejados.

• Validación: La información de validación se proporciona debajo del área de texto y se basa en la extensión del archivo del esquema guardado.

• Vista previa del esquema: Se muestra una vista previa del esquema a la derecha. El esquema se muestra utilizando los elementos de interfaz estándar descritos en Nodos y campos.

• Guardar cambios: Este botón no es utilizable, ya que no es posible realizar cambios en un esquema guardado desde el editor de esquemas. Para realizar cambios en un esquema guardado, utilice la opción Editar esquema disponible en el menú de acciones del esquema.

• Finalizar: Haga clic para guardar la selección del esquema y cerrar el editor de esquemas.

• Cancelar: Haga clic para cerrar el editor de esquemas.

Menú de acciones del esquema

Después de que se crea un esquema a partir del archivo de muestra, puede acceder a opciones de menú adicionales que están disponibles para todos los esquemas.

Estas incluyen Eliminar, Renombrar, Ver dependencias, Desplegar, Despliegue configurable y Agregar a grupo, así como Editar esquema y Limpiar esquema. Para obtener detalles sobre estas acciones, consulte Menú de acciones del esquema.