Esquema jerárquico personalizado en Jitterbit Integration Studio

Introducción

Un esquema jerárquico (o esquema jerárquico) es una estructura de archivo compleja con múltiples tipos de filas de archivo, como filas de encabezado o de resumen. Esta página cubre la creación y edición de un esquema jerárquico personalizado dentro de una transformación.

Crear un esquema jerárquico

Los esquemas personalizados, incluidos los esquemas jerárquicos, se definen en las transformaciones. Para poder crear un esquema jerárquico, primero crea una transformación.

La opción Constructor de esquemas jerárquicos es visible solo cuando una transformación no está heredando ya un esquema de una actividad adyacente. Si hay una actividad adyacente que permite la configuración de esquemas definidos por el usuario, no proporciones un esquema de solicitud o respuesta en la configuración de la actividad, ya que esto causaría que esos esquemas sean heredados por la transformación.

Si se cumple esta condición, el botón Constructor de esquemas jerárquicos se muestra en cada lado de la transformación que no tiene ya un esquema definido en una actividad. Haz clic en Constructor de esquemas jerárquicos en el lado de origen o destino de la transformación:

Editar un esquema jerárquico

Para editar un esquema jerárquico que ha sido definido en una transformación, utiliza las acciones de esquema en una transformación para seleccionar Editar esquema:

Al abrir un esquema que es referenciado por múltiples componentes, se muestra un diálogo con una lista de los componentes que hacen referencia al esquema y que se verán afectados por cualquier cambio:

Configurar un esquema jerárquico

La configuración de un esquema utilizando el editor de esquemas jerárquicos se cubre de la siguiente manera:

• Nombre del esquema: Ingrese un nombre para identificar el esquema jerárquico.

• Estado de guardado: A la derecha del nombre del esquema se encuentran la fecha y la hora en que se guardó por última vez la transformación asociada al esquema. Esta información no está asociada al esquema en sí, que se guarda utilizando el botón Guardar cambios ubicado en la parte inferior de la configuración.

• Tipo: Seleccione entre los tipos disponibles para un esquema jerárquico personalizado:

  • XML: El esquema se creará en formato XML.
  • Ancho fijo: El esquema se creará en formato CSV utilizando la longitud para delimitar campos.
  • Delimitado por caracteres: El esquema se creará en formato CSV utilizando caracteres para delimitar campos.

  Note

  No se admite la creación de un esquema jerárquico en formato JSON.

• Opciones: Cuando se selecciona Delimitado por caracteres, estas opciones se vuelven disponibles:

  

  • Delimitador: Ingrese los caracteres que se utilizarán como delimitadores de campo que especifican el límite entre los campos de datos. El valor predeterminado es una coma. También puede usar delimitadores de múltiples caracteres, como un doble pipe ||. Para usar una tabulación como delimitador, ingrese \t.

  • Saltos de línea para el final de registros: Seleccione esta casilla para usar saltos de línea para separar registros. Esta opción está seleccionada por defecto. Cuando esta opción está seleccionada, el final de los registros se denota por saltos de línea, de modo que cada registro existe en una línea (a menos que se use un calificador). Cuando está deshabilitada, se ignoran los saltos de línea y los nuevos registros comienzan después de que se alcanza el número total de campos.

    Nota

    Esta opción es relevante solo para esquemas utilizados en el lado de origen de una transformación. Para esquemas utilizados en el lado de destino de una transformación, los saltos de línea siempre se utilizan para denotar el final de los registros.

  • Calificador de Cadena: Ingrese el carácter que se utilizará como envoltura, indicando una cadena de texto que debe tratarse como una única unidad de datos. El valor predeterminado es un carácter de comillas dobles. Si se deja vacío, no se utiliza ningún calificador de cadena.

    Al usar un Calificador de Cadena, seleccione Siempre o Cuando Sea Necesario para indicar cuándo debe usarse el calificador. Se recomienda el valor predeterminado, Cuando Sea Necesario, para que si los caracteres especificados como el Delimitador ocurren dentro de la cadena, entonces la cadena se envuelve con los caracteres del calificador de cadena especificado. Si el delimitador no ocurre, entonces la cadena no se envuelve.

    Durante el procesamiento de fuentes, el calificador de cadena se elimina. Durante el procesamiento de destinos, se agrega el calificador de cadena.

  • Convertir Secuencias de Escape: Seleccione esta casilla para convertir o ignorar las secuencias de escape según lo indicado por una barra invertida \. Por defecto, las secuencias de escape se convierten siguiendo los estándares de Java. Cuando está deshabilitado, la conversión de texto ocurre sin interpretación de las secuencias de escape.

    Nota

    Esta opción es relevante solo para esquemas utilizados en el lado de origen de una transformación.

  • EDIFACT: Seleccione esta casilla si los datos siguen las reglas de sintaxis del estándar EDIFACT.

• Agregar Nodo: Haga clic en el botón Agregar Nodo para agregar nuevos nodos uno a la vez a la tabla. Estas columnas están disponibles para cada fila de nodo:

  • #: A cada fila de nodo se le asigna automáticamente un número en el orden en que aparece la fila. Una vez que tenga al menos dos filas con el mismo padre en el árbol, pase el cursor sobre el número y haga clic en la flecha hacia arriba o hacia abajo. El nodo que sirve como nodo raíz (sin un padre) no se puede reordenar, ni se pueden reordenar nodos a un nivel diferente en la estructura del árbol (en su lugar, esto se puede hacer cambiando el padre del nodo).

  • Nodo: Ingresa un nombre para el nodo. El nombre del nodo no puede contener caracteres en blanco ni símbolos como estos: @ $ % & / + ( ) : ; ,. Además, el nombre del campo no puede comenzar con un número, un punto (.) o un guion (-).

    Consejo

    Para referencia sobre todos los caracteres no permitidos, consulta NCName según lo definido por W3C.

  • Padre: Usa el menú desplegable para seleccionar el padre del nodo. Ten en cuenta que no es posible seleccionar un nodo padre que cause una referencia circular.

  • Ocurrencia: Usa el menú desplegable para seleccionar cómo debe ocurrir el nodo en el documento complejo:

    • Cero o Más: Selecciona esta opción si este nodo puede o no ocurrir, pero si lo hace, puede ocurrir cualquier número de veces.
    • Cero o Uno: Selecciona esta opción si este nodo puede o no ocurrir, pero si lo hace, solo puede ocurrir una vez.
    • Uno o Más: Selecciona esta opción si este nodo debe ocurrir al menos una vez, pero también puede repetirse.
    • Exactamente Una Vez: Selecciona esta opción si este nodo debe ocurrir una vez y solo una vez en el documento.

  • Campos: Se lista el número de campos definidos para el nodo. Para definir los campos del nodo, haz clic en el ícono de edición a la derecha del número de campos. Esto abre un editor de campos para el nodo específico, como sigue.

    

    Nota

    Los nodos deben contener al menos un campo para poder mapear a ellos al completar un mapeo de transformación.

    

    • Ciclo de Nodo: Haz clic en las flechas izquierda o derecha para recorrer los nodos en el esquema jerárquico y mostrar la tabla de campos para el nodo seleccionado.

      • Atrás: Haz clic en el ícono de cerrar para regresar a la tabla de nodos.

        Navegador de Nodos: A lo largo de la parte superior de la tabla hay un botón gris expandido que te permite cambiar la visualización de la tabla navegando a otro nodo:

        

    • Agregar Campo: Haga clic para agregar nuevas filas de campo una a la vez a la tabla. Dependiendo del Tipo de esquema seleccionado, estas columnas están disponibles para cada fila de campo:

      • #: A cada fila de campo se le asigna automáticamente un número en el orden en que aparece la fila. Para reordenar filas, arrastre y suelte en otra posición dentro de la tabla, o pase el cursor sobre el número y haga clic en la flecha hacia arriba o hacia abajo .

      • Campo: Ingrese un nombre para el campo. El nombre del campo no puede contener caracteres en blanco ni símbolos como estos: @ $ % & / + ( ) : ; ,. Además, el nombre del campo no puede comenzar con un número, un punto (.) o un guion (-).

        Consejo

        Para referencia, consulte NCNameChar para los caracteres permitidos según lo definido por el W3C.

      • Tipo: Use el menú desplegable para seleccionar un tipo de dato. Las opciones para nuevos esquemas personalizados son boolean, date, decimal, double, float, integer, long y string. El valor predeterminado es string. Si se creó un esquema personalizado mediante la creación de un esquema espejo a partir de una actividad basada en servidor, pueden aparecer tipos de datos adicionales.

      • Inicio: Solo para esquemas de Ancho Fijo, ingrese la posición del carácter inicial. Tenga en cuenta que 1 se considera la posición para el comienzo del archivo.

        El valor predeterminado para las filas subsiguientes es el siguiente carácter después de la posición final del campo anterior. Por ejemplo, si la posición final del campo anterior es 50, entonces la posición inicial del siguiente campo será 51.

      • Longitud: Solo para esquemas de Ancho Fijo, ingrese el número de caracteres que se reservarán para este campo. Cuando ya se han ingresado la posición del carácter inicial y la posición del carácter final, este campo se calcula automáticamente.

        Los archivos de texto de longitud fija siempre especifican un cierto número de caracteres que se reservan para cada campo. Por ejemplo, puede identificar un campo llamado LastName que siempre tiene 30 caracteres reservados para él. Si el valor real es "Smith", solo se utilizan 5 caracteres; los caracteres restantes no contienen nada.

      • Fin: Para esquemas de Ancho Fijo únicamente, ingresa la posición del carácter final. Cuando la posición del carácter inicial y la longitud ya están ingresadas, este campo se calcula automáticamente.

        Nota

        Por defecto, los segmentos de longitud fija se terminan con un carácter de nueva línea.

      • Valor Predeterminado: Para esquemas de Ancho Fijo o Delimitado por Caracteres, si deseas que este campo tenga un valor predeterminado, ingresa el valor aquí.

      • Formato: Para esquemas de Ancho Fijo o Delimitado por Caracteres, si deseas que este campo tenga un formato específico, como para fecha o moneda, ingresa el formato aquí.

      • Acciones: Para las acciones que puedes realizar en una fila de campo existente, pasa el cursor sobre el campo en la parte derecha bajo el ícono del menú de acciones . Luego haz clic en el ícono de duplicar para duplicar la fila de campo, o haz clic en el ícono de eliminar para eliminar la fila de campo.

    • Revisar Esquema: A medida que defines manualmente cada campo dentro del esquema, se muestra una vista previa del esquema en el lado derecho. El esquema se muestra utilizando los elementos de interfaz estándar descritos en Nodos y campos.

    • Guardar Cambios: Haz clic para guardar y cerrar el esquema.

    • Descartar Cambios: Haz clic para cerrar el esquema sin guardar cambios.

  • Acciones: Para las acciones que puedes realizar en una fila de nodo existente, pasa el cursor sobre el campo en la columna de acciones . Luego haz clic en el ícono de duplicar para duplicar la fila de nodo, o haz clic en el ícono de eliminar para eliminar la fila de nodo.

• Revisar Esquema: A medida que defines manualmente cada nodo dentro del esquema, se muestra una vista previa del esquema en el lado derecho. El esquema se muestra utilizando los elementos de interfaz estándar descritos en Nodos y campos.

  Advertencia

  Si has creado nodos que no tienen ningún campo, entonces no puedes mapear a ningún campo dentro de estos nodos al completar un mapeo de transformación.

• Guardar cambios: Haz clic para guardar y cerrar el esquema.

• Descartar cambios: Haz clic para cerrar el esquema sin guardar los cambios.

Menú de acciones del esquema

Después de crear un esquema jerárquico personalizado, se pueden 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 más detalles sobre estas acciones, consulta Menú de acciones del esquema.