Esquemas Definidos en una Actividad¶

Introducción¶

Los esquemas utilizados en una transformación se heredan de actividades de conector que inicialmente son adyacentes a una transformación (como se describe en esta página) o están definidos en una transformación (vea 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 luego se ha eliminado) 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 Reutilización de la Transformación).

Si se elimina una actividad que proporciona un esquema a 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 se requiere que una transformación con un esquema de origen esté precedida por una actividad que proporcione un esquema de respuesta. En Validez de la operación se tratan otras reglas y patrones para construir una operación válida.

Definir un Esquema en una Actividad¶

Según el conector, la capacidad de que un usuario proporcione un esquema puede incluirse como un paso de configuración de la actividad. La interfaz para definir esquemas se describe en la documentación de cada conector.

Algunos conectores en los que un usuario puede definir esquemas tienen una interfaz común, entre los que se incluyen los siguientes:

• API: Solicitud y Respuesta actividades
• Compartir archivos: Leer y Escribir actividades
• FTP: Leer y Escribir actividades
• HTTP: GET, PUT, POST, DELETE y actividades personalizadas
• HTTP v2: OBTENER, PONER, CORREO, PARCHE, BORRAR, CABEZA, y OPCIONES actividades
• Almacenamiento local: Leer y Escribir actividades
• Almacenamiento temporal: Leer y Escribir actividades
• Variable: Leer y Escribir actividades

A continuación se incluye un ejemplo de cómo definir un esquema en una actividad de Lectura de uso 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 no tener que proporcionar un esquema. Puede 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 (vea Esquemas definidos en una transformación).
  • Si no se requiere 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 se vuelve disponible:

  

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

  • Ver esquema: Después de seleccionar un esquema cargado existente, puede verlo directamente dentro del área de esquema en un área más grande, haga clic en el botón icono emergente (después de abrir esa área, haga clic en el icono de retorno para volver a esta pantalla).
    

    Aunque un esquema guardado no se puede editar, 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 nuevo esquema: Elija esta opción para definir un nuevo esquema cargándolo desde una URL, cargando un archivo o ingresando uno manualmente en el área de texto. Cuando se selecciona esta opción, esta sección se vuelve 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, se analiza el contenido 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 dejar este campo 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. Tome 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 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 del esquema.

      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 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 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: Use el menú desplegable para seleccionar entre los tipos de archivos admitidos, incluidos CSV, JSON, XML, XSD y ZIP.

      !!! note "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 del archivo. Se admiten varios niveles de directorio.

    • Archivo: Use el botón Examinar a la derecha para buscar un archivo que aún no se haya usado 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 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 usa 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 del esquema.

      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, se proporciona información de validación debajo del área de texto y los errores se informan línea por línea. 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 posteriores. La validación se basa en la extensión de archivo del esquema proporcionado.

Menú de Acciones del Esquema¶

Después de definir un esquema en una actividad, puede acceder a opciones de menú adicionales que están disponibles para todos los esquemas.

Estas incluyen Eliminar, Cambiar nombre, Ver dependencias, Desplegar, Despliegue configurable y Agregar al grupo, así como Editar esquema y Borrar esquema. Para obtener detalles sobre estas acciones, consulte menú de acciones del esquema.