Esquemas definidos en una actividad en Jitterbit Integration Studio

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 se definen 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 desde entonces ha sido eliminada) 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, dicho esquema pasa a formar parte de la transformación y se define directamente en transformación. Si la actividad eliminada proporcionaba un esquema de respuesta a una transformación, transformación dejaría de ser válida, ya que una transformación con un esquema de origen debe ir precedida de una actividad que proporcione un esquema de respuesta. Otras reglas y patrones para construir una operación válida se describen en Validez de la operación.

Definir un esquema en una actividad

Según el conector, la posibilidad 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 donde un usuario puede definir esquemas tienen una interfaz común, incluidos 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 definición de 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 omitir la necesidad de proporcionar un esquema. Puede que le interese seleccionar esta opción por varias razones:

  • 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 definido previamente en el proyecto actual. Al seleccionar esta opción, esta sección estará disponible:

  

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

  • Ver esquema: Después de seleccionar un esquema cargado, puede esquema directamente en el área de texto debajo del menú desplegable. Para verlo en un área más grande, haga clic en el esquema 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, subiendo un archivo o introduciéndolo manualmente en el área de texto. Al seleccionar esta opción, esta sección 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, se analiza el contenido para detectar automáticamente el tipo de archivo que se usará para la validación. Si carga el esquema desde una URL o un archivo, puede dejar este campo en blanco, ya que el nombre se completará una vez cargado el archivo.

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

    

    • Tipo de archivo: Use el menú desplegable para seleccionar entre los tipos de archivo compatibles, incluyendo CSV, JSON, XML, XSD y ZIP. 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. Cualquier archivo que no sea XSD en el archivo se ignora. Se admiten múltiples niveles de directorio.

    • URL: Ingrese una URL accesible sin autenticación. Se pueden subir archivos de hasta 5 MB.

    • Cargar: Haga clic para cargar el esquema desde la URL. Tenga en cuenta que el archivo solo se recupera 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 subir 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 nodo raíz deseado. Seleccione el elemento deseado y haga clic en Finalizar para subir el archivo:

      Texto de diálogo

      Seleccione la raíz que desea utilizar
      Existe más de una raíz posible en el archivo XSD seleccionado.

    • 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: Usa el menú desplegable para seleccionar entre los tipos de archivo compatibles, incluyendo CSV, JSON, XML, XSD y ZIP.

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

    • Archivo: Use el botón Explorar 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.

      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 reemplazará con el nuevo archivo con el mismo nombre en todas las ubicaciones donde se use en el proyecto. Si no desea sobrescribir el archivo, haga clic en Cancelar. Luego, modifique manualmente el archivo para que tenga un nombre único e intente cargarlo de nuevo.

      !!! quote "Texto de diálogo" ¿Sobrescribir archivo?
      Ya existe un archivo con el mismo nombre. ¿Seguro que desea sobrescribir el archivo anterior?

    • 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 subir un archivo XSD que contiene varios elementos de nivel superior, se le pedirá que seleccione el nodo raíz deseado. Seleccione el elemento deseado y haga clic en Finalizar para subir el archivo:

      Texto de diálogo

      Seleccione la raíz que desea utilizar
      Existe más de una raíz posible en el archivo XSD seleccionado.

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

  • Ver/Editar Esquema: Si no va a cargar un esquema, puede introducirlo manualmente en el área de texto debajo de los botones Cargar URL y Subir Archivo. De lo contrario, después de cargar un esquema, puede verlo o esquema directamente en 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: Al editar un esquema, se proporciona información de validación debajo del área de texto, y los errores se reportan línea por línea. Es decir, después de resolver un error en una línea, es posible que se reporten errores de sintaxis adicionales para las líneas posteriores. La validación se basa en la extensión del archivo del esquema proporcionado.

Menú de acciones del esquema

Una vez definido 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 más información sobre estas acciones, consulte el menú de acciones del esquema.