Esquemas Definidos en una Actividad¶

Introducción¶

Los esquemas utilizados en una transformación se heredan de las actividades del conector que inicialmente son adyacentes a una transformación (como se describe en esta página) o están definidos en una transformación (consulte Cómo se definen los esquemas en Uso del esquema). Los esquemas definidos en una actividad que son heredados por una transformación adyacente no se consideran parte de la transformación.

Un esquema definido en una actividad adyacente (o una actividad inicialmente adyacente que desde entonces se eliminó) tiene prioridad sobre un esquema definido en una transformación.

Si se hace referencia a una transformación que hereda un esquema de una actividad en otra operación y la actividad que proporciona el esquema no es adyacente en la operación actual, la transformación permanece sin cambios y continúa heredando el esquema de la actividad que ya no es adyacente (consulte Transformación Reutilizar).

Si se elimina una actividad que proporciona un esquema para una transformación, ese esquema pasa a formar parte de la transformación y se define directamente en la transformación. Si la actividad eliminada proporcionaba un esquema de respuesta a una transformación, esa transformación dejaría de ser válida, ya que una transformación con un esquema de origen debe estar precedida por una actividad que proporcione un esquema de respuesta. Otras reglas y patrones para construir una operación válida se tratan en Validez de la operación.

Definir un Esquema en una Actividad¶

Dependiendo del conector, la capacidad de un usuario de proporcionar un esquema puede incluirse como un paso de configuración de la actividad. La interfaz para definir esquemas se trata en cada documentación del conector.

Algunos conectores donde un usuario puede definir esquemas tienen una interfaz común, incluidos estos:

• API: Solicitud y Respuesta actividades
• Compartir archivo: Leer y escribe actividades
• FTP: Leer y escribe actividades
• HTTP: OBTENER, PONER, PUBLICAR, ELIMINAR y actividades personalizadas
• HTTP v2: OBTENER, PONER, CORREO, PARCHE, BORRAR, CABEZA, y OPCIONES actividades
• Almacenamiento local: Leer y escribe actividades
• Almacenamiento temporal: Leer y escribe actividades
• Variable: Leer y escribe actividades

A continuación se incluye un ejemplo de cómo definir un esquema en una actividad Leer de recurso compartido de archivos.

Durante la configuración de las actividades anteriores, seleccione una de las tres opciones en una sección llamada Proporcionar esquema de respuesta o Proporcionar esquema de solicitud:

• No: Elija esta opción para omitir proporcionar un esquema. Es posible que desee seleccionar esta opción por varios motivos:

  • Si el conector proporciona un esquema fijo cuando no se proporciona un esquema definido por el usuario.
  • Si define el esquema directamente en la transformación (consulte Esquemas definidos en una Transformación).
  • Si no se requiere ningún esquema para su caso de uso (consulte Uso del esquema).

• Sí, usar esquema guardado: Elija esta opción para seleccionar un esquema existente que se haya definido previamente en el proyecto actual. Cuando se selecciona esta opción, esta sección pasa a estar disponible:

  

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

• Sí, proporcionar un nuevo esquema: Elija esta opción 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, esta sección pasa a estar disponible:

  

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

      Nota

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

      

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

      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.

      Advertencia

      Si intenta cargar un archivo con el mismo nombre que un archivo existente ya definido en el proyecto, al hacer clic en Siguiente para avanzar al siguiente paso, un cuadro de diálogo le pregunta 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. Luego modifique manualmente el archivo para que tenga un nombre único y luego intente cargarlo nuevamente.

      

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

      Nota

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

      

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

Menú de Acciones de Esquema¶

Una vez definido un esquema en una actividad, 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.