Esquema de Archivo de Muestra¶

Introducción¶

Si ya tiene un archivo disponible que contiene la estructura de datos que desea usar, puede usar ese archivo de muestra para definir un esquema en una transformación. Una vez que se carga un archivo de muestra, se convierte en un esquema personalizado que puede editar en el editor de esquema para un esquema plano personalizado o esquema jerárquico personalizado.

Esta opción es similar a proporcionar el esquema durante la configuración de una actividad. Sin embargo, un esquema proporcionado durante la configuración de la actividad no se puede editar una vez cargado.

Utilice un Archivo de Muestra¶

Para poder definir un esquema usando un archivo de muestra en una transformación, primero crear una transformación.

La opción Definir esquema es visible solo cuando una transformación no hereda un esquema de una actividad adyacente o de una actividad inicialmente adyacente que desde entonces se ha eliminado. Los esquemas en dichas actividades tienen prioridad sobre un esquema definido en una transformación.

Siempre que se cumpla esta condición, el botón Definir esquema se muestra en modo de asignación en cada lado de la transformación que aún no tiene un esquema definido en una actividad. Haga clic en Definir esquema en el lado de origen o de destino de la transformación y seleccione Usar archivo de muestra:

Configurar un Esquema de Archivo de Muestra¶

Se abre el editor de esquema. En el editor de esquema, seleccione Usar esquema guardado o Proporcionar nuevo esquema. Cada una de estas opciones se trata a continuación.

Usar Esquema Guardado¶

Elija Usar esquema guardado para seleccionar un esquema existente que se haya definido previamente en el proyecto actual. Cuando se selecciona esta opción, estas opciones quedan disponibles:

• Esquemas guardados: Utilice el menú desplegable para seleccionar un esquema existente para reutilizarlo.

• Ver esquema: Después de seleccionar un esquema cargado existente, puede ver el esquema directamente dentro del área de texto debajo del menú desplegable. Para ver el esquema en un área más grande, haga clic en el ícono emergente (después de abrir esa área, haga clic en el icono de retorno 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 mostrar los esquemas cargados existentes y no muestra plano, jerárquico, o reflejado esquemas personalizados.

• Validación: La información de validación se proporciona debajo del área de texto y se basa en la extensión de 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 se puede utilizar, ya que no es posible realizar cambios en un esquema guardado desde el editor de esquema. 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 de esquema y cerrar el editor de esquema.

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

Proporcionar Nuevo Esquema¶

Elija Proporcionar nuevo esquema para definir un nuevo esquema cargando uno desde una URL, cargando un archivo o ingresando uno manualmente en el área de texto. Cuando se selecciona esta opción, estas opciones quedan disponibles:

• Nombre del esquema: Ingrese un nombre para el esquema en el cuadro de texto superior, incluida la extensión del archivo (.csv, .json, .xml, .xsd, o .zip). Si no se proporciona ninguna extensión de archivo, el contenido se analiza para detectar automáticamente el tipo de archivo que se utilizará para la validación. Si está cargando el esquema desde una URL o cargando un archivo, puede dejarlo en blanco, ya que el nombre se completará una vez que se cargue el archivo.

• Cargar URL: Haga clic para abrir un cuadro de diálogo donde puede cargar un esquema desde una URL:

  

  • Tipo de archivo: Utilice el menú desplegable para seleccionar entre los tipos de archivos admitidos, incluidos CSV, JSON, XML, XSD y CREMALLERA. Tomar nota:

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

    • ZIP: Un archivo ZIP puede contener una colección de XSD, que pueden importarse/incluirse entre sí por referencia. Se ignoran todos los archivos que no sean XSD en el archivo. Se admiten varios niveles de directorio.

  • URL: Ingrese una URL a la que se pueda acceder sin autenticación. Se pueden cargar archivos de hasta 5 MB de tamaño.

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

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

• Cargar archivo: Haga clic para abrir un cuadro de diálogo donde puede cargar un esquema desde un archivo al que se puede acceder desde la máquina actual:

  

  • Tipo de archivo: Utilice el menú desplegable para seleccionar entre los tipos de archivos admitidos, incluidos CSV, JSON, XML, XSD y CREMALLERA.

    Nota

    Un archivo ZIP puede contener una colección de XSD, que pueden importarse/incluirse entre sí por referencia. Se ignoran todos los archivos que no sean XSD en el archivo. Se admiten varios niveles de directorio.

  • Archivo: Utilice 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: Haga clic para cargar el esquema desde el archivo. Tenga en cuenta que algunos datos pueden convertirse durante el procesamiento como se describe en Procesamiento de esquemas.

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

• Ver/Editar esquema: Si no está cargando un esquema, puede 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, puede verlo o esquema directamente dentro de esa área de texto.

  Para ver o editar el esquema en un área más grande, haga clic en el ícono emergente (después de abrir esa área, haga clic en el icono 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 edita un esquema, la información de validación se proporciona debajo del área de texto, y los errores se informan una línea a la vez. Es decir, después de resolver un error en una línea, es posible que se informen errores de sintaxis adicionales para resolver en las líneas siguientes. La validación se basa en la extensión de 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 realizar ediciones en el área de texto de la izquierda, primero debe 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: Haga clic para guardar el esquema y actualizar la vista previa del esquema que se muestra en el lado derecho.

  Advertencia

  Si intenta cargar un archivo con el mismo nombre que un archivo existente ya definido en el proyecto, un cuadro de diálogo le preguntará si desea sobrescribir el archivo existente. Si hace 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 desea sobrescribir el archivo, haga clic en Cancelar y luego modifique manualmente el archivo para que tenga un nombre que no esté en uso y luego intente guardarlo nuevamente.

  

  Nota

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

  

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

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

  Nota

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

Menú de Acciones de Esquema¶

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

Estos incluyen Eliminar, Renombrar, Ver dependencias, Desplegar, Desplegar configurable y Agregar al grupo, así como Editar esquema y Borrar esquema. Para obtener detalles sobre estas acciones, consulte Menú de acciones de esquema.